🚀 Ychat (by nuan)

Ychat is a lightweight, feature-rich, and highly customizable chat management plugin for Minecraft servers. Built entirely on the modern Adventure API, it replaces the boring vanilla chat with a fully interactive system featuring stunning HEX gradients, custom sound notifications, and dynamic clickable elements.

✨ Features

📍 Local & Global Chats: Easily split communication. Local chat works within a set radius (100 blocks by default), while global chat can be accessed by using the ! prefix.
👥 Friend Chat & Sync: Quick messaging dedicated to friends using the @ prefix. Friends also get a custom glowing potion effect when they log into the server.
🛡️ Friendly Fire Prevention: Built-in toggle to disable PvP between friends. Can be easily switched on/off using the /f pvp command.
🔗 Interactive Names (Click & Hover):
- Hover: Hovering over a player's name in chat brings up a fully customizable stats card (showing HP, Ping, Exp Level, Kills, Deaths, etc.).
- Click: Clicking a player's name automatically inserts a command into the chat bar (e.g., /msg <player> or /tpa <player>), making communication seamless.
📢 Advertisement System (/ad): Allow players to broadcast shoutouts or ads with a configurable cooldown timer and dynamic pricing/formatting.
🔔 Custom System Notifications with Sounds:
- Beautiful custom templates for Join, Quit, Death, and Advancement messages.
- Personal MOTD Welcome: Send a unique greeting accompanied by a private sound effect visible only to the player logging in.
- Global Join Sounds: Broadcast a specific sound notification to the rest of the server when a player arrives.
🎨 Full HEX & MiniMessage Support: Forget the old legacy color code limitations! Use modern HEX codes (#FF9146) to create unique gradient styles across all text components.
🧩 PlaceholderAPI (PAPI) Integration: Full support for any external placeholders to display customized statistics in the chat formats or hover menus.

🛠️ Commands & Permissions

/chatx reload — Reloads the plugin configuration. (Permission: chatx.admin)
/ad [text] — Broadcasts an advertisement to the server.
/friend [add/remove/list/pvp] — Manages the friend system.
/msg [player] [text] — Sends a private message to a player.
/reply [text] or /r [text] — Quickly replies to the last private message received.

⚙️ Dependencies

Server Software: Paper, Purpur, or Spigot (Versions 1.19.x - 1.21.x+ supporting the Adventure API).
PlaceholderAPI (Optional) — Required if you want to use external statistics placeholders (like player kills or deaths) in your hover stats menu.

💾 Installation

Download the plugin .jar file.
Drop it into your server's plugins folder.
Restart your server (or load it using a plugin manager).
Customize the generated config.yml to your liking and type /chatx reload.