UE Python Scripting

|# ue-python-scripting > Unreal Engine Python 脚本开发 Skill —— 让 AI 助手成为你的 UE 编辑器自动化专家。 --- ## 这是什么？ 一个 AI 编程助手 Skill，专门用于**快速编写 Unreal Engine 编辑器 Python 脚本**。 安装后，当你提出 UE Python 相关需求时，AI 会自动加载 UE 5.x 完整 API 参考、标准开发工作流和即用代码模板，直接生成可运行的高质量脚本。 --- ## 核心能力 | 能力 | 说明 | 涉及 API | |------|------|----------| | 资产管理 | 批量重命名、移动、复制、删除、查询资产 | `EditorAssetLibrary` / `EditorAssetSubsystem` | | 资产导入导出 | FBX、OBJ、纹理、音频等批量导入导出 | `AssetImportTask` / `AssetTools` | | 材质编辑 | 创建材质实例、设置参数、编辑材质图节点 | `MaterialEditingLibrary` | | 关卡操作 | Actor 查询、生成、修改、选择、批量处理 | `EditorActorSubsystem` / `LevelEditorSubsystem` | | 静态网格体 | LOD 设置、碰撞配置、Nanite 开关 | `StaticMeshEditorSubsystem` | | 蓝图操作 | 加载蓝图类、修改默认属性 | `EditorAssetLibrary` / `get_default_object` | | 编辑器扩展 | 注册自定义工具菜单项 | `ToolMenus` | | 工程化实践 | 进度条、撤销支持、异步分帧执行 | `ScopedSlowTask` / `ScopedEditorTransaction` | --- ## 安装方法 1. 打开支持 Skill 的 AI 编程助手 2. 进入 **Skill 管理** 面板 3. 选择 **添加 Skill** 4. 选择本项目文件夹（包含 `skill.json` 和 `SKILL.md` 的目录） 5. 完成 --- ## 使用方式 安装后无需额外配置。直接在对话中描述你的需求即可，例如： ``` 帮我写一个脚本，批量把 /Game/Meshes 下所有静态网格体加上 SM_ 前缀 ``` ``` 写一个 Python 脚本，从 D:/Assets 文件夹导入所有 FBX 到 /Game/ImportedMeshes ``` ``` 帮我创建一组材质实例，父材质是 M_Master，分别设置不同的 Roughness 和 BaseColor 贴图 ``` ``` 写个脚本查找关卡中所有 PointLight，把亮度统一改成 5000 ``` ``` 帮我注册一个自定义编辑器菜单，点击后执行我的批处理脚本 ``` Skill 会自动识别 UE Python 相关请求，加载完整 API 知识库，生成带进度条、错误处理、保存逻辑的可直接运行脚本。 --- ## 内置代码模板 `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** --- ## 触发关键词 以下关键词会自动激活本 Skill： `UE Python` · `unreal python` · `editor script` · `asset automation` · `batch process` · `material instance` · `UE脚本` · `UE自动化` · `虚幻引擎Python` --- ## 版本 - Skill 版本：1.0.0 - API 参考基于：Unreal Engine 5.6 - 兼容 UE 版本：5.0+（自动适配新旧 API）