ZealousChat

# ZealousChat *A modern, MiniMessage-powered chat formatter for Paper & Spigot servers* <details> <summary>Technical introduction</summary> ZealousChat replaces Vanilla chat with a fully configurable system built on the Paper's high performance **AsyncChatEvent** and **MiniMessage** components. It ships with rank/world specific formats, private messaging, inventory placeholders and a granular permission model – all while remaining light-weight and production ready. --- ## Features - **MiniMessage everywhere** – gradients, hex colours, hover/click events - **Rank, world & permission based formats** with priority system - **Private messaging** (`/msg`, `/reply`) with social-spy & cooldowns - **Cross-server private messaging** (optional, **MySQL required**) for networks running multiple servers - **Chat / Message toggles** per-player or server-wide (with staff bypass) - **Inventory placeholders** ``, ``, ``, ``, ``, `` - **URL auto-linking** & **@mentions** (configurable) - **Advanced swear filter** with regex and fuzzy matching, with a tiered punishment system. - **Database-backed infraction tracking** with caching for performance - **PlaceholderAPI bridge** (optional soft-depend) - **Hot-reloadable** plugin configurations (`/zchat reload`) - **Customizable Messages** for all messages used within the plugin. </details> ZealousChat is a high performance, 1.20.4+ chat formatting plugin that uses configurable MiniMessage-based chat formats to format chat messages. ZealousChat includes many extra features other plugins leave out, like the ability to send a read-only view of your inventory/hand/armor/enderchest in chat, formatted /msg and /reply commands, click/hover messages on messages, @mentions and more. ZealousChat also has special features for server networks, such as cross-server private messaging, and cross server chat channels (for staffchat and similar). ZealousChat implements all of its features using the Paper API, and is designed to be as efficient as possible. (https://modrinth.com/plugin/zealouschat/gallery) ## Commands ### Plugin Core - `/zealouschat` (`/chatplugin`, `/zchat`) — Base command for ZealousChat - Permission: `zchat.admin` - This command is not an actual command, but rather the base for all sub-commands. ### Configuration Commands - `/zealouschat reload` — Reload plugin configurations - Permission: `zchat.admin.reload` - `/zealouschat info` — Display current plugin settings and enabled features - Permission: `zchat.admin.info` - `/zealouschat test <message>` — Preview chat formatting - Permission: `zchat.admin.test` - Parameters: - `<message>`: Text to format and display ### Format Management - `/zealouschat format set default <format>` — Set default chat format - Permission: `zchat.admin.format` - Parameters: - `<format>`: MiniMessage format string - `/zealouschat format set group <group> <format>` — Define group-specific format - Permission: `zchat.admin.format` - Parameters: - `<group>`: Permission group name - `<format>`: MiniMessage format string - `/zealouschat format set world <world> <format>` — Define world-specific format - Permission: `zchat.admin.format` - Parameters: - `<world>`: World name - `<format>`: MiniMessage format string - `/zealouschat format list` — List all current chat formats - Permission: `zchat.admin.format` ### Feature Toggles - `/zealouschat toggle colors` — Enable/disable color codes in chat - Permission: `zchat.admin.toggle` - `/zealouschat toggle formatting` — Enable/disable text formatting - Permission: `zchat.admin.toggle` - `/zealouschat toggle mentions` — Enable/disable player @mentions - Permission: `zchat.admin.toggle` - `/zealouschat toggle cooldown` — Enable/disable chat cooldown - Permission: `zchat.admin.toggle` ### Private Messaging - `/msg <player> <message>` — Send a private message (aliases: `/message`, `/tell`, `/whisper`, `/w`) - Permission: `zchat.message` - Parameters: - `<player>`: Recipient player name - `<message>`: Message text - `/reply <message>` — Reply to the last private message sender (aliases: `/r`, `/respond`) - Permission: `zchat.message` - Parameters: - `<message>`: Reply text #### Cross-server private messages When you enable cross-server messaging in storage.conf (requires a MySQL or Redis database), ZealousChat can deliver private messages across multiple Paper servers on the same network. - `/msg` will attempt cross-server delivery when the target is online on another server - `/reply` also supports cross-server targets - Recipients that have private messages toggled off will not receive cross-server messages ### Chat & Social Spy Toggles - `/zealouschat toggle chat` — Toggle your public chat on/off - Permission: `zchat.toggle.chat` - `/zealouschat toggle messages` — Toggle your private messages on/off - Permission: `zchat.toggle.messages` - `/zealouschat toggle so