AdvancedSensitiveWords

插件

· 作者 Undefined_0721

一站式多平台终极防脏话解决方案,适用于你的 Minecraft 服务器!

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

最新 2.3.0 · 26.2 · Velocity

一键开服(送7天)

AdvancedSensitiveWords

AdvancedSensitiveWords 是一款基于 DFA 词匹配、基于事件的内容检查、模块化违规等级以及可选的 LLM 辅助聊天审查构建的 Paper 管理插件。

2.x 是一个破坏性更新版本。 它仅针对 Paper,使用带有 Kotlin DSL 的 Gradle,并生成新的 kebab-case 配置模型。在未经仔细审查所有设置的情况下,请勿复用 2.0 之前的配置文件。

要求

组件 要求
服务器 Paper 1.21.11 或更高版本
Java Java 21
代理(可选) Velocity 及对应的 Velocity jar 包
可选集成 TrChat, PacketEvents, PlaceholderAPI, floodgate, AuthMe

自 2.x 版本起不再支持 Spigot、CraftBukkit 和 BungeeCord。

安装

  1. 从发行版下载 Paper 工件,或在本地构建 paper:shadowJar。
  2. 将 Paper jar 放入服务器的 plugins/ 目录并启动一次 Paper。
  3. 配置 plugins/AdvancedSensitiveWords/config.yml 以及生成的 messages_en.yml 或 messages_zhcn.yml。
  4. 更改词典后运行 /asw reload all,或仅更改配置后运行 /asw reload config。

对于 Velocity 通知和代理命令,请在代理上安装 Velocity 工件,在 Paper 上设置 plugin.hook-velocity: true,然后重启两端。代理模块本身不进行聊天过滤。

2.x 过滤器涵盖范围

  • 聊天和命令:Paper AsyncChatEvent、命令预处理、跨消息聊天上下文、可配置的替换或取消、取消时的虚假消息,以及与 TrChat 虚假消息/影子封禁的兼容性。
  • 书籍:基于事件的 writable-book 检查,取消模式下的可选跨页检查,以及对已处理书籍内容的有界缓存。
  • 告示牌:逐行、多行及最近告示牌上下文检查。在取消模式下,可选的 PacketEvents 虚假视图可以让作者看到其尝试输入的文本,而其他玩家则保留真实、干净的告示牌视图。
  • 铁砧和物品:重命名结果过滤,以及使用 Adventure 组件进行的物品显示名称和描述过滤。
  • 玩家名称和广播:拒绝登录被屏蔽的名称,以及可选的广播过滤。
  • 可选 LLM 聊天审查:对未匹配 DFA 或聊天上下文的异步、按成本限制的审查。默认禁用,且不会撤回聊天;它可以通知、记录、增加单独的 AI VL,并在验证响应后执行配置的操作。

快速配置

配置以 lowercase kebab-case 生成。生成的文件是默认的权威列表及内联注释。

plugin:
  language: en
  enable-chat-check: true
  enable-sign-edit-check: true

chat:
  method: CANCEL # REPLACE or CANCEL
  fake-message-on-cancel: false
  context-check: true

REPLACE 会将匹配的文本替换为配置的替换内容。CANCEL 会拒绝受影响的交互。虚假聊天消息和告示牌虚假视图仅为取消模式功能。

命令参数规则

chat.command-white-list 还定义了哪些命令参数会被检查。在默认的 invert-command-white-list: true 下,列出的命令路径会被检查,而列表外的命令将被跳过。

chat:
  invert-command-white-list: true
  command-white-list:
    - "[default:include] /msg [ignore:1]"
    - "[default:include] /bc [ignore:1,-1]"
    - "[default:ignore] /mail send [include:2..]"

参数从命令路径后的 1 开始编号。-1 表示最后一个参数;2.. 表示从第二个参数到末尾。include 和 ignore 指令按顺序处理。被忽略的参数会分割检测段,因此被屏蔽的词无法跨越跳过的玩家名称、服务器名称、数量或其他参数进行匹配。

惩罚与违规等级

每个过滤器模块都有其自己的 punishment 列表及其各自的 VL:CHAT、AI、BOOK、SIGN、ANVIL 和 ITEM。命令共享 CHAT VL。plugin.manual-punishment 中的手动默认列表是例外:其 VL 条件使用跨模块的总和。

chat:
  punishment:
    - "COMMAND|kick %player% Blocked content|VL>2"
    - "SHADOW|60|VL>5"

支持的操作类型包括 COMMAND、COMMAND_PROXY、DAMAGE、HOSTILE、EFFECT 和 SHADOW。在命令动作中使用 %player% 或 %PLAYER%。空列表会保持检测、日志记录、通知和 VL 计数处于活动状态,同时禁用自动操作。

可选 LLM 审核

仅在配置了兼容提供商和 API 密钥后启用 LLM 审查。Paper 通过 plugin.yml 加载 LangChain4j 库,因此服务器需要在首次启动期间具有网络访问权限或现有的 Paper 库缓存。

ai:
  enabled: true
  base-url: https://api.deepseek.com
  api-mode: CHAT_COMPLETIONS # CHAT_COMPLETIONS, RESPONSES, or ANTHROPIC_MESSAGES
  api-key-environment: DEEPSEEK_API_KEY
  model-name: deepseek-v4-flash

在发出请求之前,ASW 要求直接 DFA 和聊天上下文检查均未命中,然后应用消息长度、熵、每位玩家的冷却时间、飞行中、并发性和队列限制。LLM 输出在采取任何后续操作之前会在本地进行严格解析。

每个类别在 ai.category-policy 下都有独立的通知和惩罚置信度阈值及操作。LLM 请求和响应会在 plugins/AdvancedSensitiveWords/llm-history/ 中进行审计。将此目录视为敏感的操作数据。

ai.server-context-can-override 是一项服务器所有者策略开关。启用时,ai.server-context 会被插入到可信系统策略中,并且故意不包含在用户 JSON 负载中。请保持策略文本由管理员控制;切勿在其中放置玩家输入、凭证或私有数据。

命令

命令 用途
/asw help [query] 显示命令帮助。
/asw status 显示插件总体状态。
/asw ai status 显示 LLM 运行时计数器、队列状态、模型、API 模式及分类策略。
/asw reload [all|config] 重新加载配置,或重新加载配置与词库。
/asw test <text...> 对文本进行 DFA 过滤器测试。
/asw word add/remove <word> [word...] 仅在当前运行时修改屏蔽词列表。
/asw allow add/remove <word> [word...] 仅在当前运行时修改白名单(允许词)列表。
/asw player info <online-player> 显示单个模块及总体的违规等级(VL)。
/asw player reset <online-player> [module] 重置所有或指定模块的违规等级(VL)。
/asw player punish <online-player> [method...] 执行配置好的手动惩罚措施或指定的操作。
/asw teleport <world-id> <x> <y> <z> 将工作人员传送至被举报的位置。

/asw 与 /advancedsensitivewords 等效。在完全重新加载词库或服务器重启时,运行时的词列表变更将被丢弃。

权限

权限节点 默认值 用途
advancedsensitivewords.bypass false 绕过过滤。
advancedsensitivewords.notice op 接收工作人员通知。
advancedsensitivewords.update op 接收更新通知。
advancedsensitivewords.command.* false 所有管理命令的父节点。
advancedsensitivewords.command.help op 使用帮助命令。
advancedsensitivewords.command.status op 使用总体状态命令。
advancedsensitivewords.command.ai.status op 使用 AI 状态命令。
advancedsensitivewords.command.reload.all op 重新加载配置和词库。
advancedsensitivewords.command.reload.config op 仅重新加载配置。
advancedsensitivewords.command.test op 使用 DFA 测试。
advancedsensitivewords.command.word.add op 在运行时添加屏蔽词。
advancedsensitivewords.command.word.remove op 在运行时移除屏蔽词。
advancedsensitivewords.command.allow.add op 在运行时添加允许词。
advancedsensitivewords.command.allow.remove op 在运行时移除允许词。
advancedsensitivewords.command.player.info op 检查玩家违规等级(VL)。
advancedsensitivewords.command.player.reset op 重置玩家违规等级(VL)。
advancedsensitivewords.command.player.punish op 施加手动惩罚。

集成与 API

  • TrChat:支持假聊天消息与阴影禁令(shadowban)显示的兼容性。TrChat 仍负责其自身的格式化管道。
  • PacketEvents:可选依赖,仅用于告示牌的假视图功能。若未安装,告示牌取消行为仍将生效,但不会显示假视图。
  • PlaceholderAPI:启用 plugin.enable-placeholder 以暴露 %asw_version%、%asw_total_filtered%、%asw_is_shadow% 和 %asw_violation_count% 占位符。
  • Floodgate / AuthMe:可选支持 Bedrock 用户名与认证状态处理。

其他 Paper 插件无需依赖实现类即可访问阴影禁令 API:

import io.wdsj.asw.bukkit.api.AdvancedSensitiveWordsApi;
import java.time.Duration;

AdvancedSensitiveWordsApi.shadowBan().shadow(player, Duration.ofMinutes(5));

AsyncModerationResponseEvent 在 LLM 响应后异步触发。事件处理器可以观察、取消 ASW 的后续操作,或替换已验证的结果,但必须自行安排 Bukkit 实体/世界的操作。

从源码构建

.\gradlew.bat --no-daemon build

许可证

AdvancedSensitiveWords 采用 GNU AGPL-3.0 许可证授权。

链接

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源