> For the complete documentation index, see [llms.txt](https://tchat.tect.host/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tchat.tect.host/chat-placeholders/configuration.md).

# Configuration

## General

```yaml
modules:
  # Allows players to display custom tags in chat
  #
  # Item tag module loaded from modules/chatplaceholders/chatplaceholders.yml
  chat-placeholders: true
```

* modules.chat-placeholders: Enable/disable the module.

***

## Module

<sub>chatplaceholders.yml</sub>

#### Max replacements per message

This is the maximum number of tags a message can have.

#### Built in

These are the tags that TChat has by default.

### \[ITEM] tag

<sub>itemtag.yml</sub>

#### Trigger

This is the text it will detect in the chat to replace it with the item in your hand.

#### Permission

Permission to use this tag, if it is empty, no permissions are required.

#### Format

This is the format of the text replaced from the trigger

#### Empty hand

Here you can customize the format if the player has nothing in their hand.

### Custom tags

Here you can create your own tags using [TChat actions](/general/actions.md).

```yaml
tags:
  - trigger: "[pos]"
    permission: ""
    label: "[<green>%player_x% %player_y% %player_z%</green>]"
    actions: []
```

* trigger: Same as in itemtag -> This is the text it will detect in the chat to replace it with the item in your hand.
* permission: The permission to use this tag (empty = available for everyone)
* label: The text that replaces the trigger.
* actions: [Actions](/general/actions.md) taken when the trigger is detected in the message.