Beta APIs 是什么——脚本类模组必须开的实验开关

什么是 Beta APIs

Minecraft 基岩版提供了一套 Script API（脚本 API）让 McPack 作者可以写 JavaScript 来实现复杂的游戏逻辑。这套 API 因为还在迭代完善中，默认是隐藏的实验性功能——需要手动开启才能用。

Beta APIs 开启后：

• McPack 里的 JavaScript 脚本会被加载和执行
• 作者可以用脚本实现自定义命令、复杂 AI、动态 UI 等高级功能
• 不开的话，脚本类 McPack 里的脚本部分完全不运行

怎么开 Beta APIs

位置

在编辑世界页面，左侧菜单往下翻，找到 Experiments（实验性）。

步骤

1. 点 Experiments 进入实验性选项页面
2. 在 Add-on creators 区域找到 Beta APIs 开关
3. 打勾打开
4. 仔细读弹窗——有的弹窗里绿色按钮反而是"取消"，灰色按钮才是"仍然开启"。别点反！

弹窗确认

打开 Beta APIs 时，Minecraft 会弹两个警告：

1. 成就被禁用——这个世界再也拿不到成就了（详见成就被禁用）
2. 开关是单向的——开启后无法关闭（详见开关是单向的）

这两个警告都要确认后才能开启。

哪些包需要开 Beta APIs

一般来说：

• 带 Script API / 脚本功能的 McPack 需要开
• 普通的行为包（只改实体行为，不用脚本）不需要开
• McPack 详情页介绍里如果提到"需要 Beta APIs"或"需要开启实验性"，就一定要开

经验判断：如果一个包声称能"添加新游戏机制"、"有自定义命令"、"有动态 UI"——大概率是脚本类，需要 Beta APIs。

老教程里的 Holiday Creator Features

早期有些 McPack 需要开 Holiday Creator Features，但这个实验开关在 Minecraft 1.21.20 版本已经被移除了。现在脚本类模组只需要开 Beta APIs 这一项。自定义方块、物品等功能也已经转正，不再需要额外开关。