[![Spigot](https://img.shields.io/badge/Available%20on-Spigot-orange?style=for-the-badge&logo=spigotmc&logoColor=white)](https://www.spigotmc.org/resources/135770/) [![Wiki](https://img.shields.io/badge/Wiki-Documentation-blue?style=for-the-badge&logo=readme&logoColor=white)](https://wiki-x-proyects.vercel.app/) [![Discord](https://img.shields.io/badge/Discord-Community-7289da?style=for-the-badge&logo=discord&logoColor=white)](https://discord.xproyects.qzz.io/) # **X-Chat** ### *Advanced chat management with MiniMessage and custom formats*

### 📝 **Description** X-Chat is a comprehensive chat management plugin that gives you full control over your server's chat experience. From priority-weighted formats and interactive hover/click effects to real-time moderation filters and custom emojis — everything is configurable from YAML files. Supports all major color formats and gracefully handles both Paper and Spigot servers. Compatible with Minecraft 1.18+. ### ✨ **Features** - **Priority-based Format System:** Create unlimited chat formats (admin, vip, default, etc.) with numeric priorities. The highest-priority format the player has permission for is automatically selected. Each format has independent color permissions (legacy, hex, MiniMessage). - **Full Color Format Support:** MiniMessage (``, ``), Legacy (`&c`, `&l`), Hex (`&#FF0000`), BBCode (`[BOLD]`, `[COLOR=#hex]`), and HTML shorthand (``, ``, ``, ``) — all auto-converted seamlessly. - **Interactive Player Names:** Hover over a player's name to see custom info (rank, ping, etc. via PlaceholderAPI). Click to execute configurable actions (suggest command, run command, open URL, copy to clipboard). Works with all formats. - **Auto-Mentions:** Automatically detects when a player mentions another by name in chat. Highlights the mentioned name with a custom gradient format and plays a configurable sound. Supports optional `@` prefix requirement. - **Smart Moderation Suite:** Anti-Spam (configurable cooldown), Anti-Caps (percentage threshold with auto-lowercase or block), Anti-Advertising (regex-based IP and Discord link detection), and Smart Censor (partial `w**d` or full `****` word censoring). Each filter has its own bypass permission. - **Dynamic Chat Tags:** `[item]` — shows held item with hover tooltip (name, amount, durability, enchantments). `[pos]` — displays coordinates with click-to-copy. `[ping]` — shows player latency. All individually configurable with their own YAML files. - **Custom Emoji System:** Define text shortcuts that are replaced with emojis or formatted text. Supports MiniMessage in emoji values. Permission-gated or open to everyone. - **Auto-Links:** URLs in chat are automatically converted to clickable links with configurable hover text. - **Private Messaging System:** `/msg`, `/r` (reply) — usable by all players by default. Includes SocialSpy for staff, ignore system with persistence, and self-message prevention. - **Chat History:** Per-player message log saved in memory and disk. View with `/chatlog` or `/history` with paginated output. - **Custom Join/Leave Messages:** Configurable join, leave, and first-join messages with MiniMessage and PlaceholderAPI support. Cancels default Bukkit messages. - **Auto-Broadcaster:** Timed announcements with random or sequential order, configurable sounds, and multi-line MiniMessage support. - **Custom Death Messages:** Per-cause death messages (PvP, fall, drown, fire, lava, void, explosion, cactus, lightning, magic, projectile, etc.) with MiniMessage formatting. - **Placeholders in Messages:** Allow players to use PlaceholderAPI placeholders directly in their chat messages (configurable with permission). - **6 Language Files:** EN, ES, PT, JA, RU, and CUSTOM — switch languages at runtime with `/xchat locate`. - **Dynamic Command Registration:** All commands (names and aliases) are defined in `config.yml` — no need to edit `plugin.yml`. Changes apply on reload. - **Config Auto-Updater:** Detects outdated configurations, creates a backup, and rebuilds automatically on startup. - **Paper & Spigot Compatible:** Hover, click, and interactive effects work natively on Paper. On Spigot, they are automatically stripped to plain text — no errors, no crashes. - **Folia Supported:** Fully compatible with Folia's regionized threading. ### 🖥️ **Compatibility** | Software | Supported | |---|---| | Bukkit / Spigot / Paper / Purpur | ✅ | | Folia | ✅ | | PlaceholderAPI | ✅ (soft) | | Vault | ✅ (soft) | | Minecraft | 1.18 → 1.21+ | ### 🛠️ **Main Commands** **`/msg `** Sends a private message to a player. Usable by everyone by default. **`/r `** Replies to the last player who sent you a private message. Usable by everyone by default. **`/clearchat`** Clears the chat for all online players. **`/socialspy`** Toggles SocialSpy mode — see all private messages sent between players. **`/ignore `** Ignores a player. You will no longer see their messages or receive messages from them. Persistent across restarts. **`/sudo `** Forces a player to execute a command or send a chat message. **`/chatlog [page]`** View a player's recent chat history with paginated output. **`/broadcast `** Send a global announcement to all online players with a custom format. **`/xchat [subcommand]`** - **`help`** — Shows the help menu. - **`reload`** — Reloads all YAML configurations. - **`version`** — Shows the current version info. - **`update`** — Manually check for updates. - **`locate `** — Changes the plugin language at runtime. ### 🛡️ **Permissions** **Chat Formats** - **`xchat.format.admin`** — Use the admin chat format. *(default: none)* - **`xchat.format.vip`** — Use the VIP chat format. *(default: none)* - **`xchat.format.default`** — Use the default chat format. *(default: none)* **General** - **`xchat.colors`** — Master permission to use ALL color types (legacy, hex, MiniMessage). *(default: op)* - **`xchat.tags.all`** — Master permission to use ALL interactive tags. *(default: none)* **Commands** - **`xchat.command.clear`** — Use `/clearchat`. *(default: op)* - **`xchat.command.spy`** — Use `/socialspy`. *(default: op)* - **`xchat.command.ignore`** — Use `/ignore`. *(default: op)* - **`xchat.command.sudo`** — Use `/sudo`. *(default: op)* - **`xchat.command.history`** — Use `/chatlog`. *(default: op)* - **`xchat.command.broadcast`** — Use `/broadcast`. *(default: op)* **Administration** - **`xchat.admin`** — Use `/xchat` admin commands. *(default: op)* **Filter Bypass** - **`xchat.bypass.spam`** — Bypass anti-spam cooldown. *(default: none)* - **`xchat.bypass.caps`** — Bypass anti-caps filter. *(default: none)* - **`xchat.bypass.advertising`** — Bypass anti-advertising filter. *(default: none)* - **`xchat.bypass.blocked-words`** — Bypass blocked-words filter. *(default: none)* - **`xchat.bypass.grammar`** — Bypass auto-grammar corrections. *(default: none)* **Features** - **`xchat.placeholders`** — Use PlaceholderAPI placeholders in chat messages. *(default: none)* - **`xchat.emojis`** — Use custom emojis in chat. *(default: none)* - **`xchat.tags.click`** — Use click tags in chat. *(default: none)* - **`xchat.tags.hover`** — Use hover tags in chat. *(default: none)* - **`xchat.tags.insert`** — Use insert tags in chat. *(default: none)* - **`xchat.tags.font`** — Use font tags in chat. *(default: none)* > **Tip:** `/msg` and `/r` have no permission by default — all players can use them. You can add a permission in `config.yml` to restrict access.

_{Need help? Join our [Discord](https://ptb.discord.com/invite/Yb6GsfGWmd) or report issues in the discussion section.}

X-Chat

Compatibility

Minecraft: Java Edition

Platforms

Links

Tags

Creators

Details

Broadcast command

All commands of X-Chat