ChatEx-Refresh

ChatEx-Refresh

⚠️ WARNING

This plugin is not ChatEx. It is a fork of the ChatEx plugin. The authors of the original ChatEx — TheJeterLP and Wizard_x. ChatEx repository — https://github.com/TheJeterLP/ChatEx.

ChatEx-Refresh — a powerful chat management plugin with MiniMessage, RGB colors, gradients and anti-spam for Minecraft servers.

✨ Features

• Minecraft 1.16.5+ support — Spigot, Paper and Paper forks
• Full MiniMessage support — colors, HEX, gradients, rainbow, hover, click, fonts, keybind, lang, newline
• Legacy + HEX + &# + # + &x — all in a single line, mixed freely
• Custom MiniMessage parser — no Adventure dependency, works on Spigot too
• Gradients — unlimited colors, modifiers, legacy and HEX mixed
• Anti-Spam system — configurable cooldowns to prevent chat flooding
• Ad Blocker — smart detection with IP/domain filtering
• Range Mode — local chat with configurable radius
• Player Mentions — mention online players with configurable sound
• Personal Chat Color — players can set their own chat color via /color
• Interactive messages — click / hover commands and links in help and usage
• Command Filtering — apply chat rules to /msg, /me, and other commands
• Split MiniMessage permissions — control every tag separately
• 34 languages — including English, Русский, Українська and more
• Logging — chat and ad logs with daily rotation
• Message formatting — fully customizable with PlaceholderAPI support

📁 Commands

🔑 Permissions

General

Legacy colors

MiniMessage (split per tag)

Umbrella permissions

💡 Note: chatex.color is a standalone permission for the /color command — it does not grant any MiniMessage or legacy color permissions.

📦 Requirements

• Java 17+
• Spigot, Paper and Paper forks 1.16.5+
• PlaceholderAPI — optional but recommended
• LuckPerms — optional for permission management

🎨 Color Examples

Legacy & HEX

Personal Color

Gradients

MiniMessage

💡 Note: All formats can be mixed in a single line — <red>Hello &cWorld #FFAA00!</red> works perfectly. The parser converts everything on the fly.

⚠️ Important Notes

Server Software Compatibility

This plugin is designed and tested exclusively on Spigot, Paper and Paper forks (1.16.5+). It may work on other forks, but compatibility is NOT guaranteed.

Not supported:

• Any Minecraft Bedrock
• Cardboard (Spigot-Fabric compatibility layer)
• Hybrid server software (Arclight, Magma, Mohist and etc)
• Mod loaders (Fabric, Forge, LegacyFabric, LiteLoader, NeoForge, Quilt and etc)
• Proxy servers (BungeeCord, Velocity, Waterfall and etc)
• Vanilla Minecraft Java

MiniMessage notes

• <hover:show_item>, <hover:show_entity> — not supported
• <selector>, <score>, <nbt> — not supported
• <transition>, <shadow>, <pride> — not supported
• <click:open_file>, <click:change_page> — not supported
• Unsupported tags are printed as plain text

📣 bStats

📄 License

This project is licensed under the GNU General Public License v2.0 — you are free to use, modify, and distribute it, as long as you keep the same license.

💬 Support

If you encounter issues or have questions:

1. Check that you have Java 17+
2. Verify your server is running Spigot, Paper or a Paper forks (1.16.5+)
3. Read the console for error messages

🌐 Contacts

• Telegram or Discord: @MrSpectrumYT
• Bug reports & feature requests: Contact via Telegram/Discord or Issues GitHub