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