ItxiaohuiContentGuard · 小慧内容卫士

面向 Minecraft Java 1.21.x 的服务端内容审核插件。当前阶段提供 Java 21 构建、核心识别、调度适配和实服兼容探针。聊天、书本、AI、SMTP 和 SQLite 审核将在后续阶段提交。

兼容适配

  • 启动时核对服务端品牌、构建版本和调度 API 能力。/icg info 输出检测结果和已选适配器。
  • Spigot 使用 Bukkit 调度器。Paper、Purpur、Leaves 在原生接口完整时使用 Paper 调度器。
  • Folia 将全局、区块、实体和异步任务提交到对应的原生调度器。实体任务处理失效、取消和停用。
  • 未知核心按 API 能力检测。识别到原生调度能力却缺少完整接口时会记录失败并停用插件。

构建

需要 Java 21。Windows 使用以下命令,其他系统使用 ./gradlew。

.\gradlew.bat build compatProbeJar

复现实服探针

  1. 使用 python scripts/fetch-servers.py --download --version 1.21.8 获取 Paper、Purpur、Folia 和 Leaves。使用 python scripts/build-spigot.py --java <java路径> --version 1.21.8 编译 Spigot。
  2. 每个核心采用独立的工作目录、服务端、配置、世界与日志。测试服监听回环地址。
  3. 将 build/libs/ItxiaohuiContentGuard-0.1.0-dev.jar 和 build/libs/ItxiaohuiContentGuard-0.1.0-dev-compat-probe.jar 装到测试实例的 plugins 目录。
  4. 启动后从控制台运行 icg info 和 icgprobe。通过客户端登录以触发实体调度与取消。Folia 探针同时检查全局线程与区块权属。
  5. 正常关服并在同一实例目录重启。核对 ICG_LIFECYCLE scheduler=closed、核心信息和 ICG_PROBE 各项结果。

协议客户端测试可使用 Node.js 和固定版本 minecraft-protocol@1.68.0。运行 node scripts/compat-client.cjs <minecraft-protocol 的绝对模块路径> <端口> 1.21.8。

每个核心和小版本都需要完整功能、压力、故障与稳定性证据后才会标记为正式兼容。

S
Description
Minecraft Java 1.21.x 多核心智能内容审核插件,兼容 Paper、Purpur、Spigot、Folia、Leaves,支持本地敏感词过滤、AI 智能审核、SMTP 邮件告警及 SQLite 违规记录,自动识别服务端核心并适配调度器。
Readme GPL-3.0
210 KiB
1 Stars 1 Watchers 0 Forks
Generate repository badges
Languages
Java 67.4%
Python 26.9%
JavaScript 5.7%