SuperAPI AI 工具集

gameplay-tags

编程与开发

查看项目

更新于 11-06 18:23

技能介绍

gameplay-tags 是 VibeUE 项目提供的 Unreal Engine 技能,用于管理 Gameplay Tags 的创建、查询与批量注册。

用途:该技能面向需要在 Unreal Engine 项目中添加、注册、检查或浏览 Gameplay Tags 的场景,例如为 StateTree 事件创建触发标签,或在编辑器中快速补充标签层级。

主要能力:

  1. 单个标签的新增、删除、重命名和列出全部标签,由 Unreal 5.8 原生 GameplayTagsToolset 提供,需通过 call_tool 调用(可运行 describe_toolset 查看动作名与参数)。
  2. VibeUE 保留的增量能力:unreal.GameplayTagService.add_tags 用于一次批量注册多个标签;has_tag 用于检查标签是否存在;get_tag_info 返回单个标签的详细信息(注释、来源、重定向目标、子标签数量等);get_children 返回某标签的直接子标签。
  3. 标签写入 INI 配置并在运行时注册,添加后立即出现在编辑器标签选择器中,无需重启。

使用方式:通过 execute_python_code 调用 unreal.GameplayTagService 下的方法;单标签 CRUD 则通过 call_tool 调用引擎 GameplayTagsToolset。示例:result = unreal.GameplayTagService.add_tags(["Cube.StartChasing"], "Event to start chasing"),并通过 result.success 判断结果。标签命名必须使用点分隔层级(如 Ability.Fireball.Cast),不能包含空格或特殊字符。默认标签来源为 DefaultGameplayTags.ini。

适用场景:为 StateTree 转换创建 OnEvent 触发标签;批量注册项目所需标签;在使用标签前检查其是否存在;浏览某标签的直接子级结构;重命名后确认重定向目标。

限制与注意事项:

  • 不要使用 ProjectSettingsService.set_ini_value 写入 Gameplay Tags,因为它只写入 GConfig 内存,不会向 UGameplayTagsManager 注册,标签不会出现在选择器中。
  • 重命名会注册重定向,旧名称的 has_tag 仍返回 True,这属于重定向而非重命名失败;可通过 get_tag_info(old_name).redirected_to 或引擎工具集的列出动作、get_children(parent) 验证。
  • get_tag_info 返回结构体或 None,不是元组,不能解包。
  • 若会话中存在 unreal-engine-skills-manager 外部 MCP 工具,可调用其 load 动作获取该主题的 UE 领域知识作为评审基准;若不存在则跳过,不应尝试调用。

资料中未提供该技能的收费、价格、平台支持范围或效果数据。