五分钟做出你的第一个Add-On【我的世界基岩版附加包教程#1】

什么是 Add-on 附加包？

Add-on（附加包），俗称基岩版模组，是一种可下载、可分发的包格式。它通过一套编程接口，允许玩家在《我的世界》中提供超出原版游戏的自定义玩法，包括：

• 自定义内容： 实体、方块、物品、生物群系、结构及用户界面（UI）等。
• 三大组成部分：
  1. 材质包（资源包）： 控制外观。
  2. 行为包： 控制行为。
  3. 脚本： 控制逻辑。

---

开发工具准备

本教程不使用 VS Code 等复杂编码工具，而是使用官方附加包编辑工具。

• 工具性质： 基于网页的编辑器（MCTool），适用于 Windows 和移动版。
• 访问地址：https://mctools.dev/

---

开启你的第一个项目

1. 创建项目： 进入网站后，点击“创建一个附加包”。
2. 项目命名： 例如命名为 MyFirstAddon。
3. 存储选择：
   • 浏览器： 直接保存在缓存中。
   • 本地： 选择文件夹保存在电脑硬盘上。
4. 模式切换： 为了简化操作，点击“设置”，将编辑器偏好改为精简模式，隐藏目前用不到的复杂功能。

• 左侧： 文件资源管理栏。
• 上方： 操作菜单栏。
• 中间： 文件编辑核心区域。
• 仪表盘： 显示项目名称、作者及简介。

---

编写脚本逻辑：Hello World

Add-on 的核心逻辑位于 游戏逻辑（Game Logic） 中的脚本文件（如 main.ts）。

1. 核心概念：Tick

• MC 中通过 Tick 来计时，通常一秒有 20 个 Tick。

• 脚本中的 mainTick 函就是主循环，随游戏运行不断执行。

2. 代码实现

在 main.ts（TypeScript 文件）中，通过递归调用实现循环运行。

• 代码示例：

import { world, system } from "@minecraft/server";

function mainTick() {

    world.sendMessage("Hello World");
  system.run(mainTick);
}

system.run(mainTick);

• 效果： 当附加包加载并进入世界后，聊天框每秒会刷出 “hello world” 信息。

---

导出与测试

项目完成后，需要将其导入游戏进行实测。

1. 导出方式：
   • Download Ad： 直接导出 .mcaddon 格式文件。
   • Test（导出世界）： 导出包含该 Add-on 的超平坦世界档（.mcworld），测试最方便。
2. 导入游戏： 双击导出的文件，MC 会自动启动并显示“导入开始”。
3. 生效检查： 在世界的“行为包”设置中，确保已勾选刚才创建的包。
4. 运行结果： 进入世界后，看到左上角疯狂输出 “hello world”，即代表制作成功！

---

💡 小贴士

• 导入失败怎么办？ 可以尝试使用编辑器中的“导入世界”按钮重新选择文件。
• 逻辑入口： main 是整个附加包的入口，加载后会默认执行其中的所有内容。

---

结语： 这只是 Add-on 开发的第一步。掌握了基础的导出和脚本运行逻辑，你就可以开启更高级的自定义模组制作之路了！