前言¶
Unreal Engine 5.x 的 Python 编辑器脚本能力很强，但要让脚本真正可用，需要熟记大量 API、理解工程化实践（进度条、撤销、异步分帧），还要处理资产、材质、关卡等具体场景。对开发者来说，从零搭建一套可复用的自动化脚本框架成本较高。
这是什么¶
UE Python Scripting 是一个 AI 编程助手 Skill，专门用于快速编写 Unreal Engine 编辑器 Python 脚本。它内置 UE 5.x 完整 API 参考、标准开发工作流和即用代码模板，当你提出 UE Python 相关需求时，AI 会自动加载这些知识，直接生成可运行的高质量脚本。
核心能力¶
Skill 内置了以下能力，覆盖资产、材质、关卡、编辑器扩展和工程化实践：
- 资产管理：批量重命名、移动、复制、删除、查询资产（涉及 EditorAssetLibrary / EditorAssetSubsystem）。
- 资产导入导出：FBX、OBJ、纹理、音频等批量导入导出（涉及 AssetImportTask / AssetTools）。
- 材质编辑：创建材质实例、设置参数、编辑材质图节点（MaterialEditingLibrary）。
- 关卡操作：Actor 查询、生成、修改、选择、批量处理（EditorActorSubsystem / LevelEditorSubsystem）。
- 静态网格体：LOD 设置、碰撞配置、Nanite 开关（StaticMeshEditorSubsystem）。
- 蓝图操作：加载蓝图类、修改默认属性（EditorAssetLibrary / get_default_object）。
- 编辑器扩展：注册自定义工具菜单项（ToolMenus）。
- 工程化实践：进度条（ScopedSlowTask）、撤销支持（ScopedEditorTransaction）、异步分帧执行。
安装与启用¶
- 打开支持 Skill 的 AI 编程助手。
- 进入 Skill 管理 面板。
- 选择 添加 Skill。
- 选择本项目文件夹（包含 skill.json 和 SKILL.md 的目录）。
- 完成。
安装后无需额外配置。在对话中直接描述需求即可，例如：
帮我写一个脚本，批量把 /Game/Meshes 下所有静态网格体加上 SM_ 前缀
写一个 Python 脚本，从 D:/Assets 文件夹导入所有 FBX 到 /Game/ImportedMeshes
帮我创建一组材质实例，父材质是 M_Master，分别设置不同的 Roughness 和 BaseColor 贴图
写个脚本查找关卡中所有 PointLight，把亮度统一改成 5000
帮我注册一个自定义编辑器菜单，点击后执行我的批处理脚本
内置代码模板¶
templates/ 目录提供 5 个即用模板，可直接复制到 UE 项目中运行：
- asset_batch_processor.py：资产批处理框架（修改 process_asset() 即可自定义逻辑）。
- import_assets.py：从本地文件夹批量导入资产到 UE 项目。
- material_instance_creator.py：批量创建材质实例并配置参数。
- level_actor_operations.py：关卡 Actor 查询、修改、生成工具集。
- editor_menu_tool.py：自定义编辑器工具菜单注册。
前置要求¶
UE 编辑器需启用以下插件（默认已启用）：
- Python Editor Script Plugin
- Editor Scripting Utilities
适用场景与注意¶
适合编写 UE 编辑器自动化脚本、资产流水线工具、批处理工具、自定义编辑器面板。触发关键词包括：UE Python、unreal python、editor script、asset automation、batch process、material instance、UE脚本、UE自动化、虚幻引擎Python。
结尾¶
通过 UE Python Scripting，可以让 AI 助手成为你的 UE 编辑器自动化专家，从需求描述到可运行脚本只需一次对话。官方地址：https://api.skillhub.cn/user_5fb5ccef/ue-python-scripting
