我的世界手机版JS脚本怎么加载运行

一、区分两种手机版 JS 脚本机制

很多玩家在网络上获取到一个以 .js 结尾的脚本后，直接放入手机文件夹却发现没有任何反应，其根本原因在于没有区分脚本适用的底层环境。手机版 Minecraft 的脚本生态经历过重大的架构演进：

二、经典 ModPE 脚本（.js）的加载与运行全流程

如果手头获取的脚本是经典的单文件代码（例如脚本内部含有 function useItem()、function procCmd()、clientMessage() 等特征函数），必须通过方块启动器进行挂载运行。

1. 运行前准备

• 安装对应版本的游戏本体：ModPE 脚本对版本高度敏感，常用版本为 MCPE 0.14.0、0.16.0 或 1.0.0 稳定版。
• 安装版本匹配的方块启动器：启动器（BlockLauncher / BlockLauncher Pro）的版本必须与 MCPE 安装包严格一致，否则打开时会报“版本不匹配”或闪退。
• 准备并存放脚本文件：将 .js 文件下载或传输到手机易于访问的目录，例如系统根目录下的 /Download 或 /games 文件夹。

2. 详细导入步骤

1. 打开方块启动器：不要直接启动原版 MCPE 图标，而是点击启动方块启动器。进入游戏标题主界面后，可以看到顶部中央多出了一个白色的“扳手”图标。
2. 进入脚本管理器：点击扳手图标，在弹出的下拉菜单中点击选择“ModPE 脚本”（Manage ModPE Scripts）。
3. 开启脚本引擎支持：进入管理界面后，检查最上方的总开关是否已设置为开启状态（若显示为关闭，请点击切换为开启）。
4. 导入本地文件：点击界面右下角或顶部的“+”号按钮（部分版本显示为“输入/Import”），在弹出的选择源中选择“本地存储”（Local storage）。
5. 定位并选择脚本：在文件浏览器中导航至预先存放脚本的目录（如 /Download），找到对应的 .js 文件并轻触选中。
6. 确认启用状态：导入后，列表将显示该脚本条目。确认条目后方状态为“已启用”（Enabled）。如果显示为“已禁用”（Disabled），单击条目后在弹窗中选择“启用”即可。
7. 返回游戏主界面：按手机返回键退回游戏主界面，此时启动器会自动重载脚本解释器。

3. 基础测试脚本示例

为验证脚本加载流程是否正常工作，可以使用文本编辑器创建名为 test_modpe.js 的测试脚本，内容如下：

// ModPE 基础测试脚本
function newLevel() {
    clientMessage("§a[系统提示] ModPE JavaScript 脚本加载成功！");
    clientMessage("§e使用木棍点击地面可触发测试效果。");
}

function useItem(x, y, z, itemId, blockId, side) {
    // 280 为木棍 (stick) 的标准物品 ID
    if (itemId === 280) {
        clientMessage("§b你正在使用木棍点击坐标：(" + x + ", " + y + ", " + z + ")");
        // 在所点击方块上方生成粒子提示
        Level.explode(x, y + 1, z, 0.5);
    }
}

三、现代基岩版官方 JavaScript 行为包的加载运行

随着官方 Bedrock Script API（前身为 GameTest 框架）的完善，在 1.19、1.20 等新版本中，官方直接支持在行为包（Behavior Pack）中编写 JavaScript/TypeScript 脚本，无需任何外挂启动器即可跨平台稳定运行。

1. 行为包工程结构配置

一个包含脚本的基岩版行为包标准目录结构如下：

MyScriptPack_BP/
├── manifest.json        # 行为包清单文件（配置脚本模块与依赖）
├── pack_icon.png        # 行为包封面图片
└── scripts/
    └── main.js          # JavaScript 业务主逻辑

其中关键的 manifest.json 必须声明 client 或 server 脚本模块，并引用官方 @minecraft/server 库：

{
  "format_version": 2,
  "header": {
    "name": "官方JS脚本测试行为包",
    "description": "基于 Minecraft Bedrock Script API 构建",
    "uuid": "4c94f590-bdf1-4a57-8b01-e2d933758b01",
    "version": [1, 0, 0],
    "min_engine_version": [1, 20, 0]
  },
  "modules": [
    {
      "description": "脚本逻辑模块",
      "type": "script",
      "language": "javascript",
      "uuid": "8b5f36e2-2a91-4df2-a39c-148e10d29381",
      "version": [1, 0, 0],
      "entry": "scripts/main.js"
    }
  ],
  "dependencies": [
    {
      "module_name": "@minecraft/server",
      "version": "1.8.0-beta"
    }
  ]
}

在 scripts/main.js 中编写现代标准的 JavaScript 代码：

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

// 监听玩家聊天事件
world.beforeEvents.chatSend.subscribe((event) => {
    const player = event.sender;
    const msg = event.message;

    if (msg === "!ping") {
        event.cancel = true; // 阻止消息公开发送
        system.run(() => {
            player.sendMessage("§a[脚本响应] pong！当前世界时间刻: " + system.currentTick);
        });
    }
});

2. 手机端安装与生效步骤

1. 打包与文件命名：将 MyScriptPack_BP 文件夹打包压缩为 zip 文件，随后直接重命名其后缀为 .mcpack。
2. 调用游戏打开：在手机文件管理器中点击该 .mcpack 文件，系统会弹窗提示打开方式，选择“Minecraft”即可自动调起游戏并完成导入。
3. 激活行为包：在创建新世界或点击既有世界的编辑按钮（笔形图标）中，在左侧菜单点击“行为包”（Behavior Packs），在“我的包”中找到刚才导入的包，点击“激活”。
4. 开启实验性玩法（关键步骤）：点击左侧的“实验”（Experiments）标签页，在右侧列表中找到并勾选开启“Beta APIs”（或测试版 API）。如果未开启此项，游戏引擎将为了安全直接跳过脚本加载。
5. 进入游戏验证：进入世界后在聊天框输入 !ping，若收到 [脚本响应] pong！ 则说明脚本已成功启动。

四、脚本加载异常排查与常见问题

在实际配置过程中，脚本未能按照预期运行通常与版本断层、文件伪装或环境权限缺失有关。下表梳理了排查思路：

五、操作总结与使用建议

要在手机上顺利运行《我的世界》JS 脚本，关键在于对号入座：对于早期经典 ModPE 脚本，务必在能够兼容旧版启动器的环境中，通过方块启动器的管理菜单单文件导入；对于新版玩家与开发者，则应当全面转向官方行为包 Script API 体系，规范编写 manifest.json 并在世界设置中打开实验性 Beta APIs 开关。遵循规范的目录层级和逐步调试流程，就能稳定地在手机端实现各类自定义游戏玩法。