31 lines
2.0 KiB
Markdown
31 lines
2.0 KiB
Markdown
# 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`。
|
|
|
|
```powershell
|
|
.\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`。
|
|
|
|
每个核心和小版本都需要完整功能、压力、故障与稳定性证据后才会标记为正式兼容。
|