制作第一个 Mod
现在让我们动手制作你的第一个模组——一个自定义的熔炉配方：把腐肉放进熔炉烧制出皮革。这在原版游戏中是不存在的功能，通过模组就能实现。
新建空白附加包
- 在 MC Studio 左侧导航栏，点击「+新建」按钮
- 在新建页面，找到「空白AddOn」，点击它
- 在弹出窗口中填写项目名称（比如
我的第一个Mod） - 点击「启动编辑」
AddOn 是什么？
AddOn（附加包）是微软为基岩版提供的官方模组支持方式。它通过 JSON 配置文件来修改和添加游戏内容。MC Studio 的编辑器把 JSON 编辑变成了可视化操作，所以你不需要手写任何代码。
点击启动编辑后，MC Studio 会打开编辑器。如果是第一次使用，可能需要下载一些额外资源，请耐心等待。
新版编辑器
如果打开的编辑器界面看起来比较旧，说明你进入的是旧版编辑器。请先关闭编辑器，回到 MC Studio 的「最近」标签页，找到你的作品，点击「编辑」→「升级作品」→ 确认。升级完成后会自动创建一个带有绿色「新版」标记的作品，后续使用新版编辑器进行操作。
设置命名空间
在添加任何内容之前，我们先设置命名空间（Namespace）。
命名空间就像模组的「身份证」——它确保你创建的配方、物品、方块等不会和其他模组冲突。比如你的命名空间是 my_mod，你创建的物品完整名称就是 my_mod:magic_sword，不会和别人的搞混。
设置方法：
- 在编辑器顶部导航栏，点击「作品」→「命名空间」
- 输入你的命名空间，例如
my_first_mod - 点击确认
命名规则
- 只能使用英文字母、数字和下划线
- 大小写不敏感（
Aa和aa视为相同） - 建议全部小写，起一个独特的名字
创建自定义配方
打开新建配方向导
- 在编辑器左侧找到「资源管理」面板
- 点击「新建」按钮
- 在「新建文件向导」中选择「配置」选项卡
- 选择「配方」
- 数据模板选择「空」
- 名称输入
rotten_flesh_to_leather - 点击「创建」
创建成功后，编辑器左下方的「配置」面板会显示刚才新建的配方。
设置配方属性
点击配方，在右侧「属性」面板中设置：
| 属性 | 设置值 |
|---|---|
| 配方类型 | 熔炉配方 |
| 适用方块 | 熔炉 |
| 配方构造（输入） | 点击槽位 → 搜索「腐肉」→ 确认 |
| 配方结果（输出） | 点击文件夹图标 → 搜索「皮革」→ 确认 |
| 结果数量 | 1 |
保存
点击编辑器右上角的「保存」按钮，或按 Ctrl + S。
你做了什么？
编辑器在背后自动生成了一个 JSON 配置文件，大致像这样：
json
{
"format_version": "1.12",
"minecraft:recipe_furnace": {
"description": {
"identifier": "my_first_mod:rotten_flesh_to_leather"
},
"tags": ["furnace"],
"input": "minecraft:rotten_flesh",
"output": "minecraft:leather"
}
}将来你想做更复杂的修改时，也可以直接编辑这些 JSON 文件。现在完全不需要关心。
运行测试
从编辑器内运行
- 点击编辑器右上角的「运行」按钮
- 编辑器自动保存并启动 Mod PC 开发包（专门用于测试的开发版客户端）
- 首次运行需要下载开发包，请耐心等待
从主界面运行
- 回到 MC Studio 主界面，在「最近」标签页找到你的作品
- 点击「开发测试」
- 勾选「创造模式」和「作弊模式」（方便测试）
- 点击「开始」
在游戏中验证
进入游戏后：
- 按
E键打开物品栏（创造模式） - 搜索并拿出：熔炉、腐肉、煤炭
- 放置熔炉，右键打开
- 腐肉放入上方输入格，煤炭放入下方燃料格
- 等待烧制完成——右侧输出格出现了皮革！
恭喜！ 你刚刚成功制作并测试了你的第一个 Mod！
小结
在这一节中，你学会了：
- 在 MC Studio 中新建空白附加包项目
- 设置命名空间，避免与其他模组冲突
- 使用编辑器的「配置」功能创建自定义熔炉配方
- 通过 Mod PC 开发包运行和测试模组
接下来，让我们看看有哪些进阶方向可以继续学习。