脏话过滤器

脏话过滤器

服务器端脏话过滤器,拦截被标记的聊天内容,警告屡次违规者,并逐级升级为踢出和封禁。

管理

高级脏话过滤器

面向 Fabric 1.21.x 与 26.x 的下一代毒性言论控制

高级脏话过滤器是一款轻量级服务端工具,旨在无需持续人工管理的情况下维护社区规范。与容易被空格或符号欺骗的基础过滤器不同,本模组使用激进的归一化引擎,在绕过尝试进入聊天之前就将其剥离。


主要特性

  • 多版本保护: 完全兼容所有 Fabric 1.21.x 版本以及最新的 26.x 快照/正式版。

  • 归一化引擎(防绕过): 通过剥离空格、句点、下划线和特殊字符自动扁平化消息,以暴露隐藏的词汇。

  • 符号与 Leetspeak 检测: 智能检测字符替换(例如用 @ 代替 a,用 $ 代替 s,用 0 代替 o)。

  • 完全消息拦截: 阻止整条消息发送,以维持干净的聊天环境,并避免现代 Fabric 版本中常见的“签名聊天”错误。

  • 自动化执行层级:

  • 警告: 向违规者发送可自定义的警告消息。

  • 自动踢出: 达到设定警告次数后触发(默认:3)。

  • 自动封禁: 重复违规后永久移除(默认:10)。

  • PvP 感知逻辑: 专门调校以忽略常见游戏术语(TNT、Spear、Raid),同时严格聚焦于侮辱与毒性行为。

增强你的服务器配置! 在以下地址查看我的其他服务端模组:Fabric Server Essentials


配置(profanity_filter.json)

模组会在服务器的 /config 文件夹中生成高度细粒度的配置文件。以下是服务器所有者可用的主要设置:

设置 类型 默认值 描述
kick_threshold 整数 3 自动踢出服务器前的警告次数。
ban_threshold 整数 10 自动永久封禁前的警告次数。
normalization_level 字符串 AGGRESSIVE 设置引擎剥离特殊字符的严格程度。支持 AGGRESSIVE 或 BASIC。
enable_leetspeak 布尔值 true 是否检查字符替换,例如用 $ 代替 s。

归一化级别说明

  • BASIC:检查简单词汇匹配和直接的 leetspeak 转换,不会大幅改变句子布局。
  • AGGRESSIVE:通过完全剥离所有空格、制表符、句点、下划线和特殊标点字符来彻底扁平化输入消息,以暴露隐藏或分离的毒性文本字符串。

管理与词典

  • 实时词典: 预加载 1,000+ 种变体列表,可通过 JSON 配置实时编辑,无需重启服务器。
  • 自定义消息: 完全支持经典 mini-message 或标准颜色代码,适用于所有警告、踢出和封禁消息。
  • 排除列表: 添加过滤器应忽略的特定短语,即使它们包含被标记的字符。

性能与技术

仅服务端: 玩家无需安装此模组即可加入你的服务器!

专为运行现代硬件的高人口网络设计。逻辑使用 FastUtil 集合和高效处理管道进行了高度优化,确保即使在激烈、繁重的全局聊天活动中也**零“聊天延迟”**或对 TPS 的影响。

安装

  1. 将 .jar 放入服务器的 mods 文件夹。
  2. 确保为目标环境(1.21.x 或 26.x)安装了正确的 Fabric API 版本。
  3. 在 config/profanity_filter.json 中配置你的词汇列表和阈值。
  4. 重启服务器以应用更改,享受干净的聊天!