SuperAPI AI 工具集

engine-settings

编程与开发

查看项目

更新于 11-06 16:22

技能介绍

用途:该技能面向 Unreal Engine 项目的引擎级配置管理。它的能力边界已被明确划分:按类别注册的设置(如 RendererSettings)改用 Unreal 5.8 原生 ConfigSettingsToolset,通过 call_tool 调用并运行 describe_toolset 查看动作与参数;VibeUE 的 EngineSettingsService 则保留引擎未覆盖的部分,包括控制台变量(cvars)、可扩展性等级、原始引擎 INI 读写和配置保存。

主要能力:

  1. 控制台变量:使用 unreal.EngineSettingsService.get_console_variable 和 set_console_variable 读取或设置 r.ReflectionMethod 等 cvar;可用 set_console_variables_from_json 批量设置,用 search_console_variables 搜索。
  2. 只读检查:通过 get_console_variable_info 填充 ConsoleVariableInfo,确认 is_read_only 后再写入。
  3. 可扩展性:使用 set_overall_scalability_level 设置总体等级,示例中 Low 为 0。
  4. 引擎 INI:使用 get_engine_ini_value 和 set_engine_ini_value 按节/键读写,如 /Script/Engine.RendererSettings、bEnableRayTracing、Engine.ini;支持 save_all_engine_config 保存配置。
  5. 已注册设置:交由引擎 ConfigSettingsToolset 按类别浏览和编辑,覆盖渲染、物理、音频、GC、网络、碰撞、AI、输入等类别。

使用方式:通过 execute_python_code 运行 Python 脚本。设置类方法返回 EngineSettingResult(Python 中无 F 前缀),包含 success、error_message、modified_settings、failed_settings 和 requires_restart;requires_restart 用于判断变更是否立即生效。

适用场景:启用光线追踪(r.RayTracing、阴影、反射等)、性能优化(关闭昂贵特性、限制阴影分辨率、设置可扩展性)、搜索与批量配置 cvars、直接读写已知键的引擎 INI。

限制:注册设置的按类别访问已迁移至引擎工具集,旧有的 get_setting/set_setting/list_categories/list_settings 已在 5.8 整合中移除;部分设置需重启才能生效;产品收费、价格和平台支持等信息暂未提供。