技能介绍

问题

在 Unreal Editor 中用 Python 做资产批量重命名、材质创建、Actor 迭代、LOD 设置等项目自动化时，常见卡点不是写循环，而是 API 版本差异和编辑器上下文约束：UE 4/5.0 偏 Library API，UE 5.1+ 更推荐 Subsystem API；路径必须 /Game/...，修改后要保存，材质要重编译，批量操作要进度条，PIE 下多数编辑器 API 不可用。技能把这些问题整理成可执行的脚本开发 SOP。

工作方式

它会把需求落到具体 UE Python 方案：先确认 UE 版本、运行场景、是否一次执行或菜单集成，再选择 EditorAssetSubsystem、EditorActorSubsystem、MaterialEditingLibrary、StaticMeshEditorSubsystem 等对应 API。生成的脚本通常以 import unreal 开头，配置变量前置，使用 unreal.ScopedSlowTask 处理 10 个以上项目，try/except 包住危险操作，并用 unreal.log() 输出结果。对资产修改会提醒启用 Python Editor Script Plugin、Editor Scripting Utilities 等插件，必要时用 ScopedEditorTransaction 支持撤销。

适用边界

适合 Unreal 编辑器自动化脚本：资产导入/导出、Data Table、Sequencer、编辑器菜单、批量配置。不适合运行时游戏逻辑或 PIE 内依赖编辑器 API 的场景。若项目路径、插件状态或 UE 版本不匹配，脚本可能静默失败；交付前应检查 API 名称、路径格式、保存调用、进度条和取消逻辑。