> 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.md).

# CozyChat

### What It Does

CozyChat provides server chat tools for player messages, staff communication, announcements, tags, join messages, welcome-back greetings, bug reports, and region-based messages.

It is used to manage the main chat experience on the server without giving players access to administrative chat controls.

### Main Features

<table><thead><tr><th width="249.62109375">Feature</th><th>What It Does</th></tr></thead><tbody><tr><td>Public chat formatting</td><td>Formats normal player chat and supports inline color codes for players with permission.</td></tr><tr><td>Staff chat</td><td>Gives staff a private staff-only chat channel.</td></tr><tr><td>Private messages</td><td>Adds player-to-player messages, replies, private-message toggles, and staff Social Spy.</td></tr><tr><td>Announcements and broadcasts</td><td>Sends manual announcements, quick broadcasts, clickable broadcasts, and automatic broadcasts.</td></tr><tr><td>Chat visibility controls</td><td>Lets players hide normal public chat for themselves.</td></tr><tr><td>Swear filter</td><td>Censors normal player chat using <code>swear-filter.yml</code>, with a sender bypass permission and an optional viewer-side toggle.</td></tr><tr><td>Custom join messages</td><td>Lets players set, preview, and reset their join message suffix.</td></tr><tr><td>Welcome-back greetings</td><td>Tracks greetings for returning players and can deliver configured reward bundles.</td></tr><tr><td>Polls</td><td>Lets staff start two-option clickable polls, view results, and end active polls.</td></tr><tr><td>Bug reports</td><td>Lets players submit bug reports that are logged locally and can optionally be sent to a Discord webhook.</td></tr><tr><td>Tags</td><td>Lets players browse, purchase, equip, and clear chat tags through <code>/tags</code>.</td></tr><tr><td>Glyphs and emojis</td><td>Provides an admin glyph browser and a player-facing emoji browser based on Oraxen glyph files.</td></tr><tr><td>Region Messages</td><td>Sends configured messages when players enter WorldGuard regions.</td></tr><tr><td>Chat admin menu</td><td>Opens a staff punishment menu with configured mute, kick, and ban actions.</td></tr><tr><td>Command audit</td><td>Writes an audit file showing the root commands visible to an online player.</td></tr></tbody></table>

### Basic Admin Workflow

1. Install CozyChat and any optional plugins you plan to use.
2. Start the server so CozyChat creates its default files.
3. Review `config.yml`, `swear-filter.yml`, `tags/tag_settings.yml`, `tags/tags.yml`, and `region_messages.yml`.
4. Assign player permissions for normal player features such as private messages, tags, join messages, emojis, broadcasts toggle, and bug reports.
5. Assign staff permissions for staff chat, Social Spy, announcements, broadcasts, polls, clear chat, glyph tools, Region Messages, and the chat admin menu.
6. Use `/cozychat reload` after editing CozyChat configuration files.
7. Use `/tags reload` after editing tag files.
8. Use `/cozychat regionmessages reload` after editing Region Messages.
9. Use `/glyphs reload` after updating Oraxen glyph files.

### Notes

* CozyChat declares these soft dependencies in `plugin.yml`: Vault, PlaceholderAPI, PlayerPoints, CozyCosmetics, SuperVanish, PremiumVanish, DiscordSRV, and WorldGuard.
* Vault and an economy provider are needed for money rewards and money-priced tags.
* PlayerPoints is optional. Tags with `points-price` are unavailable when PlayerPoints is not installed or available.
* PlaceholderAPI is optional and is used for placeholders, including the CozyChat expansion and formatting integrations.
* CozyCosmetics is optional. Source docs state CozyChat reads CozyCosmetics placeholders for player-facing name, nickname, and message color formatting.
* WorldGuard is optional, but Region Messages require it. If WorldGuard is missing, only Region Messages are disabled.
* DiscordSRV is optional. When installed, CozyChat can censor normal chat bridged between Minecraft and Discord through the swear filter.
* Oraxen is not declared as a hard dependency. `/glyphs` and `/emojis` read Oraxen glyph files from `plugins/Oraxen/glyphs/`.
* `/togglefilter` is viewer-side only. It does not let a player send uncensored chat to others.
* `/togglechat` hides normal public chat for the player and stops that player from sending normal public chat while it is disabled. Other plugin and system messages are not hidden.
* CozyChat does not register `/chatcolor` or `/namecolor` commands in the confirmed source.

### Common Use Cases

<table><thead><tr><th width="315.24609375">Use Case</th><th>Command or Area</th></tr></thead><tbody><tr><td>Reload CozyChat after config edits</td><td><code>/cozychat reload</code></td></tr><tr><td>Let players customize join messages</td><td><code>/joinmessage</code></td></tr><tr><td>Let players use chat tags</td><td><code>/tags</code></td></tr><tr><td>Let players report issues</td><td><code>/bug</code></td></tr><tr><td>Let staff talk privately</td><td><code>/staffchat</code></td></tr><tr><td>Let staff monitor private messages</td><td><code>/socialspy</code></td></tr><tr><td>Send server announcements</td><td><code>/announce</code> or <code>/broadcast</code></td></tr><tr><td>Run a quick poll</td><td><code>/poll</code></td></tr><tr><td>Manage Region Messages</td><td><code>/cozychat regionmessages</code></td></tr><tr><td>Reload tag files</td><td><code>/tags reload</code></td></tr><tr><td>Browse Oraxen glyphs</td><td><code>/glyphs</code></td></tr><tr><td>Browse public emojis</td><td><code>/emojis</code></td></tr></tbody></table>


---

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