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 PlaceholderAPI 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 [player]`	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 [item]
`customchat.hover.inv`	Allow access to [inv]
`customchat.hover.ender`	Allow access to [ender]
`customchat.hover.location`	Allow access to [location]
`customchat.hover.ping`	Allow access to [ping]
`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

The plugin loads chat formats defined in config.yml.
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.
If the player has the proper permission, they can use & color codes in their messages
If &k is blocked and the player uses it, they receive a warning.

📥 Installation

Download the plugin JAR.
Place it in your plugins/ folder.
Restart the server.
Configure config.yml and run /customchat reload.

💬 Need Help or Support?

📖 Wiki: https://rexi666-plugins.gitbook.io/rexi666/customchat

Join my Discord server (Spanish/English):

🙋‍♂️ Author

Made with ❤️ by Rexi666

If you enjoy this plugin, consider donating!