09-anti-patterns · diff
git:20260814.76af98c to git:20260820.6484bd4
1 added, 1 removed. Audit A to A.
# 09 — 基岩反模式
## Decision Flow
```
→ 要查 API → search_bedrock_docs / get_bedrock_doc_*;禁止 query_api / Yarn
→ 要校验 pack → validate_addon_manifest + validate_bp_json;禁止 validate_project / validate_datapack_json
→ 要 Gradle / 映射 → 拒绝并改口:基岩无 ForgeGradle、无 convert_mapping
→ 用户要 Beta → 走 07 分层;禁止 experimentalGameplay 与虚构 experimental.json
```
## 禁止(已核实)
- RP 与 BP **identifier 对不上**,或 header/module **uuid 重复**
- 用 Java `query_api` / `mixin_analyze` / Yarn 查 Script API 或模型路径
- 一律写 `"experimentalGameplay": true`
- 发明 `worldgen/experimental.json` 当世界实验开关
- 把 `assets/<modid>/models`、DeferredRegister、`EntityType`、`BlockBehaviour`、`generate_datagen` 写进基岩包
- 未点名 Beta 就生成 Beta 事件或 `@minecraft/server-beta`
- - 以为 pack JSON 能替玩家打开世界「Beta APIs」(须游戏 UI / `level.dat` 的 `experiments.gametest`)
+ - 以为 pack JSON 能替玩家打开世界「Beta APIs」(须游戏 UI;`level.dat` 实验开关**未核实**)
- `diagnose_gradle` 修 Loom/Forge 来「修」Add-On