用途
umg-widgets 是用于 Unreal Engine 的编辑技能,聚焦 UMG Widget Blueprint(WBP)的编写,通过 WidgetService 完成从创建资产到调整样式、动画与运行时检查的完整流程。若同时需要为 WBP 添加蓝图变量、函数或组件,可配合 blueprints 技能;若要为已绑定事件连线事件图表,可配合 blueprint-graphs 技能。
主要能力
- 创建 Widget Blueprint:使用 WidgetBlueprintFactory 配合 AssetTools.create_asset 生成资产,再由 WidgetService 填充。资料强调不存在 create_widget_blueprint、WidgetService.create_widget 等接口。
- 构建层级:先设根节点(set_as_root=True),再添加子控件;控件名在整个 WBP 内唯一,需按父级加后缀避免重名。
- 属性设置:所有属性值以字符串传入,如 "24";设置后需用 get_property 回读比对,结构体设置可能返回 True 却未写入。
- 颜色处理:区分 FSlateColor(如 ColorAndOpacity)与 FLinearColor(如 ShadowColorAndOpacity),需传数字 RGBA,不支持 "red" 等命名色。
- 字体与画刷样式:完整字体或画刷修改用 set_font / set_brush 配 WidgetFontInfo / WidgetBrushInfo;set_property 仅用于单叶子值或槽别名。set_brush 需传 slot_name,Image 的槽为 "Brush";set_font 的 property_name 默认 "Font"。资料指出 Font.Typeface 经 set_property 会静默返回 False,应改用 set_font。
- 动画制作:先建动画,再建轨道,最后加关键帧;轨道目标须为真实控件属性或槽别名(如 RenderOpacity、ColorAndOpacity、Position X/Y、Size X/Y)。
- 预览与运行时检查:capture_preview 渲染编辑器侧 PNG 用于外观检查;start_pie 加 spawn_widget_in_pie 用于运行时状态与属性读取。
- 自定义 WBP 作组件:用 list_widget_blueprints("") 查找已有 WBP,以资产名(如 "WBP_HealthBar")作为 component_type,子 WBP 须已存在,循环引用被拒绝。
- 审计最佳实践:快照中 *Delegate 且 current_value 为 (null).None 表示未绑定;事件图表检查经 BlueprintService 的 list_graphs、get_nodes_in_graph、get_node_pins 完成。
- 槽布局编辑与重父级:通过 set_property 的槽别名设置 Position X/Y、Size X/Y、锚点、对齐、ZOrder、Padding、Size Rule 等;reparent_widget 可移动控件且保留对象/GUID,但面板不能移入自身或后代,根节点不可重父级。
- MVVM 支持:mvvm.md 记录 ViewModel 创建类型、绑定模式、字段名及添加/绑定/列出/移除流程。
使用方式
按任务索引选择对应任务,加载 workflows.md 中的工作流,或通过 execute_python_code 运行 scripts/ 下的示例脚本(修改脚本顶部变量后执行)。资料列出的任务包括创建 WBP、构建菜单、Canvas 定位、检查控件、字体样式、画刷样式、制作动画、绑定事件、重命名/移除控件、编辑槽布局/重父级、捕获预览、PIE 运行时检查与添加 MVVM。子文档直接位于 Plugins/VibeUE/Content/Skills/umg-widgets/ 下按需读取。
适用场景
适合在 Unreal Engine 编辑器中以脚本方式批量或精确地生成与调整 UMG 界面,例如搭建主菜单、设置统一字体与画刷风格、制作 UI 动画、绑定按钮事件、审查控件最佳实践以及检查运行时界面状态。
限制与注意事项
资料明确若干易错点:字段名以 property_name、property_type、current_value、widget_name、widget_class 为准;children 为控件名字符串数组,需先建名字到信息的映射再遍历;get_font 回读时 color、shadow_color、shadow_offset 会返回两段拼接文本,应取最后一组括号;get_widget_snapshot 返回空通常意味着路径错误。BlueprintService 不存在 get_graphs、get_functions、get_connected_nodes、unreal.find_class 等方法。声明控件创建或配置成功前,必须用新的 get_widget_snapshot 确认,并回读属性/字体/画刷,打开并编译 WBP 确认无错误后调用 save_asset 保存。
暂未提供
资料未说明该技能的授权方式、安装步骤、收费与价格、支持的具体 UE 版本范围以及除上述脚本外的其他平台信息。