UERunner

UERunner 是一个用于构建和运行 Unreal Engine 工程的 Windows 版 Visual Studio Code 扩展。

系统要求

• Windows
• Unreal Engine 4 或 Unreal Engine 5
• .uproject 中包含有效的 EngineAssociation
• 暂不支持通过 Remote SSH、WSL 或 Dev Container 构建远程工程

功能

编辑器标题栏中提供四个按钮，位于“向右拆分编辑器”按钮左侧：

• 重新选择工程：选择新的 .uproject 文件，仅更新当前工程，不触发构建或运行。
• 构建：调用引擎的 Engine/Build/BatchFiles/Build.bat，在 VS Code 任务终端中显示日志。
• 构建并运行：构建成功后自动启动 UE5 的 UnrealEditor.exe 或 UE4 的 UE4Editor.exe。
• 运行：自动识别 UE4/UE5 编辑器程序并打开工程。

使用

1. 在 VS Code 中打开一个工作区。
2. 首次点击任一 UERunner 按钮，选择目标 .uproject 文件。
3. UERunner 将所选文件保存在 VS Code 内部工作区状态中，并以其所在目录作为工程根目录；同一目录可以存在多个 .uproject。
4. UERunner 读取所选 .uproject 的 EngineAssociation，自动查找对应引擎。

也可以通过命令面板执行：

• UERunner: 重新选择 .uproject 工程文件
• UERunner: 选择构建配置

配置

引擎查找顺序：

1. HKCU\SOFTWARE\Epic Games\Unreal Engine\Builds 中与 EngineAssociation 同名的源码引擎注册项。
2. Epic Games Launcher 的 LauncherInstalled.dat。
3. Epic 安装版引擎注册项。
4. Program Files\Epic Games\UE_<版本> 默认安装位置。

开发

npm install
npm run compile

按 F5 启动扩展开发宿主进行调试。