用途 project-settings 技能面向 Unreal Engine 项目设置与编辑器偏好的配置工作,可通过 execute_python_code 执行 Python 脚本完成设置读写。资料中提到的覆盖范围包括 UI 外观、工具栏图标、缩放、颜色,以及任意 UDeveloperSettings 子类。
主要能力 根据资料,该技能当前主要由两部分构成:一是引擎原生 ConfigSettingsToolset,用于按名称访问已注册的设置类别(如 general、maps、EditorStyleSettings 等),需通过 call_tool 调用,可先执行 describe_toolset 查看其 actions/params;二是 VibeUE 的 ProjectSettingsService,提供 discover_settings_classes 用于发现设置类,以及直接 INI 读写能力:get_ini_value、set_ini_value、*_ini_array、list_ini_sections、list_ini_keys,并可调用 save_all_config 保存配置。INI 写入方法返回 FProjectSettingResult(Python 中为 ProjectSettingResult),包含 success、error_message 等字段,需要检查。
使用方式 资料给出了若干脚本示例:设置项目信息(ProjectName、CompanyName、Description)写入 DefaultGame.ini 的 /Script/EngineSettings.GeneralProjectSettings 段;配置默认地图 GameDefaultMap 写入 DefaultEngine.ini;设置编辑器启动地图 EditorStartupMap 写入 EditorPerProjectUserSettings.ini;通过 discover_settings_classes 遍历设置类并按关键字查找设置;通过 list_ini_keys 列举某段的所有键并读取值;以及对 EditorStyleSettings 直接写入 INI(示例为 AssetEditorOpenLocation=MainWindow)。所有脚本通过 execute_python_code 执行。
适用场景 适用于需要在 Unreal Engine 中批量或脚本化修改项目设置、查询设置所在 INI 段与文件、读取与写入配置键值、发现可用的设置类,以及配置编辑器外观相关偏好的场景。
限制与注意事项 资料明确列出若干关键规则:EditorStyleSettings 无法通过 discover_python_class 发现,会返回 PYTHON_CLASS_NOT_FOUND,需通过引擎 ConfigSettingsToolset 或直接写 INI;注册设置类别由引擎 ConfigSettingsToolset 处理,VibeUE 侧按 INI 段、键、文件寻址;地图路径必须使用完整资产路径(如 /Game/Path/To/Level.Level),设置前应先用 does_asset_exist 验证;INI 写入后需检查返回结果的 success 与 error_message。此外,如需保存当前关卡再设为启动地图,资料提示编辑器 world 应通过 unreal.get_editor_subsystem(unreal.UnrealEditorSubsystem).get_editor_world() 获取,再用 unreal.EditorLoadingAndSavingUtils.save_map 保存。