VS Code中Minecraft基岩版调试器报错的含义及解决方法

错误消息含义 #

Session terminated, protocol error. No Minecraft Add-Ons found

该错误表示VS Code的「Minecraft Bedrock Edition Debugger」扩展在连接Minecraft实例时，无法定位到你指定的Add-On脚本模块，导致调试会话被迫终止。即便游戏能识别并允许添加你的Add-On，调试器的连接逻辑仍可能因配置或加载问题找不到目标模块——这也是你看不到「All systems GO!」消息的核心原因：脚本并未实际在游戏中运行。

典型解决方法 #

1. 修正依赖版本兼容性 #

你的manifest.json中，@minecraft/vanilla-data版本为[1,21,44]，但min_engine_version仅为[1,20,30]，版本不匹配会导致脚本加载异常。将@minecraft/vanilla-data的版本修改为与引擎版本兼容的数值：

{
    "module_name" : "@minecraft/vanilla-data",
    "version" : [1,20,30]
}

2. 确认VS Code工作区根目录 #

launch.json中的localRoot设置为${workspaceFolder}/scripts/，要求你在VS Code中打开的工作区根目录必须是包含manifest.json的文件夹。若直接打开scripts文件夹，路径会指向错误位置，调试器无法关联到Add-On模块。

3. 验证世界的Add-On加载状态 #

• 确保创建/编辑世界时，已将该Add-On添加到「行为包」列表并启用；
• 进入游戏后执行命令/script modules，查看输出中是否包含你的脚本模块UUID（7c1970f3-5784-4e85-b275-1af25e037886）。若没有，说明游戏未实际加载脚本，需重新检查世界设置或重新导入Add-On。

4. 确认调试模式配置 #

• 打开Minecraft「设置」→「创作者」→「启用脚本调试」，确保该选项已开启；
• 确认launch.json中的port（19144）与Minecraft调试端口一致，若端口被占用，可更换为19145等未被使用的端口，并同步修改Minecraft的调试端口设置。

5. 测试脚本加载状态 #

修改main.js添加即时触发的测试代码，验证脚本是否实际运行：

import { world, system } from "@minecraft/server";
import * as vanilla from "@minecraft/vanilla-data"

// 玩家进入世界时发送消息，验证脚本加载状态
world.events.playerSpawn.subscribe(() => {
    world.sendMessage("Script loaded successfully!");
});

function mainTick() {
  if (system.currentTick === 400) {
    world.sendMessage("All systems GO!");
  }
  system.run(mainTick);
}

system.run(mainTick);

额外检查点 #

• 确认launch.json中的targetModuleUuid与manifest.json内脚本模块的UUID完全一致（大小写、字符无遗漏）；
• 重启Minecraft和VS Code，避免缓存导致的加载异常；
• 确保游戏版本不低于min_engine_version（1.20.30），若游戏版本更高，可适当提高min_engine_version以匹配实际版本。

内容的提问来源于stack exchange，提问作者user4574