🚀 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

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