📝 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 (<red>, <gradient>), Legacy (&c, &l), Hex (&#FF0000), BBCode ([BOLD], [COLOR=#hex]), and HTML shorthand (<b>, <i>, <u>, <s>) — 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

🛠️ Main Commands

/msg <player> <message> Sends a private message to a player. Usable by everyone by default.

/r <message> 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 <player> Ignores a player. You will no longer see their messages or receive messages from them. Persistent across restarts.

/sudo <player> <command/message> Forces a player to execute a command or send a chat message.

/chatlog <player> [page] View a player's recent chat history with paginated output.

/broadcast <message> 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 <language> — 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.