# Placeholders ## PlaceholderAPI PlaceholderAPI placeholders that can be used both in ChatChat but also in any other plugin that supports PlaceholderAPI placeholders.

Placeholder	Description
`%chatchat_channel_name%`	Get the name of the channel that the user is currently in.
`%chatchat_channel_prefix%`	Get the prefix of the channel that the user is currently in.
`%chatchat_channel_message_prefix%`	Get the message prefix of the channel that the user is currently in.
`%chatchat_social_spy_enabled%`	Get whether or not this user has social spy enabled.
`%chatchat_private_messages_enabled%`	Get whether or not this user has private messages enabled.
`%chatchat_private_messages_recipient%`	Get the player that this user has last had a private conversation with. (This user expires after 5 minutes by default but can be configured in `settings.yml`)

## Internal Placeholders that can be used inside ChatChat itself but nowhere else. ChatChat has a few internal placeholders, or more so tags that give users more freedom to customise their chats. These are tags you can only use in ChatChat, and sometimes only in some parts of ChatChat. ### \ This tag let's your parse PlaceholderAPI placeholders for the recipient of a message. This tag will work with both: private messages and public messages. **Example of usage: ``.** This would parse the `%player_name%` placeholder for the recipient of the message. {% hint style="warning" %} A thing to note is that you don't use the percent sign (%) for the PAPI placeholders inside this tag. {% endhint %} ### \ This tag let's you parse PlaceholderAPI placeholders for the sender of a message. This tag will work with both: private messages and public messages. Since ChatChat already supports PlaceholderAPI placeholders using the normal format (%placeholder\_name%), this tag does have some special features: * ChatChat doesn't support the legacy formatting anymore but most placeholders still return strings using those formats. This tag will translate those legacy colors to the new ones for you. * Because of how legacy formatting works, it will bleed into the message but this tag gives you the ability to stop this. You can add a special argument that will determin if the formatting bleeds into the message or not. The argument is either `inserting` -it will bleed into the rest of the message- or `closing` -it will not bleed into the rest of the message-. Example of usage: ``, `` and ``. All of these will show the sender's display name but with the colors translated to MiniMessage. The first 2 tags will make the formatting of the display name not bleed into the message, while the last one will let it bleed. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://wiki.helpch.at/helpchat-plugins/chatchat/placeholders.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.