> For the complete documentation index, see [llms.txt](https://docs.cozycrafters.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cozycrafters.net/plugin-docs/cozychat/permissions.md).

# Permissions

<table><thead><tr><th>Permission</th><th width="68.94140625">Default</th><th>Description</th></tr></thead><tbody><tr><td><code>cozychat.*</code></td><td>op</td><td>Grants all CozyChat staff and admin permissions listed as children in <code>plugin.yml</code>.</td></tr><tr><td><code>cozychat.admin</code></td><td>op</td><td>Allows <code>/cozychat reload</code>.</td></tr><tr><td><code>cozychat.staff</code></td><td>op</td><td>Allows staff chat and receives staff filter notifications when configured.</td></tr><tr><td><code>cozychat.announce</code></td><td>op</td><td>Allows <code>/announce</code>.</td></tr><tr><td><code>cozychat.broadcast</code></td><td>op</td><td>Allows <code>/broadcast</code>.</td></tr><tr><td><code>cozychat.clickbroadcast</code></td><td>op</td><td>Allows configured clickable broadcasts through <code>/cozychat broadcast</code>, <code>/cozychat clickbroadcast</code>, and <code>/cozychat clickablebroadcast</code>.</td></tr><tr><td><code>cozychat.broadcasts.toggle</code></td><td>true</td><td>Allows <code>/broadcasts</code> to mute or unmute autobroadcasts for self.</td></tr><tr><td><code>cozychat.clearchat</code></td><td>op</td><td>Allows <code>/clearchat</code>.</td></tr><tr><td><code>cozychat.clearchat.bypass</code></td><td>op</td><td>Keeps a player's chat history when <code>/clearchat</code> runs.</td></tr><tr><td><code>cozychat.poll</code></td><td>op</td><td>Allows starting, ending, and viewing polls.</td></tr><tr><td><code>cozychat.testreward</code></td><td>op</td><td>Allows <code>/cozychat testreward</code>.</td></tr><tr><td><code>cozychat.greetstats</code></td><td>true</td><td>Allows <code>/cozychat greetstats</code>.</td></tr><tr><td><code>cozychat.greetboard</code></td><td>true</td><td>Allows <code>/cozychat greetboard</code>.</td></tr><tr><td><code>cozychat.chatcolor</code></td><td>op</td><td>Allows inline <code>&#x26;</code> color codes in normal chat messages.</td></tr><tr><td><code>cozychat.joinmessage</code></td><td>true</td><td>Allows <code>/joinmessage</code>.</td></tr><tr><td><code>cozychat.joinmessage.color</code></td><td>true</td><td>Allows legacy <code>&#x26;</code> color codes in custom join messages.</td></tr><tr><td><code>cozychat.joinmessage.hex</code></td><td>op</td><td>Allows hex color codes in custom join messages.</td></tr><tr><td><code>cozychat.msg</code></td><td>true</td><td>Allows <code>/msg</code> and <code>/r</code> private messaging.</td></tr><tr><td><code>cozychat.togglepm</code></td><td>true</td><td>Allows <code>/togglepm</code>.</td></tr><tr><td><code>cozychat.command.togglechat</code></td><td>true</td><td>Allows <code>/togglechat</code>.</td></tr><tr><td><code>cozychat.command.togglefilter</code></td><td>true</td><td>Allows <code>/togglefilter</code>, <code>/chatfilter</code>, and <code>/swearfilter</code>.</td></tr><tr><td><code>cozychat.swearfilter.bypass</code></td><td>op</td><td>Bypasses the swear filter on normal Minecraft player chat.</td></tr><tr><td><code>cozychat.socialspy</code></td><td>op</td><td>Allows <code>/socialspy</code> for CozyChat private messages.</td></tr><tr><td><code>cozychat.bug</code></td><td>true</td><td>Allows <code>/bug</code>.</td></tr><tr><td><code>cozychat.bug.bypass-cooldown</code></td><td>op</td><td>Bypasses the <code>/bug</code> cooldown.</td></tr><tr><td><code>cozychat.commandaudit</code></td><td>op</td><td>Allows <code>/commandaudit</code>.</td></tr><tr><td><code>cozychat.tags.use</code></td><td>true</td><td>Allows opening <code>/tags</code> and equipping owned tags.</td></tr><tr><td><code>cozychat.tags.admin</code></td><td>op</td><td>Allows <code>/tags give</code>, <code>/tags remove</code>, and <code>/tags clear</code>.</td></tr><tr><td><code>cozychat.tags.reload</code></td><td>op</td><td>Allows <code>/tags reload</code>.</td></tr><tr><td><code>cozychat.tags.bypasscost</code></td><td>op</td><td>Allows purchasing tags without paying the configured Vault or PlayerPoints price.</td></tr><tr><td><code>cozychat.admin.menu</code></td><td>op</td><td>Allows opening <code>/chatadmin</code> by default. The command can use a different permission if <code>admin-menu.permission</code> is changed.</td></tr><tr><td><code>cozychat.admin.mute</code></td><td>op</td><td>Allows the configured mute action in <code>/chatadmin</code>.</td></tr><tr><td><code>cozychat.admin.kick</code></td><td>op</td><td>Allows the configured kick action in <code>/chatadmin</code>.</td></tr><tr><td><code>cozychat.admin.ban</code></td><td>op</td><td>Allows the configured ban action in <code>/chatadmin</code>.</td></tr><tr><td><code>cozychat.admin.punish.bypass</code></td><td>false</td><td>Protects a player from <code>/chatadmin</code> punishments unless the actor has override permission.</td></tr><tr><td><code>cozychat.admin.punish.override</code></td><td>op</td><td>Allows punishing players who have <code>cozychat.admin.punish.bypass</code>.</td></tr><tr><td><code>cozychat.glyphs</code></td><td>op</td><td>Allows browsing and auditing cached Oraxen glyphs with <code>/glyphs</code>.</td></tr><tr><td><code>cozychat.glyphs.reload</code></td><td>op</td><td>Allows <code>/glyphs reload</code>.</td></tr><tr><td><code>cozychat.emojis</code></td><td>true</td><td>Allows <code>/emojis</code> and <code>/emoji</code>.</td></tr><tr><td><code>cozychat.emojis.admin</code></td><td>op</td><td>Shows all emojis in <code>/emojis</code>, including emojis gated by Oraxen chat permissions.</td></tr><tr><td><code>cozychat.admin.regionmessages</code></td><td>op</td><td>Allows <code>/cozychat regionmessages</code> management commands.</td></tr><tr><td><code>cozychat.regionmessages.bypass</code></td><td>op</td><td>Bypasses all Region Messages.</td></tr><tr><td><code>cozychat.regionmessages.bypass.spawn_welcome</code></td><td>false</td><td>Bypasses the bundled <code>spawn_welcome</code> Region Message.</td></tr><tr><td><code>cozychat.regionmessages.bypass.market_intro</code></td><td>false</td><td>Bypasses the bundled <code>market_intro</code> Region Message.</td></tr><tr><td><code>cozychat.regionmessages.bypass.&#x3C;messageId></code></td><td>Not documented in <code>plugin.yml</code></td><td>Source checks this pattern for each Region Message ID before sending that message.</td></tr><tr><td>Tag-specific permissions from <code>tags.yml</code></td><td>Not documented in <code>plugin.yml</code></td><td>Individual tag entries can define a <code>permission</code>. The bundled tags have this value blank.</td></tr><tr><td>Oraxen emoji <code>chat.permission</code> values</td><td>Not documented in <code>plugin.yml</code></td><td><code>/emojis</code> only shows emojis the sender can use unless they have <code>cozychat.emojis.admin</code>. Exact nodes come from Oraxen glyph files.</td></tr></tbody></table>

### Recommended Setup

Players:

* `cozychat.broadcasts.toggle`
* `cozychat.greetstats`
* `cozychat.greetboard`
* `cozychat.joinmessage`
* `cozychat.joinmessage.color`
* `cozychat.msg`
* `cozychat.togglepm`
* `cozychat.command.togglechat`
* `cozychat.command.togglefilter`
* `cozychat.bug`
* `cozychat.tags.use`
* `cozychat.emojis`

Staff:

* `cozychat.staff`
* `cozychat.socialspy`
* `cozychat.broadcast`
* `cozychat.announce`
* `cozychat.poll`
* `cozychat.clearchat`
* `cozychat.clearchat.bypass`
* `cozychat.commandaudit`

Admins:

* `cozychat.admin`
* `cozychat.testreward`
* `cozychat.clickbroadcast`
* `cozychat.tags.admin`
* `cozychat.tags.reload`
* `cozychat.tags.bypasscost`
* `cozychat.admin.menu`
* `cozychat.admin.mute`
* `cozychat.admin.kick`
* `cozychat.admin.ban`
* `cozychat.admin.punish.override`
* `cozychat.glyphs`
* `cozychat.glyphs.reload`
* `cozychat.emojis.admin`
* `cozychat.admin.regionmessages`
* `cozychat.regionmessages.bypass`


---

# 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:

```
GET https://docs.cozycrafters.net/plugin-docs/cozychat/permissions.md?ask=<question>
```

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.