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 的插件作者)。
快速安装
- 将
ServerShield.jar 放入服务器的 plugins/ 文件夹中。
- 重启或重载服务器。
- 编辑
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。
支持与联系
许可证
ServerShield — Automatic moderation plugin for Minecraft 1.21+
Short description
ServerShield is a focused, low-latency moderation plugin that prevents slurs and severe profanity from appearing in chat — blocking them before they are sent. Plug-and-play behavior with sensible defaults, fine-tunable thresholds, and built-in admin stats.
Tagline
Automated slur removal & safe chat enforcement for Paper/Spigot (Minecraft 1.21+)
Long description
ServerShield blocks slurs and severe profanity in real-time by sending chat content to a trusted moderation API. When offensive content is detected, the message is prevented from broadcasting and the sender's chat is cleared so the content never appears to other players — or themselves.
ServerShield focuses on doing one job well: stop slurs and minimize harmful content in your server chat without manual keyword lists or local slur storage. It integrates with Paper and Spigot (Minecraft 1.21+) and is designed for minimal admin setup.
Key features
- Instant slur removal — messages flagged as slurs are cancelled before they reach players.
- Configurable threshold — adjust how aggressive the moderation should be using the
threshold setting.
- Two action modes:
delete (default) and hashtag — delete simply blocks, hashtag replaces content with ######## when you prefer a visible placeholder.
- Works on Paper 1.21 & Spigot — detects and handles
AsyncChatEvent or AsyncPlayerChatEvent as needed.
- Stats:
/servershield stats — admins can view how many messages were blocked and a player breakdown.
- No local slur list — the plugin relies on an external profanity API for detection.
- Optional obfuscated release build via
yguard profile (for plugin authors who distribute a protected jar).
Quick install
- Place
ServerShield.jar into your server plugins/ folder.
- Restart or reload the server.
- Edit
plugins/ServerShield/config.yml to tune settings (see config recipe below).
Note: Standalone, no external configuration required unless you want to tweak detection sensitivity or stats.
Configuration (config.yml quick reference)
- action:
delete # delete or hashtag
- threshold:
0.9 # higher is stricter; values between 0.0 and 1.0
- broadcast_for_all:
true # broadcast hashtag replacements to everybody if set
- clear_chat_lines:
100 # number of blank lines to remove the sender's message from view
- debug:
false # turn on for tuning and troubleshooting
- persist_stats:
true # whether to save stats to plugins/ServerShield/stats.yml
Tuning: enable debug: true to see API responses and scores in server console. That helps you find the ideal threshold for your community.
Commands & Permissions
/servershield stats — Show total blocked messages and top blocked players.
- Permission:
servershield.stats (default: op) — view in-game stats.
- Permission:
servershield.admin for admin-only access to plugin commands (default: op).
Privacy & Data
- ServerShield sends chat messages to the Profanity API () for moderation decisions. If you do not want to send chat to an external service, do not run the plugin.
- The plugin does NOT store raw messages in
stats.yml — it only stores counts and aggregated per-player blocked totals when persist_stats is enabled.
- You can disable persistence by setting
persist_stats: false in config.yml.
Roadmap (planned)
- Advanced ban system & rules (all-in-one moderation console)
- Essentials-like feature set (optional replacement for standard tools)
Changelog (short)
- 0.01 BETA — Initial public beta with slur detection and basic stats.
FAQ
Q: What happens when the API is down?
A: ServerShield handles API failures gracefully: if the API cannot be reached, messages will be treated as safe (no local blocking), so uptime of the external API may impact blocking. Turn on debug to monitor API errors.
Q: Does ServerShield use any local slur database?
A: No — per my choice, the plugin uses the external profanity service only. This avoids maintaining a local list.
Q: Is the plugin compatible with Paper 1.21?
A: Yes — ServerShield handles AsyncChatEvent on Paper and falls back to AsyncPlayerChatEvent for Spigot.
Support & contact
License
- See Modrinth for license details.
评论 0
登录后参与评分
还没有评论,来抢沙发吧