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>[Owner]</gradient>, <✨>, 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