ChatEngine

# ChatEngine — Modern Chat Manager for Paper/Spigot ChatEngine is a lightweight, high-performance, and fully configurable chat management plugin built for modern Paper and Spigot servers (1.21.x – 26.2). Designed to replace outdated chat plugins, ChatEngine brings native Kyori Adventure / MiniMessage support, smooth RGB gradients, multi-scope chat channels, real-time LuckPerms integration, and built-in chat moderation — all with zero unnecessary overhead. --- ## Key Features ### Native MiniMessage & Universal Color Support * **Smooth RGB Gradients**: Full native support for MiniMessage tags (e.g. `<gradient:#FFAA00:#FF6600></gradient>`, `<rainbow>`, etc.). * **Multi-Format Hex & Legacy Codes**: Accepts `&#RRGGBB`, `<#RRGGBB>`, `#RRGGBB`, and classic `&0`–`&f` codes. * **Granular Style Permissions**: Control access per rank for bold (`&l`), italic (`&o`), underline (`&n`), strikethrough (`&m`), magic (`&k`), and colors. * **Template Color Isolation**: Server layout, brackets, and rank prefixes always retain their colors regardless of a player's individual chat color permissions. ### Multi-Scope Chat Channels (`/channel`, `/ch`) * **Flexible Channel Scopes**: Configure `GLOBAL`, `WORLD`, or custom `CHANNEL` scopes in `channels.yml`. * **Independent Channel Permissions**: Control who can speak (`permission-speak`) and who can listen (`permission-view`) per channel. * **Quick & Persistent Messaging**: Switch your active channel or send one-off messages to a specific channel on the fly. ### Real-Time LuckPerms & PlaceholderAPI Integration * **Dynamic Metadata**: Prefixes, suffixes, and primary groups update automatically in real-time. * **PlaceholderAPI Support**: Use any placeholder inside chat formats, channel layouts, join/quit messages, and death notifications. * **Priority Formatting**: Define chat format rules with priority: `by-group` > `by-world` > `default`. ### Custom Join, Leave & Death Announcements * Fully customizable join, quit, and death messages supporting MiniMessage gradients and placeholders. * Per-cause death messages (e.g. fall, lava, entity attack) with toggle options to prevent conflicts with other plugins. ### Built-in Moderation & Anti-Spam Engine * **Rate-Limit & Repeat Protection**: Configurable cooldowns and message repetition windows with distinct alert messages. * **Chat Filters**: Block forbidden words, web links, and unwanted patterns. * **Auto-Mute & Staff Alerts**: Automatic temporary mutes for repeat offenders and real-time staff notifications. * **Server-Wide Controls**: Instantly clear chat or mute the global chat during events or maintenance. --- ## Commands & Permissions ### Player & Channel Commands * `/channel` (alias `/ch`) — Opens the channel menu and lists available channels. * `/channel <name>` — Switches your active speaking channel. * `/channel <name> <message>` — Sends a quick message to a channel without changing your active channel. ### Administrative Commands * `/chatengine info` (alias `/ce info`) — Displays plugin information and active integrations. * `/chatengine reload` (alias `/ce reload`) — Reloads all configuration files, channels, and caches. * `/chatengine clearchat` (alias `/ce clearchat`) — Clears global chat for all online players. * `/chatengine mutechat` / `/chatengine unmutechat` — Toggles server-wide chat mute. --- ## Technical Specifications & Requirements * **Supported Versions:** Minecraft 1.21.x – 26.2 * **Server Software:** Paper, Purpur, Spigot * **Java Version:** Java 25 (also compatible with Java 21) * **Soft Dependencies:** LuckPerms, PlaceholderAPI