** ? UltimateChat - 完整插件概览
? 插件描述
UltimateChat 是一款专为 Minecraft Paper 服务器(1.21+)打造的全面、企业级聊天管理插件。它以 100% 可配置性 为设计理念,无需触碰代码即可对每一项功能进行开关切换、自定义和翻译。该插件基于现代 Java 21、Kyori Adventure 库以及先进的数据库架构构建,提供了从基础聊天格式化到高级社交系统及 Discord 集成的一切所需功能。
⭐ 核心哲学
100% 可配置性
- 每个功能都具备
enabled: true/false 开关
- 所有消息存储在
messages.yml 中,便于翻译
- 所有关键词均可自定义(例如将
[item] 改为 [show] 等)
- 所有格式均使用 MiniMessage 支持十六进制颜色和渐变
- 无硬编码文本或行为
模块化架构
- 55 个独立的 Java 类
- 职责分离清晰(聊天、社交、审核、数据库)
- 易于扩展和定制
- 具有接口和抽象层的专业代码结构
性能优先
- 异步数据库操作(HikariCP 连接池)
- 缓存的消息解析
- 高效的事件处理
- 针对拥有 100+ 名玩家的服务器进行了优化
? 功能分类
1. 高级聊天格式化
视觉定制:
占位符:
- 内置:
{player}、{displayname}、{world}、{x}、{y}、{z}、{health}、{level}、{ping} 等
- PlaceholderAPI 集成(可选)
- 来自配置的自定义占位符
2. 交互式聊天元素
物品链接:
Player: "Check out my sword! [item]"
→ 显示物品及其完整的 NBT、附魔、lore,鼠标悬停可见详情
- 可配置的关键词(默认:
[item])
- 显示物品名称、耐久度、附魔、lore
- 基于权限控制(
ultimatechat.chat.itemlink)
背包显示:
Player: "Here's my inventory [inv]"
→ 鼠标悬停时显示简化的背包内容
- 显示数量最多的前 10 件物品
- 可配置的显示格式
- 也支持
[ender] 用于末影箱
玩家提及:
Player: "@Steve come here!"
→ Steve 收到通知 + 声音提示 + 高亮显示
- 自动检测 @玩家
- 声音通知(可配置类型/音量/音调)
- 可选标题通知
- 点击可私聊
自定义占位符:
pos:
trigger: "[pos]"
replacement: "X: {x}, Y: {y}, Z: {z}"
hover: "<gray>World: {world}</gray>"
3. 社交系统
好友系统
功能:
- 发送/接受/拒绝好友请求
- 好友列表带有在线状态指示器
- 好友聊天(
/fc <message>)——向所有在线好友广播
- 加入/离开通知
- 基于权限的好友数量限制(10/25/50/100/无限)
命令:
/friend add <player> - 发送好友请求
/friend accept <player> - 接受请求
/friend deny <player> - 拒绝请求
/friend remove <player> - 移除好友
/friend list - 查看所有好友(绿色 = 在线)
/friend requests - 查看待处理的请求
/fc <message> - 好友聊天
数据库存储:
- 跨会话持久保存
- 支持 MySQL 或 SQLite
- 高效的索引查询
队伍系统
功能:
- 创建临时队伍群组
- 邀请玩家加入队伍
- 队伍聊天(基于会话)
- 队长控制权(踢人、解散)
- 最大队伍人数可配置
命令:
/party create - 创建队伍
/party invite <player> - 邀请加入队伍
/party accept - 接受邀请
/party leave - 离开队伍
/party kick <player> - 踢出成员(仅限队长)
/party list - 查看成员
忽略/屏蔽系统
功能:
- 完全隐藏被忽略玩家的消息
- 持久化忽略列表
- 在所有频道中生效
命令:
/ignore <player> - 忽略某玩家
/ignore remove <player> - 取消忽略
/ignore list - 查看被忽略的玩家
4. 多频道系统
频道类型:
全局频道:
本地频道:
- 基于半径的近距离聊天(默认:100 格)
- 显示消息范围指示器
- 非常适合角色扮演服务器
工作人员频道:
- 管理员:
ultimatechat.channel.admin
- 版主:
ultimatechat.channel.mod
- 建造者:
ultimatechat.channel.builder
- 工作人员的私密通信
- 记录到控制台
- 加入/离开通知
自定义群组频道:
- 玩家创建的持久化聊天室
- 存储在数据库中
- 仅邀请制或公开
- 群主控制权(重命名、删除、踢人)
命令:
/channel global - 切换到全局频道
/channel local - 切换到本地频道(半径)
/channel admin - 切换到管理员频道(工作人员)
/channel list - 查看可用频道
/group create <name> - 创建自定义群组
/group invite <group> <player>
/group leave <group>
配置:
channels:
local:
radius: 100.0
format: "<gray>[Local]</gray> {player} » {message}"
staff:
admin:
format: "<red>[ADMIN]</red> {player} » {message}"
log-to-console: true
5. 综合审核系统
反垃圾邮件过滤器
功能:
- 可配置的冷却时间(默认:2 秒)
- 重复消息检测
- 违规计数器及相应操作(警告/禁言/踢出)
- 绕过权限:
ultimatechat.bypass.spam
配置:
anti-spam:
enabled: true
cooldown: 2
block-duplicates: true
max-violations: 3
action: WARN or MUTE, KICK
大写过滤系统
功能:
- 百分比阈值(默认:70%)
- 自动转换为小写或阻止消息
- 最小消息长度检查
配置:
anti-caps:
enabled: true
percent: 70
auto-lowercase: true
正则表达式聊天过滤器
功能:
- 黑名单词汇 (
filter.yml)
- 高级正则表达式模式
- 拦截 IP 地址、URL、Discord 邀请链接和电子邮件
- 白名单用于处理误报
- 文本规范化(去除“1337”式拼写)
过滤器示例:
blocked-words:
- "badword"
- "spam"
blocked-patterns:
- "\\b(?:\\d{1,3}\\.){3}\\d{1,3}\\b" IP addresses
- "discord\\.gg/[a-z0-9]+" Discord invites
静默禁言系统
革命性功能:
- 被禁言的玩家能看到自己的消息(以为已发送)
- 其他玩家不会收到该消息
- 比传统禁言更有效
- 支持临时或永久禁言
- 当玩家尝试在聊天中发言时通知工作人员
使用方法:
/shadowmute <player> [duration] [reason]
/unshadowmute <player>
优势:
- 有毒玩家意识不到自己被禁言
- 减少争吵或封禁规避行为
- 工作人员可通过通知进行监控
命令间谍
功能:
- 记录所有玩家命令
- 排除敏感命令(登录、密码等)
- 每个工作人员可单独切换开关
- 控制台日志记录
- 排除工作人员之间的互相监视
命令:
/commandspy - 切换命令间谍模式
查看效果:
[Spy] PlayerName » /tpa Steve
6. Discord 集成
双向通信
Minecraft → Discord (Webhook):
- 快速、轻量级
- 为每位玩家自定义用户名和头像
- 格式化消息
- 服务器事件(加入/退出/死亡)
Discord → Minecraft (JDA Bot):
- 完整的机器人集成
- 读取 Discord 消息
- 转发至 Minecraft 聊天频道
- 根据在线人数更新机器人状态
- 可自定义频道
配置:
discord:
enabled: true
webhook:
enabled: true
url: "https://discord.com/api/webhooks/..."
username: "Minecraft Server"
avatar-url: "https://crafatar.com/avatars/{uuid}"
bot:
enabled: true
token: "YOUR_BOT_TOKEN"
channel-id: "123456789"
format:
minecraft-to-discord: "**{player}**: {message}"
discord-to-minecraft: "<blue>[Discord]</blue> {username} » {message}"
功能:
- 自动更新玩家数量状态
- 服务器事件通知
- Markdown ↔ MiniMessage 格式转换
- 速率限制处理
- 异步处理
7. 自动公告
功能:
- 定时广播(可配置间隔)
- 顺序或随机播放
- 15+ 预配置的公告内容
- MiniMessage 格式化
- 点击和悬停事件
- 基于权限的公告显示
- 声音通知
- 个人公告(首次加入、回归玩家)
示例公告:
- text: "<gold>Welcome to the server!</gold>"
hover: "Click for help"
click-action: "RUN_COMMAND"
click-value: "/help"
- text: "<blue>Join our Discord: discord.gg/server</blue>"
click-action: "OPEN_URL"
click-value: "https://discord.gg/server"
高级功能:
- 定时公告(基于 cron 表达式)
- 条件性公告(根据在线人数、世界等条件)
- 公告分组(不同世界使用不同的公告集)
8. 数据库系统
支持的数据库:
- SQLite(默认,基于文件,无需额外设置)
- MySQL(推荐用于网络环境,性能更优)
HikariCP 连接池:
- 专业级的连接管理
- 可配置连接池大小
- 自动重连
- 针对高负载优化
存储数据:
- 好友关系(双向)
- 屏蔽玩家列表
- 自定义群组及成员
- 玩家设置(键值对存储)
数据表:
uc_friends - 好友关系
uc_ignored - 屏蔽列表
uc_groups - 自定义聊天群组
uc_group_members - 群组成员
uc_player_data - 通用玩家数据
配置:
database:
type: SQLITE or MYSQL
MySQL settings
host: localhost
port: 3306
database: ultimatechat
username: root
password: ""
pool:
maximum-pool-size: 10
minimum-idle: 2
?️ 技术规格
要求
- 服务器: Paper 1.21 - 1.21.1+(不依赖 NMS,使用现代 API)
- Java: 21 (LTS)
- 内存: 至少分配 512 MB
- 可选依赖: PlaceholderAPI, Vault, LuckPerms
依赖项(Shaded)
所有依赖项均包含在最终的 JAR 文件中,并通过重命名空间来防止冲突:
- HikariCP 5.1.0 - 数据库连接池
- SQLite JDBC 3.46.0 - SQLite 驱动
- MySQL Connector 8.4.0 - MySQL 驱动
- JDA 5.0.0 - Discord 机器人 API
- SLF4J 2.0.13 - 日志框架
性能
- 异步操作: 数据库查询、Discord Webhook
- 缓存解析: 预解析的 MiniMessage 组件
- 高效过滤: 编译后的正则表达式模式
- 事件优先级: HIGHEST(用于聊天处理)
- 内存占用: 典型运行时约 50-100 MB
---
? 权限系统
**层级结构**
**管理员权限:**
ultimatechat.admin - 完全访问权限
├── ultimatechat.admin.reload
├── ultimatechat.moderation.*
└── ultimatechat.bypass.*
**聊天功能权限:**
ultimatechat.chat.colors - 使用颜色代码
ultimatechat.chat.formatting - 粗体、斜体等格式
ultimatechat.chat.hex - 十六进制颜色 (FF5555)
ultimatechat.chat.gradients - 渐变文本
ultimatechat.chat.mention - @Player 提及
ultimatechat.chat.itemlink - [item] 关键词链接物品
**社交功能:**
ultimatechat.friend.use
ultimatechat.friend.limit.10 - 最多 10 位好友
ultimatechat.friend.limit.25
ultimatechat.friend.limit.50
ultimatechat.friend.limit.100
ultimatechat.friend.limit.unlimited
ultimatechat.party.use
ultimatechat.ignore.use
ultimatechat.group.use
ultimatechat.group.create
**频道:**
ultimatechat.channel.use
ultimatechat.channel.global
ultimatechat.channel.local
ultimatechat.channel.admin
ultimatechat.channel.mod
ultimatechat.channel.builder
**管理:**
ultimatechat.moderation.notify - 接收通知
ultimatechat.moderation.shadowmute - 阴影禁言玩家
ultimatechat.moderation.commandspy - 指令监视
ultimatechat.bypass.spam
ultimatechat.bypass.caps
ultimatechat.bypass.filter
**标签:**
ultimatechat.tag.vip
ultimatechat.tag.mod
ultimatechat.tag.admin
---
? 使用示例
**示例 1:VIP 聊天**
**配置:**
```yaml
priority-tags:
vip:
permission: "ultimatechat.tag.vip"
display: "<gradient:ffaa00:ffff00>[VIP]</gradient>"
weight: 50
chat-format:
format: "<tags> <white>{player}</white> » <message>"
游戏内:
[VIP] PlayerName » Check out my new sword! [item]
- 鼠标悬停在
[VIP] 上显示等级信息
- 鼠标悬停在
PlayerName 上显示统计数据
- 鼠标悬停在
[item] 上显示包含附魔的完整剑详情
示例 2:员工沟通
场景: 管理员希望与版主讨论管理工作
/channel mod
Admin » We have a griefer in sector 7
Mod1 » On it, checking now
Mod2 » I see them, taking action
- 只有拥有
ultimatechat.channel.mod 权限的员工能看到此内容
- 记录到控制台日志以备查
- 不同频道使用不同的颜色编码
示例 3:好友群组
玩家想要私密聊天:
/friend add Steve
/friend add Alex
Steve: "Hey guys, want to raid a dungeon?"
Alex: "Sure! Where?"
You: "Meet at spawn"
/fc Let's form a party!
→ All online friends receive the message
示例 4:本地角色扮演
基于半径的沉浸式聊天:
/channel local
[Local] Knight » "Ho there, traveler!"
[Local] Merchant » "Good morrow! Care to trade?"
(Only players within 100 blocks see these messages)
示例 5:Discord 集成
无缝跨平台:
Minecraft:
Player: "Server is awesome today!"
→ Sent to Discord channel
Discord:
DiscordUser: "Can someone help me with a quest?"
→ [Discord] DiscordUser » Can someone help me with a quest?
(Shows in Minecraft)
? 配置亮点
快速设置
1. 基础聊天格式:
chat-format:
enabled: true
format: "<tags> {player} » {message}"
2. 启用功能:
friends:
enabled: true
parties:
enabled: true
channels:
enabled: true
3. 配置管理:
moderation:
anti-spam:
enabled: true
cooldown: 2
anti-caps:
enabled: true
percent: 70
auto-lowercase: true
filter:
enabled: true
4. Discord 设置:
discord:
enabled: true
webhook:
enabled: true
url: "YOUR_WEBHOOK_URL"
bot:
enabled: true
token: "YOUR_BOT_TOKEN"
channel-id: "CHANNEL_ID"
高级自定义
自定义频道:
channels:
roleplay:
enabled: true
display-name: "Roleplay"
permission: "server.roleplay"
format: "<green>[RP]</green> {player} » {message}"
color: "55FF55"
自定义标签:
priority-tags:
sponsor:
permission: "server.sponsor"
display: "<rainbow>[SPONSOR]</rainbow>"
weight: 75
自定义占位符:
custom-placeholders:
definitions:
coords:
trigger: "[coords]"
replacement: "Location: {x}, {y}, {z}"
hover: "<gray>World: {world}</gray>"
? 应用场景
1. 生存服务器
- 好友系统用于社区建设
- 本地聊天用于基于距离的通信
- 通过聊天记录和指令监视防止破坏行为
- Discord 集成实现 24/7 全天候沟通
2. 角色扮演服务器
- 本地频道用于沉浸式的近距离聊天
- 为不同区域/阵营设置自定义频道
- 员工频道用于管理员协调
- 丰富的格式用于角色名称展示
3. 小游戏服务器
- 组队系统用于团队协调
- 快速公告活动
- 全局聊天用于全服通信
- 好友系统以便与朋友一起游玩
4. 网络服务器
- MySQL 数据库用于跨服务器数据同步
- Discord 集成用于网络聊天
- 集中式管理工具
- 跨服务器的员工频道
5. 创造服务器
- 建造者频道用于建造者之间的交流
- 通过物品链接展示建筑作品
- 好友系统用于协作
- 在建造区域使用本地聊天
? 独特卖点
1. 真正的 100% 可配置性
与其他聊天插件不同,每一个方面都是可配置的:
- 更改任何消息文本
- 编辑任何关键词(将
[item] 改为 [show])
- 切换任何功能
- 自定义任何格式
- 调整任何限制
2. 阴影禁言技术
首个实现心理管理技术的 Minecraft 插件:
- 被禁言的玩家不知道自己被禁言了
- 防止封禁规避
- 减少纠纷
- 比传统的禁言更有效
3. 企业级数据库架构
专业级的数据处理:
- HikariCP 连接池
- 异步操作
- SQL 注入防护
- 自动迁移支持
- 带索引的优化查询
4. 现代技术栈
采用最新技术构建:
- Java 21(最新长期支持版)
- Paper API 1.21(无 NMS,无版本依赖)
- Kyori Adventure(原生组件系统)
- Maven shade 重定位(无冲突)
5. 全面的社交套件
一站式解决方案:
- 好友、组队、群组、屏蔽
- 其他插件能做的它都能做,且集中在一个地方
- 统一的权限系统
- 一致的 UI/UX
6. 生产就绪
并非概念验证:
- 全面的错误处理
- 详细的日志记录
- 配置验证
- 迁移支持
- 性能优化
? 命令参考
主要命令
/ultimatechat reload - 重载所有配置
/ultimatechat version - 显示插件版本
/ultimatechat help - 显示帮助菜单
好友命令
/friend add <player> - 发送好友请求
/friend remove <player> - 移除好友
/friend accept <player> - 接受请求
/friend deny <player> - 拒绝请求
/friend list - 查看好友(✓ 在线)
/friend requests - 查看待处理请求
/fc <message> - 好友私聊
队伍命令
/party create - 创建队伍
/party invite <player> - 邀请加入队伍
/party accept - 接受邀请
/party decline - 拒绝邀请
/party leave - 离开队伍
/party kick <player> - 踢出成员
/party list - 查看成员列表
屏蔽命令
/ignore <player> - 屏蔽玩家
/ignore remove <player> - 取消屏蔽
/ignore list - 查看已屏蔽玩家列表
频道命令
/channel global - 切换到全局频道
/channel local - 切换到本地频道
/channel admin - 切换到管理频道
/channel list - 查看可用频道列表
/channel info - 当前频道信息
群组命令
/group create <name> - 创建群组
/group delete <name> - 删除群组(需为所有者)
/group invite <group> <player> - 邀请加入群组
/group accept <group> - 接受入群邀请
/group leave <group> - 退出群组
/group list - 查看你的群组
? 与其他插件对比
| 功能 |
UltimateChat |
EssentialsX Chat |
VentureChat |
ChatControl |
| MiniMessage 支持 |
✅ 完整支持 |
❌ |
⚠️ 有限支持 |
❌ |
| 好友系统 |
✅ 数据库存储 |
❌ |
❌ |
❌ |
| 队伍系统 |
✅ 完整支持 |
❌ |
⚠️ 基础功能 |
❌ |
| 多频道 |
✅ 4+ 种类型 |
⚠️ 基础功能 |
✅ 支持 |
⚠️ 基础功能 |
| Discord 集成 |
✅ 双向通信 |
❌ |
⚠️ 单向通信 |
⚠️ 单向通信 |
| 静默禁言 (Shadow Mute) |
✅ 独特功能 |
❌ |
❌ |
❌ |
| 命令间谍 (Command Spy) |
✅ 原生支持 |
⚠️ 通过 Essentials 实现 |
❌ |
✅ 支持 |
| 物品链接 |
✅ NBT 支持 |
❌ |
⚠️ 基础功能 |
❌ |
| 数据库 |
✅ MySQL/SQLite |
❌ |
⚠️ 仅支持 MySQL |
❌ |
| 100% 可配置 |
✅ 所有选项 |
⚠️ 大部分选项 |
⚠️ 大部分选项 |
⚠️ 大部分选项 |
| 现代 API |
✅ Paper 1.21 |
⚠️ Spigot |
⚠️ Spigot |
⚠️ Spigot |
? 提示与最佳实践
性能优化
- 对于拥有 50+ 名玩家的服务器,建议使用 MySQL
- 启用缓存:
cache-formats: true
- 设置合理的好友数量上限
- 使用异步数据库操作
配置建议
- 从默认配置开始,逐步进行自定义调整
- 在部署前测试正则表达式模式
- 统一使用颜色代码
- 公告间隔时间请保持在 60 秒以上
** Moderation (内容审核)**
- 对恶意玩家启用静默禁言 (Shadow mute)
- 为管理人员设置命令间谍 (Command spy)
- 定期审查 filter.yml 文件
- 根据社区情况调整垃圾消息冷却时间
社交功能
- 在欢迎消息中推广好友系统
- 为每个权限组创建专属的管理员频道
- 根据不同权限组设置适当的好友上限
- 启用加入/离开通知
Discord 集成
- 使用 Webhook 以简化设置
- 使用 Bot 实现双向通信
- 在 Discord 中设置清晰的频道主题
- 正式上线前测试格式显示效果
? 结语
UltimateChat 不仅仅是一个聊天插件——它是 Minecraft 服务器的全套通信解决方案。从基础的聊天格式化到高级的社交系统和 Discord 集成,它提供了打造现代、引人入胜的玩家体验所需的一切。
适合:
- 希望获得完全控制权的服务器管理员
- 需要可扩展性的网络服务器
- 需要社交功能的社区
- 需要管理工具的 staff 团队
- 寻求干净、可扩展代码的开发者
由开发者构建,为开发者服务,最终造福玩家。
版本: 1.0.0
最后更新: 2024
支持: geturplugins (discord)
? 自信部署。轻松扩展。风格聊天。
** ? 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
[item] to [show], 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:
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! [item]"
→ Displays item with full NBT, enchantments, lore on hover
- Configurable keyword (default:
[item])
- Shows item name, durability, enchantments, lore
- Permission-based (
ultimatechat.chat.itemlink)
Inventory Display:
Player: "Here's my inventory [inv]"
→ Shows summarized inventory on hover
- Top 10 items with quantities
- Configurable display format
- Also supports
[ender] 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:
pos:
trigger: "[pos]"
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 for staff
- Logged to console
- Join/leave notifications
Custom Group Channels:
- Player-created persistent chat rooms
- Stored in database
- Invite-only or public
- Owner controls (rename, delete, kick)
Commands:
/channel global - Switch to global
/channel local - Switch to local (radius)
/channel admin - Switch to admin (staff)
/channel list - View available channels
/group create <name> - Create custom group
/group invite <group> <player>
/group leave <group>
Configuration:
channels:
local:
radius: 100.0
format: "<gray>[Local]</gray> {player} » {message}"
staff:
admin:
format: "<red>[ADMIN]</red> {player} » {message}"
log-to-console: true
5. Comprehensive Moderation
Anti-Spam Filter
Features:
- Configurable cooldown (default: 2 seconds)
- Duplicate message detection
- Violation counter with actions (WARN/MUTE/KICK)
- Bypass permission:
ultimatechat.bypass.spam
Configuration:
anti-spam:
enabled: true
cooldown: 2
block-duplicates: true
max-violations: 3
action: WARN or MUTE, KICK
Anti-Caps Filter
Features:
- Percentage threshold (default: 70%)
- Auto-lowercase or block messages
- Minimum message length check
Configuration:
anti-caps:
enabled: true
percent: 70
auto-lowercase: true
Regex Chat Filter
Features:
- Word blacklist (
filter.yml)
- Advanced regex patterns
- Blocks IPs, URLs, Discord invites, emails
- Whitelist for false positives
- Normalization (removes l33t speak)
Filter Examples:
blocked-words:
- "badword"
- "spam"
blocked-patterns:
- "\\b(?:\\d{1,3}\\.){3}\\d{1,3}\\b" IP addresses
- "discord\\.gg/[a-z0-9]+" Discord invites
Shadow Mute System
Revolutionary Feature:
- Muted players see their own messages (think it was sent)
- Other players don't receive the message
- More effective than traditional mutes
- Temporary or permanent
- Notify staff on chat attempts
Usage:
/shadowmute <player> [duration] [reason]
/unshadowmute <player>
Benefits:
- Toxic players don't realize they're muted
- No drama or ban evasion attempts
- Staff notifications for monitoring
Command Spy
Features:
- Log all player commands
- Exclude sensitive commands (login, password)
- Toggle per staff member
- Console logging
- Exclude staff from being spied on
Commands:
/commandspy - Toggle command spy
View:
[Spy] PlayerName » /tpa Steve
6. Discord Integration
Two-Way Communication
Minecraft → Discord (Webhook):
- Fast, lightweight
- Custom username and avatar per player
- Formatted messages
- Server events (join/quit/death)
Discord → Minecraft (JDA Bot):
- Full bot integration
- Read Discord messages
- Send to Minecraft chat
- Update bot status with player count
- Customizable channel
Configuration:
discord:
enabled: true
webhook:
enabled: true
url: "https://discord.com/api/webhooks/..."
username: "Minecraft Server"
avatar-url: "https://crafatar.com/avatars/{uuid}"
bot:
enabled: true
token: "YOUR_BOT_TOKEN"
channel-id: "123456789"
format:
minecraft-to-discord: "**{player}**: {message}"
discord-to-minecraft: "<blue>[Discord]</blue> {username} » {message}"
Features:
- Automatic player count status updates
- Server event notifications
- Markdown ↔ MiniMessage conversion
- Rate limit handling
- Async processing
7. Auto-Announcements
Features:
- Timed broadcasts (configurable interval)
- Sequential or random order
- 15+ pre-configured announcements
- MiniMessage formatting
- Click and hover events
- Permission-based announcements
- Sound notifications
- Personal announcements (first join, returning player)
Example Announcements:
- text: "<gold>Welcome to the server!</gold>"
hover: "Click for help"
click-action: "RUN_COMMAND"
click-value: "/help"
- text: "<blue>Join our Discord: discord.gg/server</blue>"
click-action: "OPEN_URL"
click-value: "https://discord.gg/server"
Advanced Features:
- Timed announcements (cron-based)
- Conditional announcements (player count, world)
- Announcement groups (different sets per world)
8. Database System
Supported Databases:
- SQLite (default, file-based, no setup required)
- MySQL (recommended for networks, better performance)
HikariCP Connection Pooling:
- Professional-grade connection management
- Configurable pool size
- Automatic reconnection
- Optimized for high load
Stored Data:
- Friend relationships (bidirectional)
- Ignored players
- Custom groups and members
- Player settings (key-value storage)
Tables:
uc_friends - Friend relationships
uc_ignored - Ignore list
uc_groups - Custom chat groups
uc_group_members - Group membership
uc_player_data - Generic player data
Configuration:
database:
type: SQLITE or MYSQL
MySQL settings
host: localhost
port: 3306
database: ultimatechat
username: root
password: ""
pool:
maximum-pool-size: 10
minimum-idle: 2
?️ Technical Specifications
Requirements
- Server: Paper 1.21 - 1.21.1+ (No NMS, uses modern API)
- Java: 21 (LTS)
- RAM: Minimum 512 MB allocated
- Optional: PlaceholderAPI, Vault, LuckPerms
Dependencies (Shaded)
All dependencies are included in the final JAR with relocation to prevent conflicts:
- HikariCP 5.1.0 - Database connection pooling
- SQLite JDBC 3.46.0 - SQLite driver
- MySQL Connector 8.4.0 - MySQL driver
- JDA 5.0.0 - Discord bot API
- SLF4J 2.0.13 - Logging framework
Performance
- Async Operations: Database queries, Discord webhooks
- Cached Parsing: Pre-parsed MiniMessage components
- Efficient Filtering: Compiled regex patterns
- Event Priority: HIGHEST for chat processing
- Memory Usage: ~50-100 MB typical runtime
---
? Permission System
**Hierarchical Structure**
**Admin Permissions:**
ultimatechat.admin - Full access
├── ultimatechat.admin.reload
├── ultimatechat.moderation.*
└── ultimatechat.bypass.*
**Chat Features:**
ultimatechat.chat.colors - Use color codes
ultimatechat.chat.formatting - Bold, italic, etc.
ultimatechat.chat.hex - Hex colors (FF5555)
ultimatechat.chat.gradients - Gradient text
ultimatechat.chat.mention - @Player mentions
ultimatechat.chat.itemlink - [item] keyword
**Social Features:**
ultimatechat.friend.use
ultimatechat.friend.limit.10 - Max 10 friends
ultimatechat.friend.limit.25
ultimatechat.friend.limit.50
ultimatechat.friend.limit.100
ultimatechat.friend.limit.unlimited
ultimatechat.party.use
ultimatechat.ignore.use
ultimatechat.group.use
ultimatechat.group.create
**Channels:**
ultimatechat.channel.use
ultimatechat.channel.global
ultimatechat.channel.local
ultimatechat.channel.admin
ultimatechat.channel.mod
ultimatechat.channel.builder
**Moderation:**
ultimatechat.moderation.notify - Receive notifications
ultimatechat.moderation.shadowmute - Shadow mute players
ultimatechat.moderation.commandspy - Command spy
ultimatechat.bypass.spam
ultimatechat.bypass.caps
ultimatechat.bypass.filter
**Tags:**
ultimatechat.tag.vip
ultimatechat.tag.mod
ultimatechat.tag.admin
---
? Usage Examples
**Example 1: VIP Chat**
**Configuration:**
```yaml
priority-tags:
vip:
permission: "ultimatechat.tag.vip"
display: "<gradient:ffaa00:ffff00>[VIP]</gradient>"
weight: 50
chat-format:
format: "<tags> <white>{player}</white> » <message>"
In-Game:
[VIP] PlayerName » Check out my new sword! [item]
- Hover over
[VIP] shows rank info
- Hover over
PlayerName shows stats
- Hover over
[item] shows full sword details with enchantments
Example 2: Staff Communication
Scenario: Admin wants to discuss moderation with moderators
/channel mod
Admin » We have a griefer in sector 7
Mod1 » On it, checking now
Mod2 » I see them, taking action
- Only staff with
ultimatechat.channel.mod see this
- Logged to console for records
- Different color coding per channel
Example 3: Friend Group
Players want private chat:
/friend add Steve
/friend add Alex
Steve: "Hey guys, want to raid a dungeon?"
Alex: "Sure! Where?"
You: "Meet at spawn"
/fc Let's form a party!
→ All online friends receive the message
Example 4: Local Roleplay
Radius-based immersive chat:
/channel local
[Local] Knight » "Ho there, traveler!"
[Local] Merchant » "Good morrow! Care to trade?"
(Only players within 100 blocks see these messages)
Example 5: Discord Integration
Seamless cross-platform:
Minecraft:
Player: "Server is awesome today!"
→ Sent to Discord channel
Discord:
DiscordUser: "Can someone help me with a quest?"
→ [Discord] DiscordUser » Can someone help me with a quest?
(Shows in Minecraft)
? Configuration Highlights
Quick Setup
1. Basic Chat Format:
chat-format:
enabled: true
format: "<tags> {player} » {message}"
2. Enable Features:
friends:
enabled: true
parties:
enabled: true
channels:
enabled: true
3. Configure Moderation:
moderation:
anti-spam:
enabled: true
cooldown: 2
anti-caps:
enabled: true
percent: 70
auto-lowercase: true
filter:
enabled: true
4. Discord Setup:
discord:
enabled: true
webhook:
enabled: true
url: "YOUR_WEBHOOK_URL"
bot:
enabled: true
token: "YOUR_BOT_TOKEN"
channel-id: "CHANNEL_ID"
Advanced Customization
Custom Channel:
channels:
roleplay:
enabled: true
display-name: "Roleplay"
permission: "server.roleplay"
format: "<green>[RP]</green> {player} » {message}"
color: "55FF55"
Custom Tag:
priority-tags:
sponsor:
permission: "server.sponsor"
display: "<rainbow>[SPONSOR]</rainbow>"
weight: 75
Custom Placeholder:
custom-placeholders:
definitions:
coords:
trigger: "[coords]"
replacement: "Location: {x}, {y}, {z}"
hover: "<gray>World: {world}</gray>"
? Use Cases
1. Survival Servers
- Friends system for community building
- Local chat for proximity-based communication
- Anti-grief through chat logging and command spy
- Discord integration for 24/7 communication
2. Roleplay Servers
- Local channel for immersive proximity chat
- Custom channels for different zones/factions
- Staff channels for admin coordination
- Rich formatting for character names
3. Minigame Servers
- Party system for team coordination
- Quick announcements for events
- Global chat for server-wide communication
- Friend system to play with buddies
4. Network Servers
- MySQL database for cross-server data
- Discord integration for network chat
- Centralized moderation tools
- Staff channels across servers
5. Creative Servers
- Builder channel for builder communication
- Show off builds with item linking
- Friend system for collaboration
- Local chat in build zones
? Unique Selling Points
1. True 100% Configurability
Unlike other chat plugins, every single aspect is configurable:
- Change ANY message text
- Edit ANY keyword (
[item] to [show])
- Toggle ANY feature
- Customize ANY format
- Adjust ANY limit
2. Shadow Mute Technology
First Minecraft plugin to implement psychological moderation:
- Muted players don't know they're muted
- Prevents ban evasion
- Reduces drama
- More effective than traditional mutes
3. Enterprise Database Architecture
Professional-grade data handling:
- HikariCP connection pooling
- Async operations
- SQL injection prevention
- Automatic migration support
- Optimized queries with indexes
4. Modern Tech Stack
Built with latest technology:
- Java 21 (latest LTS)
- Paper API 1.21 (no NMS, no version dependence)
- Kyori Adventure (native component system)
- Maven shade with relocation (no conflicts)
5. Comprehensive Social Suite
All-in-one solution:
- Friends, Parties, Groups, Ignore
- Everything other plugins do, in one place
- Unified permission system
- Consistent UI/UX
6. Production-Ready
Not a proof-of-concept:
- Error handling everywhere
- Extensive logging
- Config validation
- Migration support
- Performance optimized
? Commands Reference
Main Commands
/ultimatechat reload - Reload all configurations
/ultimatechat version - Show plugin version
/ultimatechat help - Show help menu
Friend Commands
/friend add <player> - Send friend request
/friend remove <player> - Remove friend
/friend accept <player> - Accept request
/friend deny <player> - Deny request
/friend list - View friends (✓ online)
/friend requests - View pending requests
/fc <message> - Friend chat
Party Commands
/party create - Create party
/party invite <player> - Invite to party
/party accept - Accept invite
/party decline - Decline invite
/party leave - Leave party
/party kick <player> - Kick member
/party list - View members
Ignore Commands
/ignore <player> - Ignore player
/ignore remove <player> - Unignore
/ignore list - View ignored players
Channel Commands
/channel global - Switch to global
/channel local - Switch to local
/channel admin - Switch to admin
/channel list - View available channels
/channel info - Current channel info
Group Commands
/group create <name> - Create group
/group delete <name> - Delete group (owner)
/group invite <group> <player> - Invite
/group accept <group> - Accept invite
/group leave <group> - Leave group
/group list - View your groups
? Comparison with Other Plugins
| Feature |
UltimateChat |
EssentialsX Chat |
VentureChat |
ChatControl |
| MiniMessage Support |
✅ Full |
❌ |
⚠️ Limited |
❌ |
| Friend System |
✅ Database |
❌ |
❌ |
❌ |
| Party System |
✅ |
❌ |
⚠️ Basic |
❌ |
| Multi-Channel |
✅ 4+ types |
⚠️ Basic |
✅ |
⚠️ Basic |
| Discord Integration |
✅ 2-way |
❌ |
⚠️ 1-way |
⚠️ 1-way |
| Shadow Mute |
✅ Unique |
❌ |
❌ |
❌ |
| Command Spy |
✅ |
⚠️ Via Essentials |
❌ |
✅ |
| Item Linking |
✅ NBT Support |
❌ |
⚠️ Basic |
❌ |
| Database |
✅ MySQL/SQLite |
❌ |
⚠️ MySQL only |
❌ |
| 100% Configurable |
✅ Everything |
⚠️ Most |
⚠️ Most |
⚠️ Most |
| Modern API |
✅ Paper 1.21 |
⚠️ Spigot |
⚠️ Spigot |
⚠️ Spigot |
? Tips & Best Practices
Performance
- Use MySQL for servers with 50+ players
- Enable caching:
cache-formats: true
- Set reasonable friend limits
- Use async database operations
Configuration
- Start with defaults, customize gradually
- Test regex patterns before deployment
- Use color codes consistently
- Keep announcement interval > 60 seconds
Moderation
- Enable shadow mute for toxic players
- Set up command spy for staff
- Regularly review filter.yml
- Adjust spam cooldowns based on community
Social Features
- Promote friend system in welcome message
- Create staff channels for each rank
- Set appropriate friend limits per rank
- Enable join/quit notifications
Discord
- Use webhooks for simplicity
- Use bot for 2-way communication
- Set clear channel topic in Discord
- Test formatting before going live
? Conclusion
UltimateChat is not just a chat plugin—it's a complete communication suite for Minecraft servers. From basic chat formatting to advanced social systems and Discord integration, it provides everything needed for a modern, engaging player experience.
Perfect for:
- Server owners who want full control
- Networks requiring scalability
- Communities needing social features
- Staff teams requiring moderation tools
- Developers seeking clean, extensible code
Built by developers, for developers, serving players.
Version: 1.0.0
Last Updated: 2024
Support: geturplugins (discord)
? Deploy with confidence. Scale with ease. Chat with style.**
评论 0
登录后参与评分
还没有评论,来抢沙发吧