UltimateChats

** 🎯 UltimateChat - Complete Plugin Overview 📋 Plugin Description **UltimateChat** is a comprehensive, enterprise-grade chat management plugin for Minecraft Paper servers (1.21+). Designed with **100% configurability** in mind, every feature can be toggled, customized, and translated without touching code. Built using modern Java 21, the Kyori Adventure library, and sophisticated database architecture, it provides everything from basic chat formatting to advanced social systems and Discord integration. --- ⭐ Core Philosophy **100% Configurability** - Every feature has an `enabled: true/false` toggle - All messages stored in `messages.yml` for easy translation - All keywords customizable (change `` to ``, etc.) - All formats use MiniMessage for hex colors and gradients - No hardcoded text or behavior **Modular Architecture** - 55 independent Java classes - Clean separation of concerns (chat, social, moderation, database) - Easy to extend and customize - Professional code structure with interfaces and abstractions **Performance First** - Async database operations (HikariCP connection pooling) - Cached message parsing - Efficient event handling - Optimized for servers with 100+ players --- 🎨 Feature Categories **1. Advanced Chat Formatting** **Visual Customization:** - **MiniMessage Support**: Full hex colors (`FF5555`), gradients, rainbow text - **Priority Tag System**: Weight-based tag sorting (Admin > Mod > VIP) ```yaml admin: permission: "ultimatechat.tag.admin" display: "<gradient:ff0000:ff5555></gradient>" weight: 100 ``` - **Prefixes & Suffixes**: Permission-based role indicators - **Click Actions**: Configurable click events (suggest command, open URL, run command) - **Hover Text**: Custom tooltip when hovering over names ```yaml hover-text: text: | <gray>Level: {level}</gray> <gray>Ping: {ping}ms</gray> ``` **Placeholders:** - Built-in: `{player}`, `{displayname}`, `{world}`, `{x}`, `{y}`, `{z}`, `{health}`, `{level}`, `{ping}`, etc. - PlaceholderAPI integration (optional) - Custom placeholders from config --- **2. Interactive Chat Elements** **Item Linking:** ``` Player: "Check out my sword! " → Displays item with full NBT, enchantments, lore on hover ``` - Configurable keyword (default: ``) - Shows item name, durability, enchantments, lore - Permission-based (`ultimatechat.chat.itemlink`) **Inventory Display:** ``` Player: "Here's my inventory " → Shows summarized inventory on hover ``` - Top 10 items with quantities - Configurable display format - Also supports `` for enderchest **Player Mentions:** ``` Player: "@Steve come here!" → Steve receives notification + sound + highlight ``` - Automatic @Player detection - Sound notification (configurable type/volume/pitch) - Optional title notification - Click to message **Custom Placeholders:** ```yaml pos: trigger: "" replacement: "X: {x}, Y: {y}, Z: {z}" hover: "<gray>World: {world}</gray>" ``` --- **3. Social Systems** **Friend System** **Features:** - Send/accept/deny friend requests - Friend list with online status indicators - Friend chat (`/fc <message>`) - broadcast to all online friends - Join/quit notifications - Permission-based friend limits (10/25/50/100/unlimited) **Commands:** ``` /friend add <player> - Send friend request /friend accept <player> - Accept request /friend deny <player> - Deny request /friend remove <player> - Remove friend /friend list - View all friends (green = online) /friend requests - View pending requests /fc <message> - Friend chat ``` **Database Storage:** - Persistent across sessions - MySQL or SQLite support - Efficient indexed queries **Party System** **Features:** - Create temporary party groups - Invite players to party - Party chat (session-based) - Leader controls (kick, disband) - Max party size configurable **Commands:** ``` /party create - Create a party /party invite <player> - Invite to party /party accept - Accept invite /party leave - Leave party /party kick <player> - Kick member (leader only) /party list - View members ``` **Ignore/Block System** **Features:** - Completely hide messages from ignored players - Persistent ignore list - Works across all channels **Commands:** ``` /ignore <player> - Ignore a player /ignore remove <player> - Unignore /ignore list - View ignored players ``` --- **4. Multi-Channel System** **Channel Types:** **Global Channel:** - Server-wide communication - Default channel for all players - Integrates with ignore list **Local Channel:** - Radius-based proximity chat (default: 100 blocks) - Shows message range indicator - Perfect for roleplay servers **Staff Channels:** - **Admin**: `ultimatechat.channel.admin` - **Moderator**: `ultimatechat.channel.mod` - **Builder**: `ultimatechat.channel.builder` - Private communication