MinecraftBE Commands & Building — AI Skill

一个面向 AI 的 Minecraft 基岩版（Bedrock Edition）技能包：教模型写基岩版命令、设计命令方块链，并完成建筑/内饰/奇观的体素设计与导出。

目标环境：网易我的世界 1.21.130（协议 898）。

只针对 Bedrock。Java 版的 data、NBT、execute store、team、bossbar、attribute、item、forceload 在这里都不存在。
网易 1.21.130 的边界：schedule/function 可用；camera/inputpermission/dialogue/loot/place/recipe/scriptevent/fog 未验证/未实装。

交流群：2166056402

Special Thanks

侠名 — 语言优先 DSL / 命令编译器与链布局思路（mct-skill）。

范围

• 命令：命令方块链、计分板状态机、FMBE 显示、菜单、技能、系统逻辑。
• 建筑：场地、体量、轮廓、材质、立面、屋顶、内饰、灯光。
• 输出：命令系统默认 .mcworld / .mcstructure（语言优先链）；BDX 作为服务器/建筑辅助线。
• 工作模式：Python DSL → spec → cbc 链布局 → 结构文件；不再直接让 AI 写整段命令字符串。

先学模型，不是背例子

这个 Skill 不把“例子”当知识本身。每个任务先建立：

1. 计算模型：状态机 / 数据流事务 / 队列 / 树 / 图 / 几何采样。
2. 内存布局：计分板、tag、数组、队列、树索引。
3. 数学：整数、取模、钳制、坐标、距离、概率、几何表。
4. 复杂度：分支数、实体数、每 tick 命令数、最坏情况。
5. 不变量：幂等、可重置、有界、可观测。

• 命令计算基础
• 命令数学
• N 叉树 / NX 树
• 坐标运算四思想（二分/NX/递归/大数圆规 + 计分板全语法）
• 指令计算机：实体像素/栅格
• 19 个社区指令文件 → 系统框架
• Java→Bedrock 方块名映射
• 值噪声 / 精度哈希
• 完整值噪声地形机
• 提问、期待效果与联想创新

语言优先层（命令系统）

corpus_search → dsl.py → spec.json → cbc.py → build_cbworld

• scripts/dsl.py：结构化选择器 / execute 上下文 / 动作
• scripts/cbc.py：三段式断链、条件块、链宽/链深
• scripts/build_cbworld.py / mcworld_to_structure.py：世界与结构文件
• 语法结构检查：可选，本地 oracle，不随包分发
• references/mct-playbook.md + references/mct/：DSL/链布局/UI/调试全表

命令系统优先这条链；建筑、BDX、FMBE、真机回读是辅助层。

快速开始

# 1. 安装到用户级技能目录
git clone https://github.com/yixin-amore/MinecraftBE-Command-Building-Skill.git
mkdir -p "${DSH_PROFILE_DIR:-$HOME/.dsh/profiles/desktop}/skills"
cp -R MinecraftBE-Command-Building-Skill "${DSH_PROFILE_DIR:-$HOME/.dsh/profiles/desktop}/skills/mcbe-command-blocks"

# 2. 依赖（BDX 生成需要 brotli）
python3 -m pip install brotli

# 3. 验证
cd "${DSH_PROFILE_DIR:-$HOME/.dsh/profiles/desktop}/skills/mcbe-command-blocks"
python3 scripts/chain_lint.py examples/arena-countdown/spec.json
python3 scripts/bdxgen.py --spec examples/bdx-generator/demo.json /tmp/demo.bdx
python3 scripts/buildgen.py examples/build-pipeline/plan.json /tmp/build.bdx

目录

mcbe-command-blocks/
├── SKILL.md
├── references/
│   ├── command-block-mechanics.md
│   ├── command-foundations.md       # 计算模型/内存/控制流/算法/复杂度
│   ├── command-mathematics.md       # 整数/定点/坐标/几何/概率
│   ├── nx-tree.md                   # N 叉树/NX：执行分叉/圆/射线/体积
│   ├── coordinate-arithmetic.md     # 二分/NX/递归/大数圆规 + 计分板语法
│   ├── command-computer.md         # 指令计算机：item 像素/栅格/噪声
│   ├── command-corpus-framework.md  # 19 个社区指令语料的归类/统计框架
│   ├── value-noise.md               # 值噪声/精度哈希/四角锚点
│   ├── value-noise-7cmd.md          # 7 命令值噪声核拆解
│   ├── gaussian-filter.md           # 高斯滤波/NX 地形平滑
│   ├── value-noise-terrain-machine.md # 完整值噪声地形机（32×32/429 方块）
│   ├── block-map.md                 # Java→Bedrock 方块名映射（snow/snow_layer）
│   ├── chain-patterns.md
│   ├── bedrock-command-reference.md
│   ├── execute-and-selectors.md
│   ├── scoreboard-memory.md
│   ├── text-ui-and-effects.md
│   ├── fmbe-mbe.md
│   ├── render-controller-vars.md     # playanimation 改 render controller 变量
│   ├── dataization-rpg.md
│   ├── misc-map-systems.md
│   ├── one-pass-delivery.md
│   ├── bdx-chain-packaging.md
│   ├── building-design.md
│   ├── building-corpus-learning.md
│   ├── gothic-cathedral-case.md
│   ├── interior-design.md
│   ├── spectacle-design.md
│   ├── creative-thinking.md
│   ├── intake-and-reasoning.md      # 提问/期待效果/联想/创新协议
│   ├── debugging.md
│   ├── bedrock-vs-java.md
│   └── netease-1.21.130.md
├── assets/
│   ├── chain-spec.schema.json
│   ├── design-brief.template.md
│   ├── building-brief.template.md
│   └── interior-brief.template.md
├── scripts/
│   ├── chain_lint.py
│   ├── command_corpus.py          # 指令文本归类/统计
│   ├── block_map.py               # Java 方块名归一化
│   ├── bdxgen.py
│   ├── buildgen.py
│   ├── sunrain_index.py
│   ├── corpus_query.py
│   └── schematic_blocks.py
└── examples/
    ├── arena-countdown/
    ├── vending-machine/
    ├── toggle-lamp/
    ├── snowball-menu/
    ├── fmbe-player/
    ├── noise-terrain/               # 值噪声 32×32 地形机（429 方块，可复现）
    ├── frostcrown-fmbe/             # 14 部件 FMBE 僵尸 AI Boss + 真实命中（432 方块，可复现）
    ├── parliament-631/              # 631/内院/石族混色国会大厦（303,020 方块，可复现）
    ├── bdx-generator/
    └── build-pipeline/

1. 安装

项目级

git clone https://github.com/yixin-amore/MinecraftBE-Command-Building-Skill.git
mkdir -p <workspace>/.dsh/skills
cp -R MinecraftBE-Command-Building-Skill <workspace>/.dsh/skills/mcbe-command-blocks

DSH 启动时会扫描 <workspace>/.dsh/skills，目录里必须有 SKILL.md。

用户级

mkdir -p "${DSH_PROFILE_DIR:-$HOME/.dsh/profiles/desktop}/skills"
cp -R MinecraftBE-Command-Building-Skill "${DSH_PROFILE_DIR:-$HOME/.dsh/profiles/desktop}/skills/mcbe-command-blocks"

或软链接：

ln -sfn "$PWD/MinecraftBE-Command-Building-Skill" "${DSH_PROFILE_DIR:-$HOME/.dsh/profiles/desktop}/skills/mcbe-command-blocks"

环境

python3 -m pip install brotli

2. 验证

cd "${DSH_PROFILE_DIR:-$HOME/.dsh/profiles/desktop}/skills/mcbe-command-blocks"
test -f SKILL.md && echo SKILL_OK

python3 scripts/chain_lint.py examples/arena-countdown/spec.json
python3 scripts/bdxgen.py --spec examples/bdx-generator/demo.json /tmp/check.bdx
python3 scripts/buildgen.py examples/build-pipeline/plan.json /tmp/check-build.bdx
ls -lh /tmp/check.bdx /tmp/check-build.bdx

3. 在 DSH 里使用

直接把需求说清楚，模型会读 SKILL.md，先定状态/时序/体量，再写 spec/plan 和 BDX 文件。

好需求：

“设计一个 3 秒倒计时 + 开局传送的命令方块链，并生成 BDX。”

“在 300 64 500 建一座 20×20 的石屋，只导出 BDX。”

“这个链为什么第二个方块不执行？”

“把这段 Java 命令翻译成基岩版。”

需要补参数的需求：

“建个好看的主城。”

需要先确认：坐标、尺寸、风格、功能、性能预算。

4. 命令方块：spec → BDX

spec.json 描述链；chain_lint.py 校验；bdxgen.py 生成命令方块 BDX。

python3 scripts/chain_lint.py examples/arena-countdown/spec.json
python3 scripts/chain_lint.py examples/arena-countdown/spec.json --write plan.md
python3 scripts/bdxgen.py --spec examples/bdx-generator/demo.json /tmp/demo.bdx

最小 spec：

{
  "name": "my-chain",
  "setup": ["scoreboard objectives add obj dummy"],
  "blocks": [
    {"id": "clock", "type": "repeat", "redstone": "always_active",
     "command": "scoreboard players add fb_tick obj 1", "next": "step"},
    {"id": "step", "type": "chain", "command": "say 20 ticks", "next": null}
  ],
  "tests": ["..."],
  "notes": ["..."]
}

完整字段见 assets/chain-spec.schema.json。

5. 建筑：plan → BDX

一份 plan.json 生成完整方块 BDX：

{
  "name": "My Build",
  "fills": [
    {"from": [0, 64, 0], "to": [8, 64, 8], "block": "stone_bricks"}
  ],
  "blocks": [
    {"pos": [4, 65, 4], "block": "sea_lantern"}
  ],
  "commands": [
    {"pos": [0, 65, 0], "type": "chain", "command": "say build ready"}
  ]
}

python3 scripts/buildgen.py plan.json out.bdx

• buildgen.py 把 plan 展开成普通方块 + 命令方块 BDX。
• bdxgen.py 也可直接写 BuildBlock / Block。
• 大建筑会展开成很多方块；脚本有 2,000,000 块上限，超了拆 plan。

6. 导入 BDX

用任意 BDX 导入器导入 out.bdx。导入后确认：

• 命令方块 mode / chain / facing 正确
• 坐标与世界匹配
• 需要时加 tickingarea
• 建筑方块没有被导入器过滤

7. 排错

8. 校验 spec / 生成构建表

python3 scripts/chain_lint.py examples/arena-countdown/spec.json
python3 scripts/chain_lint.py examples/arena-countdown/spec.json --format json
python3 scripts/chain_lint.py examples/arena-countdown/spec.json --write plan.md

退出码：0 无错误；1 有错误（或 --strict 下有警告）；2 文件/参数错误。

检查内容：

• Java 残留命令/选择器参数/方块状态/文本 JSON
• dummy 以外的计分板准则、objectives modify、players get
• 无头链、孤立块、环、多上游、非相邻、朝向错误、条件块身后不对
• 红石 10 Hz、repeat 每 tick 昂贵命令、延迟链条件语义
• 命令长度、@e 过宽、hasitem 误用 count=

主要事实来源

• Command Block — Minecraft Wiki
• Commands/execute — Minecraft Wiki
• Target selectors — Minecraft Wiki
• Scoreboard — Minecraft Wiki
• Minecraft Creator Docs — Commands

说明

• 技能是静态知识 + 静态校验：linter 不能执行 Minecraft，最终以游戏内测试为准。
• 版本以网易 1.21.130为基准；/help 是版本差异的最终裁判。
• 旧导入图里的 execute @a ~ ~ ~ 旧语法，新图不要用；先手工升级。

License

MIT