> For the complete documentation index, see [llms.txt](https://wiki.helpch.at/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.helpch.at/helpchat-plugins/chatchat/permissions.md). # Permissions ChatChat permissions and their default access. All ChatChat permissions default to operators. This includes channel, format, and custom-placeholder permissions, whose exact names depend on your configuration. Grant individual nodes to non-operators with your permissions plugin as needed. ## Commands and player controls | Permission | Default | Grants | | ------------------------ | -------- | ------------------------------------------------------------------------ | | `chatchat.admin` | Operator | `/chatchat reload`. | | `chatchat.dump` | Operator | `/chatdump`. | | `chatchat.test.format` | Operator | `/chatchat test`. | | `chatchat.togglechat` | Operator | `/togglechat`. | | `chatchat.rangedchat` | Operator | `/rangedchat`. | | `chatchat.pm` | Operator | Send and reply to private messages. | | `chatchat.pm.toggle` | Operator | `/togglemsg`. | | `chatchat.socialspy` | Operator | `/socialspy`. | | `chatchat.ignore` | Operator | `/ignore` and `/unignore`. | | `chatchat.ignorelist` | Operator | `/ignorelist`. | | `chatchat.ignore.bypass` | Operator | Bypass a recipient's ignore list when sending chat or a private message. | | `chatchat.separate` | Operator | `/separate`. | | `chatchat.unseparate` | Operator | `/unseparate`. | ## Channels and formats | Permission | Default | Grants | | ------------------------------------------------------ | -------- | --------------------------------------------------------------------------------------------------- | | `chatchat.channel.use.` | Operator | Send messages in the named channel and switch to it. | | `chatchat.channel.see.` | Operator | Receive messages from the named channel. | | `chatchat.channel.bypass-radius` | Operator | Receive radius-limited messages from any distance unless you enable ranged chat with `/rangedchat`. | | `chatchat.format.` | Operator | Use the named global format from `formats.yml`. | | `chatchat.channel.format..` | Operator | Use the named format configured for that channel. | The configured default channel is available without channel-use or channel-see permissions. See [Channels](/helpchat-plugins/chatchat/channels.md) and [Formats](/helpchat-plugins/chatchat/formats.md). ## Mentions | Permission | Default | Grants | | ------------------------------------------ | -------- | ------------------------------------------------------------------------ | | `chatchat.mention.personal` | Operator | Mention an online player by name. | | `chatchat.mention.everyone` | Operator | Use `@here`, `@everyone`, or `@channel` mentions in the current channel. | | `chatchat.mention.personal.block` | Operator | Use `/togglemention personal` to opt out of personal mentions. | | `chatchat.mention.everyone.block` | Operator | Use `/togglemention channel` to opt out of channel mentions. | | `chatchat.mention.personal.block.override` | Operator | Mention players who opted out of personal mentions. | | `chatchat.mention.everyone.block.override` | Operator | Include players who opted out of channel mentions. | The permission node uses `everyone` for channel-wide mentions, even though the toggle command calls them `channel` mentions. See [Mentions](/helpchat-plugins/chatchat/mentions.md). ## Message formatting and links | Permission | Default | Grants | | ------------------------------------ | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `chatchat.utf` | Operator | Use otherwise restricted Unicode characters in public and private messages when the corresponding DeluxeChat Unicode rule is enabled. The character ΓΈ (code point 248) is allowed without this permission. | | `chatchat.url` | Operator | Automatically turn URLs in chat messages into clickable links. | | `chatchat.tag.item` | Operator | Use the `` tag in chat messages. | | `chatchat.tag.click` | Operator | Use MiniMessage click tags. | | `chatchat.tag.color` | Operator | Use color tags. | | `chatchat.tag.font` | Operator | Use font tags. | | `chatchat.tag.gradient` | Operator | Use gradient tags. | | `chatchat.tag.hover` | Operator | Use hover tags. | | `chatchat.tag.insertion` | Operator | Use insertion tags. | | `chatchat.tag.keybind` | Operator | Use keybind tags. | | `chatchat.tag.newline` | Operator | Use newline tags. | | `chatchat.tag.rainbow` | Operator | Use rainbow tags. | | `chatchat.tag.reset` | Operator | Use reset tags. | | `chatchat.tag.translatable` | Operator | Use translatable tags. | | `chatchat.tag.translatable-fallback` | Operator | Use the translatable fallback tag ``. | | `chatchat.tag.head` | Operator | Use the `` tag. | | `chatchat.tag.shadow` | Operator | Use the `` tag. | | `chatchat.tag.transition` | Operator | Use the `` tag. | | `chatchat.tag.pride` | Operator | Use the `` tag. | | `chatchat.tag.selector` | Operator | Use the `` tag. | | `chatchat.tag.score` | Operator | Use the `` tag. | | `chatchat.tag.nbt` | Operator | Use the `` tag. | | `chatchat.tag.sprite` | Operator | Use the `` tag. | | `chatchat.tag.obfuscated` | Operator | Use obfuscated text. | | `chatchat.tag.bold` | Operator | Use bold text. | | `chatchat.tag.strikethrough` | Operator | Use strikethrough text. | | `chatchat.tag.underlined` | Operator | Use underlined text. | | `chatchat.tag.italic` | Operator | Use italic text. | | `chatchat.tag.placeholder.` | Operator | Use the configured MiniMessage placeholder named `` in your own messages. | See [MiniMessage tags in chat](/helpchat-plugins/chatchat/tags.md) for examples and [Placeholders](/helpchat-plugins/chatchat/placeholders.md) for configured placeholders. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## 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, and the optional `goal` query parameter: ``` GET https://wiki.helpch.at/helpchat-plugins/chatchat/permissions.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.