> For the complete documentation index, see [llms.txt](https://plugins-1.gitbook.io/plugins/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://plugins-1.gitbook.io/plugins/plugin/chat.md).

# Chat

## Requirements

* Optional: PlaceholderAPI

## Features

* **Configurable:** Completely modify all player messages to be unique to your server.
* **Dynamic:** There's no limit on how many formats you can create with this plugin.
* **Unique:** This takes a completely new approach to player chatting.
* **Channels**: Easily create private "groups" which only certain roles can view and send messages from.
* **BungeeCord**: Create global chat across your network or limit it to certain channels (such as staff only).
* **Private Messaging**: Fully customise your private and public chat with hoverable 'tooltips' that show information on hover, with BungeeCord support.
* **Placeholders:** Show off which channel or format you're currently in / using with PAPI placeholders.
* **Shortcuts**: Easily bind "prefixes" in chat that quickly send to a certain channel e.g. "!" to staff only.

## Installation

1. Download the plugin.
2. Move the jar to your `plugins` folder.
3. Start your server (or reboot if already running).
4. Use `/chat` to verify the plugin is running.

## Commands

| Command                         | Description                    | Permission       | Default |
| ------------------------------- | ------------------------------ | ---------------- | ------- |
| /chat                           | View plugin information.       | -                | -       |
| /chat reload                    | Reload the plugin.             | cifychat.reload  | false   |
| /chat help                      | View commands and permissions. | cifychat.help    | false   |
| /chat test \<format> \<message> | Test a format in chat.         | cifychat.test    | false   |
| /cifychat formats               | List formats.                  | cifychat.formats | false   |
| /msg \<player> \<message>       | Private message a player.      | cifychat.msg     | false   |
| /channel \<id>                  | Switch between channels.       | cifychat.msg     | false   |

**Note**, players require the permission **cifychat.canchat** to be able to chat - this is given by default, but implemented for hub servers where only certain ranks can chat.