09-anti-patterns · git:20260814.76af98c · 2026-08-14 · sha256 696d67b605771063

09-anti-patterns git:20260814.76af98cA

Immutable. This exact content is served forever at /api/v1/blob/696d67b605771063.

# 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`)
- `diagnose_gradle` 修 Loom/Forge 来「修」Add-On