# 兼容性矩阵

| Minecraft | Forge 基线 | Java | Gradle/FG | 构建根 | 支持状态 |
|---|---:|---:|---|---|---|
| 1.20.1 | 47.4.0 | 17 | Gradle 8.8 / FG6 | `platform/forge-1.20.1` | 目标基线，待完整运行验收 |
| 1.20.6 | 50.2.10 | 21 | Gradle 9.6 / FG7 | `platform/forge-1.20.6` | 目标基线，待完整运行验收 |
| 1.21.1 | 52.1.16 | 21 | Gradle 9.6 / FG7 | `platform/forge-1.21.1` | 目标基线，待完整运行验收 |
| 1.21.11 | 61.2.1 | 21 | Gradle 9.6 / FG7 / EventBus 7 | `platform/forge-1.21.11` | 目标基线，待完整运行验收 |

每个构建只声明表中单个 Minecraft 版本，不推断兼容中间小版本。四个版本均须分别通过官方 Forge 专服启动、原版客户端连接、停止和数据库恢复测试；当前尚未形成这四项全部通过的发布证据。

## 互操作约定

- Spark、BlueMap 当前仅做已加载状态的软检测；尚未调用其 API，模组也不复制 profiler 或地图渲染。
- 未安装语义适配器的第三方命令只能根级允许/拒绝，不能策略提权。
- 未安装状态 codec 的第三方方块实体/实体/容器会标记为不可可靠恢复并逐项跳过。
- 未知聊天模组只显示兼容性状态；mute 不能虚假宣称覆盖其自定义聊天管线。
- offline-mode 玩家按原版 OP 等级使用命令；策略不能向未认证身份授予超出其当前 OP 等级的额外权限，UUID 身份也不能作为危险 Web 权限的可信证明。

## 明确不支持

内置 JVM 拉起/重启、文件管理器、OS Shell、经济/home/warp/kit、反作弊、地图渲染、Spark 级 profiler、跨服同步，以及对任意第三方模组状态“100% 原子恢复”的承诺。
