🎨 正在渲染积木…
0 / 0
学生端 · STUDENT
🧱 积木手册
编辑器内置的所有积木分类与积木一览。下方所有积木由编辑器本身实时渲染——你在这里看到的样子就是你拖到工作区时的样子。
1. 怎么用积木编程
① 拖出积木 左侧分类列表 → 点开分类 → 把要用的积木拖到中间工作区。
② 拼接积木 积木上下有凸起/凹槽，自动吸合；带"菱形/圆形插口"的需要填入"值"积木（数字、文本、材质等）。形状要对得上。
③ 看 Python 右侧 Monaco 编辑器实时把积木翻译成 Python 代码。你也可以反过来——直接在右侧写 Python，左侧积木区会自动重建。
④ 运行 按右上 🚀 运行 按钮，代码会在浏览器里通过 Pyodide 执行；其中调用游戏世界的语句会被打包发送到 Minecraft 服务器。
📌 编程方式（积木 / 积木+Python / Python）
顶部三个按钮可以让你只看积木、只看 Python、或两者同时。教师可能会"🔒 锁定"某种方式——锁定时你无法切换。
2. 工作区操作小抄
- 右键积木：复制 / 注释 / 折叠 / 📸 截图此积木（含所有连接）
- 右键空白：撤销 / 整理布局 / 清空
- Ctrl + Z / Ctrl + Y：撤销 / 重做
- 滚轮 + Ctrl：缩放工作区
- 拖到垃圾桶：删除（或直接拖回左侧分类区）
3. 入门案例（点 📋 复制 → 粘贴到编辑器即用）
每个案例都用真实拼接好的积木栈展示最终样子，并附 📋 按钮——点一下复制对应的 Python 代码。把编辑器顶部切到 🐍 Python 模式（或 📊 积木+Python 模式），把代码粘贴到右侧 Monaco 编辑器，左侧积木区会自动重建出同样的积木栈。
案例 ① · 在脚下放一块石头
最最小的"Hello, MC"：1 块积木——放置单个方块，材料填 石头。运行后脚下出现一块石头。
粘贴到编辑器 → 切 🐍 / 📊 模式 → 左侧自动出现这组积木
案例 ② · 建一座 10 层方塔
循环 + 建造 + 移动光标——10 块石质 4×4 方板叠成一座塔。
原理：每次循环画一层 4×4 实心石头方块，然后光标上移 1 格
案例 ③ · 用列表染一面彩虹墙
把材质列表当作"材料"参数传给建造积木，会按列表顺序循环取材，做出彩虹横纹。
尝试加几种染色玻璃，看看墙是几色的
4. 全部分类与积木
下方每个分类的标题下，附上"该分类适合做什么"和"使用要点"。所有积木按编辑器里的默认顺序展示——教师可以在控制台禁用某分类或某积木，对应条目会从编辑器消失。
5. 常见坑
- 形状对不上无法拼接：凸起对凹槽。值积木（圆角/胶囊）只能进圆角插口。
- 循环里不放"移动光标"：光标停在原地，每轮画的方块叠在同一个位置——看起来"什么都没发生"。
- 写
while True卡死浏览器：Python 在你自己的浏览器里跑，无限循环只会冻住你自己的标签页。需要"持续生效"请用 🎮 事件 分类。 - 找不到某块积木：教师可能在控制台禁用了它。问老师。
- 运行没反应：① 检查右下终端有没有报错；② 确认上方"MC 用户名"输入框里写的是你的游戏名；③ 确认服务器在线。
6. 想了解 Python？
每块积木最终都是 Python 代码——右侧 Monaco 编辑器里看得到。如果你想学一行行写代码，看 🐍 Python API 速查手册。