本技能用于在 Unreal Engine 中创建和修改蓝图(Blueprint)资产,包括变量、函数、组件、事件分发器和接口。当用户要求创建蓝图、添加变量或函数、管理组件层级等操作时使用。
用途与范围:
- 创建蓝图资产,指定父类(如 Actor、Pawn、Character 或其他蓝图生成的类)。
- 添加成员变量,支持基础类型、结构体、对象引用和枚举,以及数组等容器。
- 创建函数图表,并细化函数参数、局部变量和覆写。
- 管理组件:添加、删除、重设父级、设置根组件、查询可用组件类型和属性。
- 设置类默认对象(CDO)属性,例如复制(Replication)和初始生命期。
- 创建事件分发器(多播委托)。
- 读取蓝图、函数、变量、组件、图表、节点和引脚的信息结构。
主要能力与关键规则:
- 引擎 BlueprintTools 的参数使用 {refPath} 对象而非字符串,refPath 必须是完整对象路径,如 /Game/Dir/Asset.Asset(点号后重复资产名)。
- 创建蓝图使用 call_tool 调用引擎 BlueprintTools 的 create,folder_path 与 asset_name 为字符串,asset_type 为 {refPath} 类引用。
- add_variable 支持的基础类型名称精确为:bool、int、float、byte、name、string、text、Vector、Rotator、Transform、Vector2D、LinearColor。不支持 int32/double。
- 蓝图类类型的变量在 type_name 中直接使用蓝图资产名,不加 _C,也不构造生成类路径。
- 引擎结构体需要 F 前缀,如 FLinearColor、FColor;不确定类型可用 search_variable_types 查询。
- 对象引用变量使用 add_object_variable,object_class 为 {refPath};结构体变量使用 add_struct_variable。
- 在 execute_python_code 中可使用 unreal.BlueprintService.add_member_variable 支持完整类型字符串、结构体、对象、枚举和容器,添加后需编译蓝图。
- 添加函数图表使用引擎 BlueprintTools.add_function_graph,之后可用 VibeUE 的 add_function_parameter、add_function_local_variable、get_function_parameters、get_function_info、override_function、open_function_graph 等方法细化。
- 注意方法名与属性名:get_component_info 只接收组件类型;函数信息中使用 input_parameters 而非 inputs;变量信息中使用 variable_name 而非 name。
- UE Python 会剥离布尔属性的小写 b 前缀,如 bIsEventStyle 应写为 is_event_style;但 get_property/set_property 使用原生 C++ 名称,布尔属性保留 b 前缀(如 bReplicates)。
- get_property 返回字符串或 None,不是元组;set_property 的值也是字符串。
- 信息结构字段有完整定义,不应猜测,例如 BlueprintFunctionInfo 无 function_type 和 input_parameters;BlueprintFunctionDetailedInfo 无 return_type,返回值在 output_parameters 中。
- 组件属性值使用 UE 导出文本格式字符串,FVector 形如 "(X=0,Y=0,Z=50)",FColor 为 0–255 整数,FLinearColor 为 0–1 浮点数。
- 碰撞设置使用 set_collision_settings,因为 set_component_property 无法访问 BodyInstance。
- 根组件行为:第一个无父级的场景组件会替换自动生成的 DefaultSceneRoot 并成为根;后续无父级场景组件成为浮动兄弟节点,需通过 parent_name、reparent_component 或 set_root_component 构建层级。
- StateTree 委托分发器变量类型应为 FStateTreeDelegateDispatcher,而非 EventDispatcher;引擎 BlueprintTools.add_variable 不接受该类型,需使用 VibeUE 的 add_member_variable。
- 事件分发器应使用专用 API 创建,而非 add_variable。
- 若会话中存在 unreal-engine-skills-manager 外部 MCP 工具,可调用其加载 blueprint-fundamentals 技能获取领域知识;若不存在则跳过。
使用方式: 通过 call_tool 调用引擎 BlueprintTools 工具集(editor_toolset.toolsets.blueprint.BlueprintTools),或通过 execute_python_code 调用 unreal.BlueprintService.* 和 unreal.BlueprintEditorLibrary 等 Python 方法。创建/加载返回的 {refPath} 对象可复用于后续调用;也可从包路径构造 refPath。
适用场景:
- AI 智能体在 UE 编辑器中自动化搭建蓝图结构。
- 批量创建变量、函数和组件。
- 读取蓝图信息用于审查或生成文档。
限制:
- 节点级图表编辑(添加节点、连接引脚、连线逻辑、定时器、布局)需加载 blueprint-graphs 技能。
- 引擎 BlueprintTools 的 {refPath} 规则仅适用于该工具集调用路径,VibeUE 自身 unreal.BlueprintService.* 方法仍接收普通字符串路径。
- 添加变量后需编译蓝图,类才会重建。
- 具体版本兼容性、收费和平台信息暂未提供。