AuryxChat

# 💬 AuryxChat - Advanced Chat Management System !(https://img.shields.io/badge/Version-1.0.0--SNAPSHOT-blue?style=for-the-badge) !(https://img.shields.io/badge/Minecraft-1.8.8--1.21.10-green?style=for-the-badge) !(https://img.shields.io/badge/Platform-Paper%20%7C%20Spigot%20%7C%20Folia%20%7C%20Purpur-orange?style=for-the-badge) !(https://img.shields.io/badge/License-MIT-red?style=for-the-badge) **AuryxChat** is a powerful, feature-rich chat management plugin designed as a modern alternative to EssentialsX Chat. Built for **Paper**, **Folia**, and other modern Minecraft platforms with advanced formatting, moderation, and cross-version compatibility. --- ## ✨ **Key Features** ### 💬 **Advanced Chat System** - **Local & Global Chat** - Radius-based local chat with global override - **Chat Mode Toggle** - Easy switching between local/global modes - **Visual Indicators** - `` and `` prefixes show current chat mode - **Force Global** - Use `!` prefix to send global messages from local mode ### 🎨 **Rich Formatting** - **Custom Chat Formats** - Per-group chat formatting (Admin, VIP, Default) - **Color Support** - Full legacy color code support (`&c`, `&a`, etc.) - **Placeholder Integration** - PlaceholderAPI and AuryxCore placeholders - **Hover Text** - Rich hover information with player stats ### 🛡️ **Chat Moderation** - **Word Filter** - Configurable word/phrase blocking with regex support - **Anti-Spam** - Intelligent spam detection and prevention - **Mute Integration** - Full integration with AuryxCore mute system - **Action Logging** - Comprehensive moderation logging ### 🔔 **Player Mentions** - **@Player Mentions** - Highlight and notify players when mentioned - **Sound Notifications** - Configurable mention sounds - **Visual Highlighting** - Mentioned players see highlighted messages --- ## 🎮 **Commands Overview** | Command | Description | Permission | |---------|-------------|------------| | `/auryxchat` | Main plugin command | `auryxchat.admin` | | `/auryxchat reload` | Reload configuration | `auryxchat.reload` | | `/auryxchat about` | Plugin information | `auryxchat.use` | | `/auryxchat announce <msg>` | Server announcement | `auryxchat.announce` | | `/chat toggle` | Toggle chat mode | `auryxchat.toggle` | | `/chat local` | Switch to local chat | `auryxchat.local` | | `/chat global` | Switch to global chat | `auryxchat.global` | | `/chat status` | Check current mode | `auryxchat.use` | --- ## 🎯 **Chat Modes Explained** ### 🏠 **Local Chat** - **Radius-based** - Only players within configured range can see messages - **Prefix**: `` (Green, Bold) - **Default Range**: 100 blocks (configurable) - **Perfect for**: Roleplay servers, survival gameplay ### 🌍 **Global Chat** - **Server-wide** - All online players receive messages - **Prefix**: `` (Red, Bold) - **Always Available** - Use `!` prefix to force global from local mode - **Perfect for**: Announcements, general discussion ### ⚡ **Quick Global Override** ``` # In local mode: Hello nearby players → Player: Hello nearby players ! Hello everyone on server → Player: Hello everyone on server ``` --- ## 🎨 **Chat Format Examples** ### **Default Player** ``` Sqrilizz: Hello world! ``` ### **VIP Player** ``` ProPlayer: Check out my base! ``` ### **Admin** ``` ServerOwner: Welcome to the server! ``` --- ## 🛡️ **Moderation Features** ### **Word Filter** - **Regex Support** - Advanced pattern matching - **Custom Actions** - Block, replace, or warn - **Bypass Permission** - `auryxchat.filter.bypass` - **Real-time Updates** - No restart required for filter changes ### **Anti-Spam Protection** - **Message Similarity** - Detects repeated messages - **Rate Limiting** - Configurable cooldown periods - **Smart Detection** - Ignores case and spacing variations - **Automatic Warnings** - Progressive punishment system ### **Mute Integration** - **AuryxCore Sync** - Seamless integration with AuryxCore mutes - **Command Blocking** - Prevents muted players from using chat commands - **Bypass Permissions** - Staff can always communicate --- ## 🔧 **Installation & Setup** ### **Requirements** - **AuryxCore** - Required for full functionality - **Java 21+** - Recommended version - **Paper 1.8.8+** - Or compatible server platform ### **Installation Steps** 1. **Install AuryxCore** first (dependency) 2. **Download AuryxChat** from Modrinth 3. **Place JAR** in your `plugins/` folder 4. **Restart server** to generate configuration 5. **Configure** settings in `plugins/AuryxChat/` ### **Optional Dependencies** - **PlaceholderAPI** - Enhanced placeholder support - **VaultUnlocked** - Permission group prefixes - **LuckPerms** - Advanced permission integration --- ## ⚙️ **Configuration Highlights** ### **Chat Formats** (`config.yml`) ```yaml chat: formats: default: "&7 &7 &f<player>: &f<message>"