> 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/default-configuration.md).

# Default configuration

```yaml
# ╔══════════════════════════════════════════════════════════════╗
# ║                             TChat                            ║
# ║                      tect.host | by Alex                     ║
# ║                                                              ║
# ║                     chatplaceholders.yml                     ║
# ╚══════════════════════════════════════════════════════════════╝

# DON'T TOUCH THIS!
config-version: 0

# Maximum total tag replacements per message across ALL tags combined.
# 0 = unlimited.
max-replacements-per-message: 5

# Toggle built-in tags individually.
# Each has its own config file inside this folder.
built-in:
  item: true
```

```yaml
# ╔══════════════════════════════════════════════════════════════╗
# ║                             TChat                            ║
# ║                      tect.host | by Alex                     ║
# ║                                                              ║
# ║                        custom-tags.yml                       ║
# ╚══════════════════════════════════════════════════════════════╝

# DON'T TOUCH THIS!
config-version: 0

# Define custom tags here. When a player writes the trigger in chat:
#   1. The trigger is replaced in the message by "label" (seen by everyone).
#   2. "actions" are executed for the player who sent the message.

# Fields:
# - trigger -> string to detect in chat (case-insensitive, required)
# - permission -> leave empty to allow everyone (optional)
# - label -> MiniMessage text shown in the message (required)
# - actions -> executed for the player who wrote the message (optional)
#   - https://tchat.tect.host/general/actions

# Examples:
#
# tags:
#   - trigger: "[discord]"
#     permission: ""
#     label: "<click:open_url:'https://discord.gg/yourserver'><hover:show_text:'<gray>Click to join!'>[<#5865F2>Discord</#5865F2>]</hover></click>"
#     actions:
#       - "[MESSAGE] <gray>Discord invite: <aqua>https://discord.gg/yourserver"

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

```yaml
# ╔══════════════════════════════════════════════════════════════╗
# ║                             TChat                            ║
# ║                      tect.host | by Alex                     ║
# ║                                                              ║
# ║                          itemtag.yml                         ║
# ╚══════════════════════════════════════════════════════════════╝

# DON'T TOUCH THIS!
config-version: 0

# Trigger string matched case-insensitively in chat messages.
trigger: "[item]"

# Permission required to use this tag. Leave empty for everyone.
permission: ""

# Label shown in chat
# Placeholders: <item_name>, <item_count>
# Hover is always the native item tooltip (name, lore, enchantments, etc.)
format: "<aqua><item_name></aqua>"

# What to show when the player holds nothing.
empty-hand:
  enabled: true
  format: "[<gray>Air</gray>]"
```