? AuryxChat - 高级聊天管理系统
AuryxChat 是一款功能强大、特性丰富的聊天管理插件,旨在作为 EssentialsX Chat 的现代替代品。专为 Paper、Folia 及其他现代 Minecraft 平台构建,提供高级格式化、审核功能和跨版本兼容性。
✨ 核心特性
? 高级聊天系统
- 本地与全局聊天 - 基于半径的本地聊天,支持全局覆盖
- 聊天模式切换 - 轻松在本地/全局模式之间切换
- 视觉指示器 -
[L] 和 [G] 前缀显示当前聊天模式
- 强制全局 - 使用
! 前缀从本地模式发送全局消息
? 丰富格式化
- 自定义聊天格式 - 按组设置聊天格式(管理员、VIP、默认)
- 颜色支持 - 完整的传统颜色代码支持(
&c、&a 等)
- 占位符集成 - PlaceholderAPI 和 AuryxCore 占位符
- 悬停文本 - 带有玩家统计信息的丰富悬停信息
?️ 聊天审核
- 词库过滤 - 支持正则表达式的可配置单词/短语屏蔽
- 防垃圾信息 - 智能垃圾信息检测与预防
- 禁言集成 - 与 AuryxCore 禁言系统完全集成
- 操作日志记录 - 全面的审核日志记录
? 玩家提及
- @玩家提及 - 被提及时高亮并通知玩家
- 声音通知 - 可配置的提及音效
- 视觉高亮 - 被提及的玩家会看到高亮的消息
? 命令概览
| 命令 |
描述 |
权限 |
/auryxchat |
主插件命令 |
auryxchat.admin |
/auryxchat reload |
重载配置 |
auryxchat.reload |
/auryxchat about |
插件信息 |
auryxchat.use |
/auryxchat announce <msg> |
服务器公告 |
auryxchat.announce |
/chat toggle |
切换聊天模式 |
auryxchat.toggle |
/chat local |
切换到本地聊天 |
auryxchat.local |
/chat global |
切换到全局聊天 |
auryxchat.global |
/chat status |
检查当前模式 |
auryxchat.use |
? 聊天模式详解
? 本地聊天
- 基于半径 - 只有配置范围内的玩家能看到消息
- 前缀:
[L] (绿色, 粗体)
- 默认范围: 100 格(可配置)
- 适用场景: 角色扮演服务器、生存玩法
? 全局聊天
- 全服可见 - 所有在线玩家接收消息
- 前缀:
[G] (红色, 粗体)
- 始终可用 - 在本地模式下使用
! 前缀强制发送全局消息
- 适用场景: 公告、一般讨论
⚡ 快速全局覆盖
# 在本地模式下:
Hello nearby players → [L] Player: Hello nearby players
! Hello everyone on server → [G] Player: Hello everyone on server
? 聊天格式示例
默认玩家
[L] [Member] Sqrilizz: Hello world!
VIP 玩家
[G] [VIP] ProPlayer: Check out my base!
管理员
[G] [Admin] ServerOwner: Welcome to the server!
?️ 审核功能
词库过滤
- 正则支持 - 高级模式匹配
- 自定义操作 - 屏蔽、替换或警告
- 绕过权限 -
auryxchat.filter.bypass
- 实时更新 - 无需重启即可更改过滤器
反垃圾保护
- 消息相似性 - 检测重复消息
- 速率限制 - 可配置的冷却时间
- 智能检测 - 忽略大小写和间距变化
- 自动警告 - 渐进式惩罚系统
禁言集成
- AuryxCore 同步 - 与 AuryxCore 禁言无缝集成
- 命令阻止 - 防止被禁言玩家使用聊天命令
- 绕过权限 - 工作人员始终可以通信
? 安装与设置
要求
- AuryxCore - 完整功能所需
- Java 21+ - 推荐版本
- Paper 1.8.8+ - 或兼容的服务器平台
安装步骤
- 首先安装 AuryxCore(依赖项)
- 从 Modrinth 下载 AuryxChat
- 将 JAR 文件放入
plugins/ 文件夹
- 重启服务器以生成配置文件
- 在
plugins/AuryxChat/ 中配置设置
可选依赖
- PlaceholderAPI - 增强的占位符支持
- VaultUnlocked - 权限组前缀
- LuckPerms - 高级权限集成
⚙️ 配置亮点
聊天格式 (config.yml)
chat:
formats:
default: "&7[{chat_prefix}] &7[&f%luckperms_prefix%&7] &f<player>: &f<message>"
admin: "&7[{chat_prefix}] &c[Admin]&r <player>: &e<message>"
vip: "&7[{chat_prefix}] &a[VIP]&r <player>: &b<message>"
prefixes:
local: "&a&lL&r" # 绿色 [L]
global: "&c&lG&r" # 红色 [G]
本地聊天设置
local:
enabled: true
radius: 100.0
default-mode: "local"
过滤器配置 (filters.yml)
filters:
enabled: true
action: "block" # block, replace, warn
words:
- "badword"
- "spam.*pattern"
replacement: "***"
? 平台兼容性
| 平台 |
状态 |
功能 |
| Paper |
✅ 完全支持 |
所有功能可用 |
| Folia |
✅ 完全支持 |
线程安全实现 |
| Spigot |
✅ 兼容 |
核心功能正常工作 |
| Bukkit |
✅ 兼容 |
基本功能 |
| Purpur |
✅ 增强 |
额外优化 |
? 集成与 API
AuryxCore 集成
- 玩家数据 - 余额、语言、静音状态
- 经济占位符 -
%auryxcore_balance%
- 权限同步 - 无缝权限处理
PlaceholderAPI 支持
- 内置占位符 -
%auryxchat_mode%, %auryxchat_local_players%
- 外部占位符 - 完整的 PAPI 占位符支持
- 自定义格式 - 在聊天格式中使用任意 PAPI 占位符
开发者 API
// 获取 AuryxChat API
AuryxChatAPI api = AuryxChat.getAPI();
// 聊天模式管理
api.setPlayerChatMode(player, ChatMode.LOCAL);
ChatMode mode = api.getPlayerChatMode(player);
// 发送格式化消息
api.sendLocalMessage(player, "Hello local players!");
api.broadcastAnnouncement("Server announcement!");
? 性能与优化
- ⚡ 异步处理 - 非阻塞聊天操作
- ? 兼容 Folia - 线程安全,适用于现代服务器
- ? 智能缓存 - 高效的格式和数据缓存
- ? 热重载 - 无需重启即可更改配置
- ? 跨版本 - 单个 JAR 支持所有受支持的版本
? AuryxChat - Advanced Chat Management System
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 -
[L] and [G] 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:
[L] (Green, Bold)
- Default Range: 100 blocks (configurable)
- Perfect for: Roleplay servers, survival gameplay
? Global Chat
- Server-wide - All online players receive messages
- Prefix:
[G] (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 → [L] Player: Hello nearby players
! Hello everyone on server → [G] Player: Hello everyone on server
? Chat Format Examples
Default Player
[L] [Member] Sqrilizz: Hello world!
VIP Player
[G] [VIP] ProPlayer: Check out my base!
Admin
[G] [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
- Install AuryxCore first (dependency)
- Download AuryxChat from Modrinth
- Place JAR in your
plugins/ folder
- Restart server to generate configuration
- 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)
chat:
formats:
default: "&7[{chat_prefix}] &7[&f%luckperms_prefix%&7] &f<player>: &f<message>"
admin: "&7[{chat_prefix}] &c[Admin]&r <player>: &e<message>"
vip: "&7[{chat_prefix}] &a[VIP]&r <player>: &b<message>"
prefixes:
local: "&a&lL&r" # Green [L]
global: "&c&lG&r" # Red [G]
Local Chat Settings
local:
enabled: true
radius: 100.0
default-mode: "local"
Filter Configuration (filters.yml)
filters:
enabled: true
action: "block" # block, replace, warn
words:
- "badword"
- "spam.*pattern"
replacement: "***"
? Platform Compatibility
| Platform |
Status |
Features |
| Paper |
✅ Full Support |
All features available |
| Folia |
✅ Full Support |
Thread-safe implementation |
| Spigot |
✅ Compatible |
Core features work |
| Bukkit |
✅ Compatible |
Basic functionality |
| Purpur |
✅ Enhanced |
Additional optimizations |
? Integration & API
AuryxCore Integration
- Player Data - Balance, language, mute status
- Economy Placeholders -
%auryxcore_balance%
- Permission Sync - Seamless permission handling
PlaceholderAPI Support
- Built-in Placeholders -
%auryxchat_mode%, %auryxchat_local_players%
- External Placeholders - Full PAPI placeholder support
- Custom Formats - Use any PAPI placeholder in chat formats
Developer API
// Get AuryxChat API
AuryxChatAPI api = AuryxChat.getAPI();
// Chat mode management
api.setPlayerChatMode(player, ChatMode.LOCAL);
ChatMode mode = api.getPlayerChatMode(player);
// Send formatted messages
api.sendLocalMessage(player, "Hello local players!");
api.broadcastAnnouncement("Server announcement!");
? Performance & Optimization
- ⚡ Async Processing - Non-blocking chat operations
- ? Folia Compatible - Thread-safe for modern servers
- ? Smart Caching - Efficient format and data caching
- ? Hot Reload - Configuration changes without restart
- ? Cross-Version - Single JAR for all supported versions
评论 0
登录后参与评分
还没有评论,来抢沙发吧