EnumStructService 是 VibeUE 提供的虚幻引擎技能,用于创建、修改和查询用户自定义枚举(UserDefinedEnum)与用户自定义结构体(UserDefinedStruct)。
用途:在编辑器环境下通过 Python 脚本管理蓝图枚举与结构体资产,适用于需要以代码方式批量生成、调整或检查枚举和结构体定义的场景,例如为武器类型创建枚举、为物品数据创建结构体行类型等。
主要能力:
- 枚举操作:create_enum 创建枚举,add_enum_value 添加值,rename_enum_value 重命名值,set_enum_value_display_name 设置显示名,remove_enum_value 移除值,get_enum_values/get_enum_info 查询值与详情,search_enums 搜索枚举。
- 结构体操作:create_struct 创建结构体,add_struct_property 添加属性,rename_struct_property 重命名属性,change_struct_property_type 修改属性类型,set_struct_property_default 设置默认值,remove_struct_property 移除属性,get_struct_info/search_structs 查询详情与搜索。
- 属性类型支持基本类型(bool、int32、float、FString、FName 等)、常见结构体(FVector、FRotator、FLinearColor、FGameplayTag 等)、对象引用(AActor、UTexture2D 等)以及容器类型(Array、Set、Map)。
使用方式:通过 execute_python_code 执行 Python 脚本,调用 unreal.EnumStructService 的相应方法。创建时需传入目标资产名,create_enum/create_struct 仅在名称不以 E/F 开头时自动添加前缀;若资产已存在则创建失败,需先删除。枚举值操作始终使用显示名,内部名(NewEnumerator0..N)不可变。结构体属性操作使用作者定义的属性名。
适用场景:在虚幻引擎项目中以脚本方式生成用户自定义枚举和结构体,用于数据表行结构、蓝图变量类型等。创建的结构体至少包含一个属性后可被用作数据表的行类型;数据表本身由引擎 AssetTools 工具集创建。
限制:原生 C++ 枚举和结构体为只读,仅用户自定义资产可修改;修改属性类型会重置默认值为新类型的零值;创建不覆盖同名资产;枚举值重命名仅改变显示名。