UltimateChats

插件

· 作者 geturplugins

一个高级聊天插件,支持聊天组、频道、自定义交互式消息等更多功能……

0 本站下载 0 关注 更新于 9 个月前

最新 1.0.0 · 1.21.11 · Paper

一键开服(送7天)

** ? 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. 高级聊天格式化

视觉定制:

  • MiniMessage 支持:完整的十六进制颜色(FF5555)、渐变、彩虹文本
  • 优先级标签系统:基于权重的标签排序(Admin > Mod > VIP)
    admin:
      permission: "ultimatechat.tag.admin"
      display: "<gradient:ff0000:ff5555>[ADMIN]</gradient>"
      weight: 100
    
  • 前缀与后缀:基于权限的角色指示器
  • 点击动作:可配置的点击事件(建议命令、打开 URL、执行命令)
  • 悬停文本:鼠标悬停在名称上时显示的自定义工具提示
    hover-text:
      text: |
        <gray>Level: {level}</gray>
        <gray>Ping: {ping}ms</gray>
    

占位符:

  • 内置:{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

? 提示与最佳实践

性能优化

  1. 对于拥有 50+ 名玩家的服务器,建议使用 MySQL
  2. 启用缓存:cache-formats: true
  3. 设置合理的好友数量上限
  4. 使用异步数据库操作

配置建议

  1. 从默认配置开始,逐步进行自定义调整
  2. 在部署前测试正则表达式模式
  3. 统一使用颜色代码
  4. 公告间隔时间请保持在 60 秒以上

** Moderation (内容审核)**

  1. 对恶意玩家启用静默禁言 (Shadow mute)
  2. 为管理人员设置命令间谍 (Command spy)
  3. 定期审查 filter.yml 文件
  4. 根据社区情况调整垃圾消息冷却时间

社交功能

  1. 在欢迎消息中推广好友系统
  2. 为每个权限组创建专属的管理员频道
  3. 根据不同权限组设置适当的好友上限
  4. 启用加入/离开通知

Discord 集成

  1. 使用 Webhook 以简化设置
  2. 使用 Bot 实现双向通信
  3. 在 Discord 中设置清晰的频道主题
  4. 正式上线前测试格式显示效果

? 结语

UltimateChat 不仅仅是一个聊天插件——它是 Minecraft 服务器的全套通信解决方案。从基础的聊天格式化到高级的社交系统和 Discord 集成,它提供了打造现代、引人入胜的玩家体验所需的一切。

适合:

  • 希望获得完全控制权的服务器管理员
  • 需要可扩展性的网络服务器
  • 需要社交功能的社区
  • 需要管理工具的 staff 团队
  • 寻求干净、可扩展代码的开发者

由开发者构建,为开发者服务,最终造福玩家。


版本: 1.0.0
最后更新: 2024
支持: geturplugins (discord)

? 自信部署。轻松扩展。风格聊天。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源