ChatEx-Refresh
ChatEx-Refresh — a fork of the ChatEx plugin. Based on the original ChatEx by TheJeterLP. Additional original contribution: Wizard_x.
Автор: MrSpectrumYT1,6 тыс.3обновлён 15 сент. 2026 г.
ОбщениеУтилиты
Описание
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 RGB colors, anti-spam for Minecraft servers.
✨ Features
- Full Minecraft 1.20+ support — Folia, Leaf, Paper, Pufferfish, Purpur, Spigot
- HEX & Legacy colors — both
#RRGGBBand&#RRGGBBformats - 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 - 34 languages — including English, Русский, Українська and more
- Logging — chat and ad logs with daily rotation
- Message formatting — fully customizable with PlaceholderAPI support
📁 Commands
| Command | Aliases | Permission | Description |
|---|---|---|---|
/chatex | /chat | - | Shows help for plugin |
/chatex help | /chat help | - | Shows command help |
/chatex clear | /chat clear | chatex.clear | Clears chat for all players |
/chatex reload | /chat reload | chatex.reload | Reloads config and locales |
/color | /chatcolor, /msgcolor | chatex.color | Set personal chat color |
🔑 Permissions
| Permission | Default | Description |
|---|---|---|
chatex.allowchat | true | Allows chatting |
chatex.color | op | Use /color to change color of chat |
chatex.chat.global | op | Use global chat if ranged mode enabled |
chatex.chat.colorlegacy | op | Use legacy colors (&c, &a, etc.) |
chatex.chat.colormodifier | op | Use formatting codes (&l, &m, &n, &o, &r) |
chatex.chat.colorhex | op | Use HEX colors (#RRGGBB, &#RRGGBB) |
chatex.chat.colorgradient | op | Use gradient colors (/color &#FF0000,#00FF00&l) |
chatex.chat.magic | op | Use magic color (&k) |
chatex.mention | op | Mention other players with sound |
chatex.antispam.bypass | op | Bypass the anti-spam system |
chatex.bypassads | op | Bypass the AdBlocker |
chatex.notifyad | op | Receive notification when a player tries to advertise |
chatex.notifyupdate | op | Receive notification about new updates |
chatex.clear | op | Use /chatex clear to clear the chat |
chatex.reload | op | Use /chatex reload to reload config and locales |
📦 Requirements
- Java 17+
- Folia / Leaf / Paper / Pufferfish / Purpur / Spigot 1.20+
- PlaceholderAPI — optional but recommended
- LuckPerms — optional for permission management
🎨 Color Examples
| Format | Example | Result |
|---|---|---|
| Legacy | &cHello | Red text |
HEX (with &) | &#FF0000Hello | Red text |
HEX (without &) | #FF0000Hello | Red text |
| Personal Color (Legacy) | /color &5&l | Dark purple bold text |
| Personal Color (HEX) | /color &#E43A96 | Pink text |
| Personal Color (HEX alt) | /color #E43A96 | Pink text |
| Gradient Legacy | /color &f,&c | Gradient from white to red |
| Gradient (2 colors) | /color #FF0000,#00FF00 | Gradient from red to green |
| Gradient (3+ colors) | /color #FF0000,#FFAA00,#00FF00 | Gradient with 3 colors |
| Gradient + Modifier | /color #FF0000,#00FF00&l | Gradient + bold text |
| Gradient + Mixed Formats | /color #FF0000,�FF00 | Works with both # and &# |
| Reset Color | /color reset | Removes personal color |
💡 Note: Both
#FF0000and&#FF0000formats are fully supported everywhere — in chat, in/color, and in config messages. You can freely mix them in gradients:/color #FF0000,�FF00,#0000FFworks perfectly!
⚠️ Important Notes
Server Software Compatibility
This plugin is designed and tested exclusively on Folia, Leaf, Paper, Pufferfish, Purpur and Spigot. 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
📣 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:
- Check that you have Java 17+
- Verify your server is running Folia / Leaf / Paper / Pufferfish / Purpur / Spigot
- Read the console for error messages
🌐 Contacts
- Discord/Telegram: @MrSpectrumYT
- Bug reports & feature requests: Contact via Discord/Telegram or Issues GitHub
Последние версии
Все версии →release
4.6.1
4.6.115 сент. 2026 г.450Minecraft: 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2, 26.3bukkit, folia, paper, purpur, spigot
Что нового
### Added
- Minecraft 26.3 version support
- New update numbering system
### Changed
- Small localization fix
- Small config header fix
## ⚠️ WARNING
- Old configs and locales are incompatible with version 4.3.0 and later.
- API removed — plugins using `ChatExAPI` will break.
release
4.6.0
4.6.029 авг. 2026 г.149Minecraft: 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2folia, paper, purpur, spigot
Что нового
### Changed
- The license and description of the plugin have been corrected.
## ⚠️ WARNING
- Old configs and locales are incompatible with version 4.3.0 and later.
- API removed — plugins using `ChatExAPI` will break.
release
4.5.5
4.5.56 авг. 2026 г.247Minecraft: 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2folia, paper, purpur, spigot
Что нового
### Added
- Minecraft 1.20.x version support
### Changed
- Fixed an issue with player mentions
- The update checking method has been changed
## ⚠️ WARNING
- Old configs and locales are incompatible with version 4.3.0 and later.
- API removed — plugins using `ChatExAPI` will break.
release
4.5.0
4.5.025 июл. 2026 г.121Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2folia, paper, purpur, spigot
Что нового
### Added
- Support for legacy colors in gradients `/color &f,&c&l&n`
### Changed
- Fixed an issue with multiple modifiers in a gradient
## ⚠️ WARNING
- Old configs and locales are incompatible with version 4.3.0 and later.
- API removed — plugins using `ChatExAPI` will break.
release
4.4.5
4.4.528 июн. 2026 г.266Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2folia, paper, purpur, spigot
Что нового
### Changed
- Fixed memory leak (from GitHub ChatEx #177)
- Optimized plugin performance
- Completely rewrote `ColorCommand` — improved validation and tab completion
- Fixed display of gradient in one symbol
### Removed
- ChatEx API (all API classes and events removed)
- Removed placeholder examples from tab suggestions
## ⚠️ WARNING
- Old configs and locales are incompatible with version 4.3.0 and later.
- API removed — plugins using `ChatExAPI` will break.
release
4.4.0
4.4.027 июн. 2026 г.22Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2folia, paper, purpur, spigot
Что нового
### Added
- Gradient support — `/color &#FF0000,#00FF00&l`
- `chatex.chat.colorgradient` permission
### Removed
- Deprecated RGBColors system (`$g`, `$p` macros)
## ⚠️ WARNING
- Old configs and locales are incompatible with version 4.3.0 and later.
release
4.3.5
4.3.516 июн. 2026 г.91Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2folia, paper, purpur, spigot
Что нового
### Added
- Minecraft 26.2 version support
## ⚠️ WARNING
- Old configs and locales are incompatible with version 4.3.0 and later.
release
4.3.0
4.3.06 июн. 2026 г.87Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2folia, paper, purpur, spigot
Что нового
### Added
- `chatex.chat.colormodifier` permission for formatting codes
### Changed
- All messages fully localized in locales
- Unified placeholders now require closing `%` (e.g., `%player%`, `%prefix%`)
- `/chatex` now shows help instead of plugin info
## ⚠️ WARNING
- Old configs and locales are incompatible with version 4.3.0 and later.
release
4.2.5
4.2.55 июн. 2026 г.25Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2folia, paper, purpur, spigot
Что нового
### Added
- Simple player mention system with configurable sound
- `chatex.mention` permission
release
4.2.0
4.2.03 июн. 2026 г.27Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2folia, paper, purpur, spigot
Что нового
### Added
- `/color` command for personal chat color
- `chatex.color` permission for `/color` access
- `userdata.yml` for persistent color storage
- Ad notification now includes the ad message