CustomChat

# CustomChat > 📢 A modern Minecraft chat plugin for Paper servers with full PlaceholderAPI support and rich message customization. CustomChat is a highly customizable chat formatting plugin for Paper Minecraft servers. It allows you to create different chat formats based on permissions, with support for colors, hover messages, click actions, and (https://www.spigotmc.org/resources/placeholderapi.6245/) integration. Designed for performance and flexibility, CustomChat supports both legacy and modern chat events depending on your server version. --- ## ✅ Features - 🧩 Format chat messages using **MiniMessage** or **legacy color codes (&)** - 🔐 Multiple chat formats with **permission-based priority** - 🖱️ Support for **hover tooltips** and **click actions** (suggest command, open URL, etc.) - 🎨 Configurable message colors and formatting - 🛡️ Optionally blocks the `&k` obfuscated text code - 📦 Integration with **PlaceholderAPI** for dynamic player info - ⚙️ Simple `/customchat reload` command to reload config without restart --- ## 📦 Commands | Command | Description | Permission | |-----------------------------|------------------------------------------------------------|----------------------------| | `/customchat reload` | Reloads the config file | `customchat.admin` | | `/chatcolor` | Opens the chatcolor menu | `customchat.chatcolor` | | `/customchat mentiontoggle` | In case mentioning is enable, toggle per player | `customchat.mentiontoggle` | | `/msg <player> <message>` | Send a private message to a player | `customchat.message` | | `/reply <message>` | Reply to the last player who sent a msg | `customchat.message` | | `/ignore <player>` | Ignore messages from a specific player | `customchat.ignore` | | `/spy ` | Spy on messages sent by a specific player | `customchat.spy` | | `/chatlock` | Lock the chat for all players except those with permission | `customchat.chatlock` | --- ## 🔐 Permissions | Permission | Description | |--------------------------------------------|---------------------------------------------------| | `customchat.admin` | Allows access to /customchat reload | | `customchat.format.<format>` | Allows usage of the specified chat format | | `customchat.changecolor` | Allows changing color of own messages | | `customchat.changeformat` | Allows changing format of own messages | | `customchat.chatcolor` | Allows access to /chatcolor | | `customchat.colorchat.color.<color>` | Allows access to a specific color in colorchat | | `customchat.colorchat.gradient.<gradient>` | Allows access to a specific gradient in colorchat | | `customchat.hover.item` | Allow access to | | `customchat.hover.inv` | Allow access to | | `customchat.hover.ender` | Allow access to | | `customchat.hover.location` | Allow access to | | `customchat.hover.ping` | Allow access to | | `customchat.mentiontoggle` | Allow access to /customchat mentiontoggle | | `customchat.message` | Allow access to /msg and /reply | | `customchat.ignore` | Allow access to /ignore | | `customchat.ignore.bypass` | Allow bypassing /ignore | | `customchat.spy` | Allow spying on private messages | | `customchat.chatlock` | Allow locking the chat for all players | --- ## 🧠 How it Works 1. The plugin loads chat formats defined in `config.yml`. 2. When a player sends a message, the plugin: - Detects their applicable format (based on permission priority). - Applies placeholders, colors, and hover/click actions. - Sends the formatted message to all players and the console. 3. If the player has the proper permission, they can use & color codes in their messages 4. If `&k` is blocked and the player uses it, they receive a warning. --- ## 📥 Installation 1. Download the plugin JAR. 2. Place it in your `plugins/` folder. 3. Restart the server. 4. Configure `config.yml` and run `/customchat reload`. --- ### 💬 Need Help or Suppo