원클릭으로 Manus에서 모든 스킬 실행

unreal-vs-project-generation

스타16

포크3

업데이트2026년 7월 8일 23:13

Use when Unreal Engine Visual Studio project file generation fails or appears ineffective after engine upgrade, EngineAssociation changes, Generate Visual Studio project files, UnrealVersionSelector, UnrealBuildTool -ProjectFiles, .sln/.slnx stale engine paths, Rider or MSBuild reports MSB4019 for Microsoft.Cpp.Default.props / VCTargetsPath, VS/UBT unexpectedly compiles thousands of engine actions after no code changes, .uproject/.uplugin JSON encoding errors, UBT Log_GPF.txt diagnostics, UE 5.8 target upgrade prompts, or editor launch is blocked after generated project files.

설치

Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.

Manus에서 실행

출처

OrionUE

OrionUE/Orion_FreeEdition

GitHub 저장소 열기 Creator 저장소 보기

다운로드

Manus에서 실행

Unreal VS Project Generation

用于排查 Unreal Engine 生成 Visual Studio 工程文件失败、右键 Generate Visual Studio project files 无效果、升级引擎后 .sln 仍指向旧引擎、或 UBT 生成工程被 .uproject / .uplugin 描述文件阻断的问题。

工作流

先读取 .uproject 的 EngineAssociation，再查本机 UnrealVersionSelector / 注册表 / Launcher 安装记录，确认它能解析到真实 <ENGINE_ROOT>。
不相信现有 .sln：搜索 .sln、.slnx、Intermediate/ProjectFiles/*.props 和 .vcxproj 中的旧 <ENGINE_ROOT>，确认生成结果是否真的更新。
右键生成无反馈时，直接运行当前引擎的 UBT：<ENGINE_ROOT>/Engine/Binaries/DotNET/UnrealBuildTool/UnrealBuildTool.exe -ProjectFiles -Project=<PROJECT_ROOT>/<Project>.uproject -Game -Engine -Progress。
读取 %LOCALAPPDATA%/UnrealBuildTool/Log_GPF.txt，以第一处 UBT error / exception 为准排查，不要只看资源管理器菜单是否弹窗。
如果报 .uplugin / .uproject JsonReaderException、invalid start of a value 或 0xFF，优先检查描述文件是否是 UTF-16 BOM；转换为 UTF-8 no BOM + CRLF 后重新生成。
如果 UBT 报 Target 修改 shared build products 的属性，检查对应 .Target.cs 是否需要移除差异设置、设置 BuildEnvironment = TargetBuildEnvironment.Unique;，或显式 bOverrideBuildEnvironment = true。
生成成功后搜索 .sln、.slnx、Intermediate/ProjectFiles，确认它们已经指向目标 <ENGINE_ROOT>；不要只凭命令 ExitCode 判断。
升级 UE 后继续跑目标 Editor 编译和编辑器启动；如果出现 Target Upgrade Required、旧插件 EngineVersion 弹窗或 V7 严格宏错误，读取 reference 里的 UE 5.8 阻断清单处理。
如果用户说“没改代码却重新编译几千个”，先判别日志类型：UBT C++ action 会有 [1/4000] Compile [x64] ...、Creating/Invalidating makefile；Shader/DDC/PSO 则会有 LogShaderCompilers、FShaderJobCacheShaders、LogTexture: Building texture、LogPSOHitching、Niagara Compiling。确认是 UBT action 后，优先看 Invalidating makefile ... (<Reason>)；DefaultEngine.ini modified 会让 Editor target、ShaderCompileWorker 等 makefile 失效，Rider/VS Build 会重新跑 UBT。再检查 .uproject 是否从版本号 5.x 变成注册表 GUID，或 .sln / Intermediate/ProjectFiles/UECommon.props 是否从安装版引擎切到源码引擎；这种引擎身份变化会让 UBT/VS 走另一套构建产物。还要检查 .sln、UECommon.props 和 UBT log 是否从 VS2022/MSVC 14.4x 自动切到 VS2026/MSVC 14.50+；工具链族切换会让旧 obj 不能复用，表现为没改项目源码却全量重编。
-SkipBuild 只用于“临时打开已有 Editor 做资产、不需要编译 C++”的救急路径；日常改项目 C++ 时不要启用它，否则项目代码也不会编译。用户要求“项目代码要编译，但不准再次编译源码 Editor/Engine 产物”时，优先给 Editor NMake 命令加 -NoEngineChanges，需要检查、临时启用或撤销时运行 scripts/set-editor-no-engine-changes.ps1 -Mode Check|Apply|Remove。
如果用户需要“源码版引擎只完整编译一次，之后 IDE 只编项目改动”，不要混用手写 Build.bat 参数、-Module、-NoLiveCoding 和 IDE 生成的 NMake 命令。以 Intermediate/ProjectFiles/<Project>.vcxproj 里的 NMakeBuildCommandLine 为准，二次验证必须使用同一条命令。
如果 XGE/UBA 或中断构建导致源码引擎基线不稳定，使用 scripts/set-local-ubt-build-stability.ps1 -Mode Check|Apply|Remove 管理项目本地 Saved/UnrealBuildTool/BuildConfiguration.xml，优先禁用 XGE、禁用 UBA detour 并限制并发；构建成功后立刻用同一条 IDE 命令验证 0 action(s)。

路由

读取或修改 .uproject、.uplugin、Target、Build.cs 或 EngineAssociation 时，配合 ../orion-project-config/SKILL.md 和 ../orion-framework-architecture/SKILL.md。
需要查 TargetRules、UBT、引擎版本差异或项目源码依赖时，配合 ../unreal-source-code-navigator/SKILL.md。
需要转换 .uplugin / .uproject 编码、CRLF 或机械重写文本时，先读取 ../orion-code-style/SKILL.md，再配合 ../crlf-mechanical-formatting/SKILL.md。
如果排查过程产出新的可复用失败模式，配合系统 skill-creator 和 ../orion-framework-skill-authoring/SKILL.md 更新本 Skill 或相邻路由。

Reference

读取 references/unreal-vs-project-generation.zh-CN.md 获取 UBT 命令模板、BOM 扫描/转换命令、验证清单和常见失败处理。

이 저장소의 다른 Skills

같은 저장소

crlf-mechanical-formatting

OrionUE/Orion_FreeEdition

Use when bulk-formatting or mechanically rewriting Windows text/code files in this repo with PowerShell, especially to preserve CRLF line endings, normalize Tab indentation, avoid LF-only output, protect copyright header blocks, and validate touched Unreal plugin/source files after formatting.

2026-07-0816

orion-asset-management

OrionUE/Orion_FreeEdition

Use before creating, renaming, moving, importing, converting, validating, batch-editing, saving, or organizing Unreal Engine assets and Blueprint assets, including Materials, Material Instances, Physical Materials, Python phys_material edits, Blueprint classes, Blueprint Components, Blueprint Function Libraries, Blueprint Interfaces, Widget Blueprints, Animation Blueprints, Gameplay Ability assets, audio assets, cinematics, localization, movie files, Bink/Media assets, Splash startup images under Content/Splash, ProjectAcoustic or ProjectAcoustics content, system assets, UI assets, and GameFeatures plugin Content folders. Enforces Allar-style asset prefixes, Blueprint naming rules, folder naming rules, project Content taxonomy, save verification, and GameFeatures content layout.

2026-07-0816

orion-audio-framework

OrionUE/Orion_FreeEdition

Use when Codex works on Unreal Engine audio in this framework: Content/Audio assets, Content/Acoustics, SoundClass, SoundConcurrency, SoundSubmix, SoundControlBus, ControlBusMix, AudioModulation, AudioMixer, MetaSound, ProjectAcoustics, SteamAudio, OrionVoiceChat, voice chat, microphone input, audio output device switching, CoreAudioSettings, GameSettingRegistry_Audio, UAudioMixEffectsSubsystem, spatialization, reverb, occlusion, HDR/LDR audio, or DefaultEngine/DefaultGame audio configuration.

2026-07-0816

orion-audio-system

OrionUE/Orion_FreeEdition

Use when working on the project-local OrionAudioSystem plugin, audio generation components, Blueprint audio playback APIs, runtime attenuation updates, USoundBase/USoundAttenuation playback, multiplayer replicated one-shot audio, Blueprint component visibility/loading issues, or VerifyImport failures for /Script/OrionAudioSystem in Plugins/Audio/OrionAudioSystem. Use for requests mentioning OrionAudioSystem, UOrionAudioGenerationComponent, UOrionFireAndForgetAudioGenerationComponent, 音频生成组件, 世界位置播放音频, 实时衰减, 多人都能听到声音, 组件消失, or 蓝图重新加载后才显示.

2026-07-0816

orion-browser-framework

OrionUE/Orion_FreeEdition

Use when implementing, modifying, debugging, packaging, or validating the OrionBrowser plugin, CEF browser kernel integration, OrionCEF3 third-party artifacts, OrionBrowserHelper subprocess, UOrionBrowserWidget, UGameUIWebBrowser, HTML popup browser content, browser cursor policy, mouse cursor hand/grab issues, H.264/AAC video playback, or browser runtime staging for Win64/Steam.

2026-07-0816

orion-code-style

OrionUE/Orion_FreeEdition

Use when editing, creating, refactoring, formatting, especially Unreal C++ .h .cpp, ModuleRules .Build.cs, TargetRules .Target.cs, comments, includes, lambdas, naming, copyright headers, custom copyright header config, author/date header fields, CRLF, and Tab indentation.

2026-07-0816

name

unreal-vs-project-generation

description

Unreal VS Project Generation

工作流

先读取 .uproject 的 EngineAssociation，再查本机 UnrealVersionSelector / 注册表 / Launcher 安装记录，确认它能解析到真实 <ENGINE_ROOT>。
不相信现有 .sln：搜索 .sln、.slnx、Intermediate/ProjectFiles/*.props 和 .vcxproj 中的旧 <ENGINE_ROOT>，确认生成结果是否真的更新。
右键生成无反馈时，直接运行当前引擎的 UBT：<ENGINE_ROOT>/Engine/Binaries/DotNET/UnrealBuildTool/UnrealBuildTool.exe -ProjectFiles -Project=<PROJECT_ROOT>/<Project>.uproject -Game -Engine -Progress。
读取 %LOCALAPPDATA%/UnrealBuildTool/Log_GPF.txt，以第一处 UBT error / exception 为准排查，不要只看资源管理器菜单是否弹窗。
如果报 .uplugin / .uproject JsonReaderException、invalid start of a value 或 0xFF，优先检查描述文件是否是 UTF-16 BOM；转换为 UTF-8 no BOM + CRLF 后重新生成。
如果 UBT 报 Target 修改 shared build products 的属性，检查对应 .Target.cs 是否需要移除差异设置、设置 BuildEnvironment = TargetBuildEnvironment.Unique;，或显式 bOverrideBuildEnvironment = true。
生成成功后搜索 .sln、.slnx、Intermediate/ProjectFiles，确认它们已经指向目标 <ENGINE_ROOT>；不要只凭命令 ExitCode 判断。
升级 UE 后继续跑目标 Editor 编译和编辑器启动；如果出现 Target Upgrade Required、旧插件 EngineVersion 弹窗或 V7 严格宏错误，读取 reference 里的 UE 5.8 阻断清单处理。
如果用户说“没改代码却重新编译几千个”，先判别日志类型：UBT C++ action 会有 [1/4000] Compile [x64] ...、Creating/Invalidating makefile；Shader/DDC/PSO 则会有 LogShaderCompilers、FShaderJobCacheShaders、LogTexture: Building texture、LogPSOHitching、Niagara Compiling。确认是 UBT action 后，优先看 Invalidating makefile ... (<Reason>)；DefaultEngine.ini modified 会让 Editor target、ShaderCompileWorker 等 makefile 失效，Rider/VS Build 会重新跑 UBT。再检查 .uproject 是否从版本号 5.x 变成注册表 GUID，或 .sln / Intermediate/ProjectFiles/UECommon.props 是否从安装版引擎切到源码引擎；这种引擎身份变化会让 UBT/VS 走另一套构建产物。还要检查 .sln、UECommon.props 和 UBT log 是否从 VS2022/MSVC 14.4x 自动切到 VS2026/MSVC 14.50+；工具链族切换会让旧 obj 不能复用，表现为没改项目源码却全量重编。
-SkipBuild 只用于“临时打开已有 Editor 做资产、不需要编译 C++”的救急路径；日常改项目 C++ 时不要启用它，否则项目代码也不会编译。用户要求“项目代码要编译，但不准再次编译源码 Editor/Engine 产物”时，优先给 Editor NMake 命令加 -NoEngineChanges，需要检查、临时启用或撤销时运行 scripts/set-editor-no-engine-changes.ps1 -Mode Check|Apply|Remove。
如果用户需要“源码版引擎只完整编译一次，之后 IDE 只编项目改动”，不要混用手写 Build.bat 参数、-Module、-NoLiveCoding 和 IDE 生成的 NMake 命令。以 Intermediate/ProjectFiles/<Project>.vcxproj 里的 NMakeBuildCommandLine 为准，二次验证必须使用同一条命令。
如果 XGE/UBA 或中断构建导致源码引擎基线不稳定，使用 scripts/set-local-ubt-build-stability.ps1 -Mode Check|Apply|Remove 管理项目本地 Saved/UnrealBuildTool/BuildConfiguration.xml，优先禁用 XGE、禁用 UBA detour 并限制并发；构建成功后立刻用同一条 IDE 命令验证 0 action(s)。

路由

读取或修改 .uproject、.uplugin、Target、Build.cs 或 EngineAssociation 时，配合 ../orion-project-config/SKILL.md 和 ../orion-framework-architecture/SKILL.md。
需要查 TargetRules、UBT、引擎版本差异或项目源码依赖时，配合 ../unreal-source-code-navigator/SKILL.md。
需要转换 .uplugin / .uproject 编码、CRLF 或机械重写文本时，先读取 ../orion-code-style/SKILL.md，再配合 ../crlf-mechanical-formatting/SKILL.md。
如果排查过程产出新的可复用失败模式，配合系统 skill-creator 和 ../orion-framework-skill-authoring/SKILL.md 更新本 Skill 或相邻路由。

Reference

读取 references/unreal-vs-project-generation.zh-CN.md 获取 UBT 命令模板、BOM 扫描/转换命令、验证清单和常见失败处理。