💬 gChat — Modern Chat Manager

gChat is a lightweight yet incredibly powerful chat management plugin for Minecraft servers (1.16+). It combines chat separation, full HEX gradient support, Discord integration, a mention system, and moderation tools.

You no longer need bulky plugins like ChatEx or CMI for chat handling. gChat has everything you need!

---

✨ Key Features

• 🎨 Advanced Formatting: Full support for HEX colors (&#RRGGBB) and Gradients ({#start>}text{#end<}).

• 🌍 Chat Separation: Local (radius-based) and Global chat modes.

• 🔔 Mention System:

• Mention a player via @Name — they receive a sound, an Action Bar notification, and the text is highlighted.

• @everyone support for administrators.

• Smart player search (tab-completion style logic).

• 📨 Private Messages: Convenient /msg system and quick reply via /r (reply).

• 🛡️ Moderation: Built-in profanity filter, link blocking, and command spam protection.

• 🤖 Integrations:

• DiscordSRV — full chat synchronization (Minecraft ↔ Discord).

• LuckPerms — support for prefixes, suffixes, and group formats.

• PlaceholderAPI — support for all placeholders.

• EssentialsX — mute support.

• 📢 Auto-Broadcasts: Configurable announcements with intervals.

• 💀 Custom Messages: Fully customizable Join, Quit, and Death messages.

• 🌐 Multi-language: Ready-made translations for RU, EN, UA, PL, ES, PT.

---

🎨 How to use colors?

The plugin uses its own powerful formatting engine:

Type	Format	Example
HEX Color	&#RRGGBB	&#FF0000Hello
Gradient	{#HEX>}Text{#HEX<}	{#ff0000>}Your Text{#0000ff<}
Standard	& codes	&cHello

---

🛠 Commands

Command	Aliases	Description	Permission
/gchat reload	-	Reload configuration	gchat.reload
/g <text>	/gc	Global chat	gchat.global
/l <text>	/lc	Local chat	gchat.local
/msg <player>	/w, /tell	Private message	gchat.chat.msg
/reply <text>	/r	Quick reply	gchat.chat.reply
/broadcast	/bc	Manage announcements	gchat.broadcast

---

📋 Permissions

• gchat.use — Access to use the plugin (default: true).
• gchat.chat.ping — Permission to mention players using @Name.
• gchat.chat.everyone — Permission to use @everyone.
• gchat.color.hex — Permission to use HEX colors.
• gchat.gradient — Permission to use gradients.
• gchat.bypass.filter — Bypass the profanity filter.
• gchat.bypass.cooldown — Bypass chat cooldowns.

---

⚙️ Configuration

Configuration files are generated automatically. You can configure chat formats for each LuckPerms group:

group-formats:
  default: "%gchat_format% &7%player_name% &8» &f%message%"
  admin: "%gchat_format% &cAdmin %player_name% &8» &f%message%"
  vip: "%gchat_format% {#ff0000>}%player_name%{#0000ff<} &8» &f%message%"

Language Support

Simply change the language parameter in config.yml:

language: en # Available: ru, en, ua, pl, es, pt

---

📥 Installation

1. Download the .jar file.
2. Move it to the /plugins folder of your server.
3. Restart the server.
4. (Optional) Install PlaceholderAPI and LuckPerms for full functionality.

---

🤝 Dependencies

The plugin works standalone, but for the best experience, we recommend:

• Soft Depends: PlaceholderAPI, LuckPerms, DiscordSRV, EssentialsX.