ZealousChat

插件

· 作者 bruhmoment69

一款功能强大的迷你消息插件,用于聊天格式化和更多用途。

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

最新 1.2.6 · 1.21.11 · Folia / Paper

一键开服(送7天)

ZealousChat

一款为 Paper 和 Spigot 服务器打造的、基于 MiniMessage 的现代聊天格式化插件

技术介绍

ZealousChat 利用 Paper 的高性能 AsyncChatEvent 和 MiniMessage 组件,构建了一个完全可配置的聊天系统来替换原版聊天。它自带按权限组/世界划分的特定格式、私聊功能、物品栏占位符以及细粒度的权限模型——同时保持轻量级且适用于生产环境。


功能特性

  • 全链路 MiniMessage 支持 – 渐变、十六进制颜色、悬停/点击事件
  • 基于权限组、世界及权限的格式,具备优先级系统
  • 私聊功能(/msg, /reply),支持社交间谍模式与冷却时间
  • 跨服私聊(可选,需连接 MySQL),适用于运行多个服务器的网络集群
  • 聊天/消息开关,支持玩家个人设置或服务器全局设置(管理员可绕过)
  • 物品栏占位符 [inv], [ender], [armor], [hand], [pos], [health]
  • URL 自动链接 & @提及(可配置)
  • 高级脏话过滤器,支持正则表达式和模糊匹配,并具备分级惩罚机制
  • 基于数据库的违规记录追踪,采用缓存以提升性能
  • PlaceholderAPI 桥接(可选软依赖)
  • 热重载插件配置(/zchat reload)
  • 自定义消息:可修改插件内使用的所有提示信息。

ZealousChat 是一款高性能的 1.20.4+ 聊天格式化插件,使用可配置的基于 MiniMessage 的聊天格式来格式化聊天消息。ZealousChat 包含了其他插件往往缺失的许多额外功能,例如在聊天中发送只读的你的物品栏/主手/护甲/末影箱视图、格式化的 /msg 和 /reply 命令、消息上的点击/悬停效果、@提及等。

ZealousChat 还具备针对服务器网络的特殊功能,如跨服私聊和跨服聊天频道(用于 staffchat 等)。

ZealousChat 使用 Paper API 实现其所有功能,并设计为尽可能高效。

展示图片

命令

插件核心

  • /zealouschat (/chatplugin, /zchat) — ZealousChat 的基础命令
    • 权限: zchat.admin
    • 此命令并非实际执行操作的命令,而是所有子命令的基础。

配置命令

  • /zealouschat reload — 重载插件配置
    • 权限: zchat.admin.reload
  • /zealouschat info — 显示当前插件设置及启用的功能
    • 权限: zchat.admin.info
  • /zealouschat test <message> — 预览聊天格式化效果
    • 权限: zchat.admin.test
    • 参数:
      • <message>: 需要格式化并显示的文本

格式管理

  • /zealouschat format set default <format> — 设置默认聊天格式
    • 权限: zchat.admin.format
    • 参数:
      • <format>: MiniMessage 格式字符串
  • /zealouschat format set group <group> <format> — 定义特定权限组的格式
    • 权限: zchat.admin.format
    • 参数:
      • <group>: 权限组名称
      • <format>: MiniMessage 格式字符串
  • /zealouschat format set world <world> <format> — 定义特定世界的格式
    • 权限: zchat.admin.format
    • 参数:
      • <world>: 世界名称
      • <format>: MiniMessage 格式字符串
  • /zealouschat format list — 列出所有当前的聊天格式
    • 权限: zchat.admin.format

功能开关

  • /zealouschat toggle colors — 启用/禁用聊天中的颜色代码
    • 权限: zchat.admin.toggle
  • /zealouschat toggle formatting — 启用/禁用文本格式化
    • 权限: zchat.admin.toggle
  • /zealouschat toggle mentions — 启用/禁用玩家 @提及
    • 权限: zchat.admin.toggle
  • /zealouschat toggle cooldown — 启用/禁用聊天冷却
    • 权限: zchat.admin.toggle

私聊

  • /msg <player> <message> — 发送私聊消息(别名: /message, /tell, /whisper, /w)
    • 权限: zchat.message
    • 参数:
      • <player>: 接收者玩家名称
      • <message>: 消息内容
  • /reply <message> — 回复上一条私聊消息的发件人(别名: /r, /respond)
    • 权限: zchat.message
    • 参数:
      • <message>: 回复内容

跨服私聊

当你在 storage.conf 中启用跨服消息功能时(需要 MySQL 或 Redis 数据库),ZealousChat 可以在同一网络下的多个 Paper 服务器之间传递私聊消息。

  • 当目标玩家在另一个服务器上在线时,/msg 将尝试进行跨服投递
  • /reply 也支持跨服目标
  • 已关闭私聊功能的接收者不会收到跨服消息

聊天与社交间谍开关

  • /zealouschat toggle chat — 切换公开聊天的开启/关闭状态
    • 权限: zchat.toggle.chat
  • /zealouschat toggle messages — 切换私聊的开启/关闭状态
    • 权限: zchat.toggle.messages
  • /zealouschat toggle socialspy — 启用/禁用私聊的社交间谍模式
    • 权限: zchat.socialspy
  • /zealouschat alerts — 切换提示音/提醒的开启/关闭状态
    • 权限: zchat.alerts.toggle
  • /zealouschat toggle status — 查看你当前的聊天和私聊状态
    • 权限: zchat.status

频道命令

  • /channel list — 列出所有可用频道
    • 权限:zchat.channel.use.list
  • /channel join <channel> — 加入一个频道
    • 权限:zchat.channel.use.join
    • 参数:
      • <channel>:频道名称
  • /channel leave <channel> — 离开一个频道
    • 权限:zchat.channel.use.leave
    • 参数:
      • <channel>:频道名称
  • /channel focus <channel> — 将某个频道设置为活动频道(默认消息发送到的位置)
    • 权限:zchat.channel.use.focus
    • 参数:
      • <channel>:频道名称
  • /channel who <channel> — 列出频道中的成员
    • 权限:zchat.channel.use.who
    • 参数:
      • <channel>:频道名称

脏话过滤系统

脏话过滤系统提供高级的不当用语检测功能,支持可配置的惩罚层级、数据库持久化存储,以及为受信任的管理员提供的绕过权限。 该系统目前处于实验阶段。可能会出现(主要是轻微的)问题。请报告您发现的任何错误。

过滤类型

正则表达式匹配

  • 使用正则表达式进行精确的模式匹配
  • 默认不区分大小写(例如 (?i)badword)
  • 支持复杂模式和词边界
  • 自动缓存编译后的模式以提升性能

莱文斯坦距离匹配

  • 基于字符间距离的模糊匹配
  • 可配置的距离阈值(默认:2-3个字符)
  • 检测过滤词的拼写错误和变体
  • 将消息拆分为单个单词进行比较

惩罚系统

  • 违规追踪:每个过滤组独立追踪违规行为
  • 分级惩罚:将违规次数映射到命令列表
  • 命令占位符:使用 {player} 表示违规玩家的名称
  • 控制台执行:所有惩罚命令均作为控制台命令运行
  • 数据库持久化:违规计数在服务器重启后保持不变

性能特性

  • 缓存:在线玩家的违规信息缓存在内存中以便即时访问
  • 异步处理:违规处理在异步线程中运行,以防止聊天延迟
  • 数据库优化:通过适当的索引实现高效查询
  • 正则缓存:编译后的模式被缓存以避免重新编译

管理员控制

  • /zealouschat admin clear <type> — 清除各种与聊天相关的数据
    • 权限:zchat.admin.clear
    • 参数:
      • <type>:以下之一:toggles(重置所有聊天开关)、socialspy(重置所有社交间谍状态)、cooldowns(清除消息冷却时间)、blocks(清除所有屏蔽列表)、alerts(清除所有警报状态)或 all(清除所有数据)
  • /zealouschat admin gtoggle <type> — 切换全局聊天功能(别名:/gtoggle, /chatplugin admin gtoggle, /zealouschat admin gtoggle, /zchat admin gtoggle)
    • 权限:zchat.admin.gtoggle
    • 参数:
      • <type>:以下之一:chat、privatemessages、both、all
  • /zealouschat admin toggle chat <player> <true|false> — 强制切换玩家的公共聊天功能
    • 权限:zchat.admin.toggle.chat
    • 参数:
      • <player>:目标玩家名称
      • <true|false>:启用或禁用聊天
  • /zealouschat admin toggle messages <player> <true|false> — 强制切换玩家的私人消息功能
    • 权限:zchat.admin.toggle.messages
    • 参数:
      • <player>:目标玩家名称
      • <true|false>:启用或禁用私人消息
  • /zealouschat admin toggle all <player> <true|false> — 强制同时切换玩家的聊天和私人消息功能
    • 权限:zchat.admin.toggle.all
    • 参数:
      • <player>:目标玩家名称
      • <true|false>:启用或禁用两者
  • /zealouschat admin socialspy <player> <true|false> — 强制切换玩家的社交间谍功能
    • 权限:zchat.admin.socialspy
    • 参数:
      • <player>:目标玩家名称
      • <true|false>:启用或禁用社交间谍
  • /zealouschat admin stats — 显示全服务器的聊天和私人消息开关统计信息
    • 权限:zchat.admin.stats
  • /zealouschat admin alerts <player> <true|false> — 强制切换玩家的警报功能
    • 权限:zchat.admin.alerts
    • 参数:
      • <player>:目标玩家名称
      • <true|false>:启用或禁用警报
  • /zealouschat admin block <player> <target> — 强制一名玩家屏蔽另一名玩家
    • 权限:zchat.admin.block
    • 参数:
      • <player>:执行屏蔽操作的玩家
      • <target>:被屏蔽的玩家
  • /zealouschat admin unblock <player> <target> — 强制一名玩家解除对另一名玩家的屏蔽
    • 权限:zchat.admin.block
    • 参数:
      • <player>:执行解除屏蔽操作的玩家
      • <target>:被解除屏蔽的玩家
  • /zealouschat admin clearblocks <player> — 清除某玩家的所有屏蔽设置
    • 权限:zchat.admin.block
    • 参数:
      • <player>:其屏蔽列表将被清除的玩家

快速入门

  1. 将构建好的 jar 文件放入 plugins/ 目录并重启服务器。
  2. 编辑 plugins/ZealousChat/config.conf —— 更改可通过 /zealouschat reload 重新加载。
  3. (可选)在 plugins/ZealousChat/database.conf 中配置数据库设置,并在 plugins/ZealousChat/messages.conf 中配置消息。
  4. 授予玩家格式权限(如 zchat.format.vip)或允许使用颜色代码(zchat.color)。
  5. 在聊天消息中发送 [inv]、[hand]、[ender]、[health] 和 [pos] 以显示物品栏信息。

占位符

所有聊天、私信和配置字符串均支持 MiniMessage 格式,并且在安装插件时支持任何 PlaceholderAPI 标签。

支持版本 / 依赖项

  • PaperMC / Spigot 1.20+(可能在旧版本上也能运行,未经测试)
  • Java 17+
  • (可选)PlaceholderAPI 用于外部占位符

权限

点击查看权限节点
节点 默认值 描述
zchat.* op 授予所有权限
zchat.admin op 访问根/管理员命令
zchat.admin.reload op 重新加载配置
zchat.admin.info op 查看插件信息
zchat.admin.test op 测试格式化
zchat.admin.format op 管理聊天格式
zchat.admin.toggle op 切换插件功能
zchat.admin.block op 管理玩家黑名单
zchat.color true 在聊天中使用颜色代码
zchat.formatting true 使用文本格式化代码
zchat.url true 发送可点击的 URL
zchat.mention true 使用 @提及
zchat.bypass.cooldown op 绕过聊天/消息冷却时间
zchat.bypass.swearfilter op 绕过脏话过滤器限制
zchat.format.admin op 使用 Admin 聊天格式
zchat.format.moderator false 使用 Moderator 聊天格式
zchat.format.vip false 使用 VIP 聊天格式
zchat.message true 发送和接收私人消息
zchat.channel.use.list true 使用 /channel list 命令
zchat.channel.use.join true 使用 /channel join 命令
zchat.channel.use.leave true 使用 /channel leave 命令
zchat.channel.use.focus true 使用 /channel focus 命令
zchat.channel.use.who true 使用 /channel who 命令
zchat.toggle true 聊天/消息开关权限的父级节点
zchat.toggle.chat true 切换公共聊天
zchat.toggle.messages true 切换私人消息
zchat.status true 查看自己的聊天状态
zchat.alerts.toggle true 开启或关闭警报
zchat.socialspy op 监控私人消息
zchat.commandspy op 监控玩家命令
zchat.bypass.chattoggle op 即使禁用也能聊天
zchat.bypass.messagetoggle op 即使禁用也能发送私聊
zchat.bypass.globalchat op 绕过全局聊天开关
zchat.bypass.globalmessages op 绕过全局消息开关
zchat.viewinventory true 查看共享物品栏
zchat.inventory.placeholders true 使用物品栏占位符
zchat.admin.toggle.chat op 强制切换某玩家的聊天功能
zchat.admin.toggle.messages op 强制切换某玩家的私聊功能
zchat.admin.toggle.all op 强制同时切换聊天和私聊功能
zchat.admin.gtoggle op 切换全局聊天功能
zchat.admin.socialspy op 强制为某玩家开启社交间谍
zchat.admin.stats op 查看服务器范围的统计数据
zchat.admin.alerts op 强制为某玩家开启或关闭警报
zchat.admin.clear op 清除各种与聊天相关的数据

需要帮助?

• Discord: 加入 Discord • Email: pluginsupport@bruhmo.men

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源