06a4e67e80e809e3d519a484d411826561d4eb89
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
复现实服探针
- 使用
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。 - 每个核心采用独立的工作目录、服务端、配置、世界与日志。测试服监听回环地址。
- 将
build/libs/ItxiaohuiContentGuard-0.1.0-dev.jar和build/libs/ItxiaohuiContentGuard-0.1.0-dev-compat-probe.jar装到测试实例的plugins目录。 - 启动后从控制台运行
icg info和icgprobe。通过客户端登录以触发实体调度与取消。Folia 探针同时检查全局线程与区块权属。 - 正常关服并在同一实例目录重启。核对
ICG_LIFECYCLE scheduler=closed、核心信息和ICG_PROBE各项结果。
协议客户端测试可使用 Node.js 和固定版本 minecraft-protocol@1.68.0。运行 node scripts/compat-client.cjs <minecraft-protocol 的绝对模块路径> <端口> 1.21.8。
每个核心和小版本都需要完整功能、压力、故障与稳定性证据后才会标记为正式兼容。
Description
Minecraft Java 1.21.x 多核心智能内容审核插件,兼容 Paper、Purpur、Spigot、Folia、Leaves,支持本地敏感词过滤、AI 智能审核、SMTP 邮件告警及 SQLite 违规记录,自动识别服务端核心并适配调度器。
210 KiB
1 Stars
1 Watchers
0 Forks