Python脚本管理器 (Python Script Manager)

一个强大的Unreal Engine 5编辑器插件，用于管理和执行Python脚本，提供参数化执行、批量处理、脚本分类等高级功能。

✨ 主要功能

🎯 核心功能

• 脚本参数化执行 - 为Python脚本添加可视化参数界面
• 批量脚本处理 - 支持同时执行多个脚本
• 参数预设管理 - 保存和加载不同的参数配置
• 脚本分类整理 - 按类别组织和管理脚本
• 实时日志输出 - 查看脚本执行过程和结果

🛠️ 参数类型支持

• 文本输入 (string) - 字符串参数
• 整数输入 (int) - 整数参数
• 浮点数输入 (float) - 浮点数参数
• 开关选项 (bool) - 布尔值参数
• 文件选择 (file) - 通过内容浏览器选择文件
• 文件夹选择 (folder) - 通过内容浏览器选择文件夹
• 下拉选择 (select) - 预定义选项列表
• 滑块调节 (slider) - 数值范围滑块
• 按钮操作 (button) - 自定义按钮功能

📁 脚本管理

• 智能分类 - 自动按类别整理脚本
• 收藏功能 - 标记常用脚本
• 搜索过滤 - 快速查找所需脚本
• 导入导出 - 批量导入/导出脚本

🚀 快速开始

安装要求

• Unreal Engine 5.0+
• Python Script Plugin (已包含在UE5中)
• Windows 10/11

安装步骤

1. 将插件文件夹复制到项目的 Plugins 目录
2. 在编辑器中启用插件

使用方法

1. 在编辑器菜单栏选择 工具 > Python脚本管理器
2. 设置脚本目录路径
3. 添加或导入Python脚本
4. 配置脚本参数
5. 执行脚本

📝 脚本编写规范

基本格式

"""
@PLUGIN_INFO
id: UNIQUE_SCRIPT_ID
name: 脚本显示名称
description: 脚本功能描述
category: 脚本分类
favorite: true/false
usage: 使用说明
@END_INFO

@PLUGIN_PARAMS
参数名|类型|默认值|范围/选项|显示名称|详细描述
@END_PARAMS
"""

import unreal

def main():
    # 脚本主逻辑
    pass

if __name__ == "__main__":
    main()

参数定义示例

# 文本参数
script_name|string|默认脚本||脚本名称|输入要创建的脚本名称

# 数字参数
batch_size|int|100|50,500|批处理数量|控制每次处理的资产数量

# 布尔参数
enable_rename|bool|true||自动重命名|发现同名资产时是否自动重命名

# 文件选择
target_file|file|/Game/Assets/Test.uasset||目标文件|选择要处理的文件

# 文件夹选择
target_path|folder|/Game/Assets||目标路径|选择要处理的文件夹

# 下拉选择
operation_type|select|移动|移动,复制,重命名|操作类型|选择要执行的操作类型

# 滑块参数
quality|slider|0.8|0.0,1.0|质量设置|调整处理质量，范围0-1

📂 目录结构

PythonScriptManage/
├── Content/
│   └── Scripts/           # 脚本存储目录
├── Source/                # 插件源代码
├── Resources/             # 资源文件
└── README.md             # 说明文档

🎨 界面预览

插件提供直观的三栏式界面：

• 左栏 - 脚本列表
• 右栏 - 脚本详情和参数配置

🔧 高级功能

批量执行

• 选择多个脚本进行批量执行
• 支持参数预设应用

参数预设

• 保存常用参数配置
• 快速切换不同预设

📋 示例脚本

资产批量整理工具

"""
@PLUGIN_INFO
id: 0N2qQ5tT
name: 资产批量整理工具
description: 高效的批量资产整理工具，支持自动分类、批量移动和重命名处理
category: 资产管理
favorite: true
usage: 使用📁按钮选择路径，设置批处理数量和重命名选项，然后运行脚本
@END_INFO

@PLUGIN_PARAMS
target_base_path|folder|/Game/555||目标路径|使用📁按钮从内容浏览器选择目标文件夹
batch_size|int|100|50,500|批处理数量|控制每次处理的资产数量
enable_rename|bool|true||自动重命名|当发现同名资产时是否自动重命名
@END_PARAMS
"""

import unreal

def main():
    # 获取参数值
    global target_base_path, batch_size, enable_rename
    
    print(f"开始整理资产到: {target_base_path}")
    print(f"批处理数量: {batch_size}")
    print(f"自动重命名: {enable_rename}")
    
    # 资产整理逻辑
    # ...

if __name__ == "__main__":
    main()

🐛 故障排除

常见问题

1. 脚本无法执行 - 检查Python Script Plugin是否启用
2. 参数不显示 - 确认脚本题头格式正确
3. 文件选择失败 - 检查路径格式和权限

调试技巧

• 查看日志输出面板
• 检查脚本语法错误
• 验证参数类型匹配

📄 许可证

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情。

🤝 贡献

欢迎提交问题报告和功能请求！

📞 支持

如有问题，请通过以下方式联系：

• GitHub Issues
• 邮箱: [1512861371@qq.com]

---

注意: 本插件需要Unreal Engine 5.0或更高版本，以及Python Script Plugin支持。