ServerShield

插件

· 作者 Catspindev01

ServerShield 是一款适用于 Minecraft 服务器的全自动化综合管理插件!

0 本站下载 0 关注 更新于 1 年前

最新 0.1 · 1.21.10 · Paper

一键开服(送7天)

ServerShield — Minecraft 1.21+ 的自动管理插件

简短描述

ServerShield 是一款专注、低延迟的管理插件,可防止辱骂和严重粗俗用语出现在聊天中——在消息发送前将其拦截。即插即用,拥有合理的默认设置、可微调的阈值以及内置的管理员统计功能。

标语

适用于 Paper/Spigot(Minecraft 1.21+)的自动化辱骂过滤与安全聊天执行


详细描述

ServerShield 通过将聊天内容发送至可信的管理 API,实时拦截辱骂和严重粗俗用语。当检测到不当内容时,该消息将被阻止广播,并清除发送者的聊天记录,以确保其他玩家——包括发送者本人——都不会看到该内容。

ServerShield 专注于做好一件事:无需手动关键词列表或本地辱骂词库,即可停止辱骂行为并最大限度地减少服务器聊天中的有害内容。它集成了 Paper 和 Spigot(Minecraft 1.21+),旨在实现最小化的管理员配置工作量。


主要特性

  • 即时移除辱骂词汇 —— 被标记为辱骂的消息在到达玩家之前就会被取消。
  • 可配置的阈值 —— 使用 threshold 设置调整管理的激进程度。
  • 两种动作模式:delete(默认)和 hashtag —— delete 直接屏蔽,当你希望使用可见占位符时,hashtag 会将内容替换为 ########。
  • 兼容 Paper 1.21 与 Spigot —— 根据需要检测并处理 AsyncChatEvent 或 AsyncPlayerChatEvent。
  • 统计功能:/servershield stats —— 管理员可以查看被屏蔽的消息数量及按玩家分类的统计数据。
  • 无本地辱骂词库 —— 插件依赖外部粗俗用语 API 进行检测。
  • 可选通过 yguard 配置文件生成混淆版本构建(适用于分发受保护 jar 的插件作者)。

快速安装

  1. 将 ServerShield.jar 放入服务器的 plugins/ 文件夹中。
  2. 重启或重载服务器。
  3. 编辑 plugins/ServerShield/config.yml 以调整设置(见下方的配置说明)。

注意:独立运行,除非你想调整检测灵敏度或统计功能,否则无需外部配置。


配置 (config.yml 快速参考)

  • action: delete # delete 或 hashtag
  • threshold: 0.9 # 数值越高越严格;取值范围在 0.0 到 1.0 之间
  • broadcast_for_all: true # 如果设置为 true,则向所有人广播 hashtag 替换结果
  • clear_chat_lines: 100 # 用于从视图中移除发送者消息的空行数量
  • debug: false # 开启以进行调优和故障排除
  • persist_stats: true # 是否将统计数据保存至 plugins/ServerShield/stats.yml

调优建议:启用 debug: true 可在服务器控制台中查看 API 响应和评分。这有助于你找到适合社区的最佳 threshold 值。


命令与权限

  • /servershield stats —— 显示被屏蔽的消息总数及被屏蔽最多的玩家。
    • 权限:servershield.stats(默认:op)—— 查看游戏内统计信息。
  • 权限:servershield.admin —— 用于管理员专属访问插件命令(默认:op)。

隐私与数据

  • ServerShield 会将聊天消息发送至 Profanity API () 以进行管理决策。如果你不希望将聊天内容发送至外部服务,请勿运行此插件。
  • 插件不会在 stats.yml 中存储原始消息 —— 仅在启用 persist_stats 时存储计数值和按玩家聚合的被屏蔽总数。
  • 你可以在 config.yml 中将 persist_stats: false 来禁用持久化存储。

路线图 (计划中)

  • 高级封禁系统与规则(一体化管理控制台)
  • Essentials 风格的功能集(作为标准工具的可选替代方案)

更新日志 (简略)

  • 0.01 BETA —— 初始公开测试版,包含辱骂检测和基本统计功能。

常见问题

问:当 API 宕机时会发生什么? 答:ServerShield 能优雅地处理 API 故障:如果无法连接 API,消息将被视为安全(不进行本地屏蔽),因此外部 API 的可用性可能会影响屏蔽效果。开启 debug 以监控 API 错误。

问:ServerShield 是否使用任何本地辱骂词库? 答:不 —— 根据我的选择,该插件仅使用外部粗俗用语服务。这避免了维护本地列表的需要。

问:该插件是否与 Paper 1.21 兼容? 答:是的 —— ServerShield 在 Paper 上处理 AsyncChatEvent,并在 Spigot 上回退至 AsyncPlayerChatEvent。


支持与联系

  • 我们正在努力完善中。

许可证

  • 有关许可证详情,请参阅 Modrinth。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源