跳转到正文

通用玩法工具

作

作者

作者

创建时间: 2026年10月19日更新时间: 2026年10月19日

目录

内容范围

GenericGameSystem 核心 Runtime 模块还包含若干跨玩法的小型工具。本页记录目前可从 Public API 确认的两类能力;它们不替代项目自己的动画、目标选择或交互策略。

Socket Relationship Mapping

UGGS_SocketRelationshipMapping Data Asset 用于描述父 Mesh 与目标 Mesh 资产之间的 Socket 对应和调整。关系可限定适用的 Skeleton,并为 Mesh 资产与 Socket 保存项目自定义调整。运行时可通过 FindSocketAdjustment 或静态映射查询函数取得结果。

适合用于不同骨骼/网格之间复用附属物、命中位置或 Socket 偏移配置。创建资产后,在项目中维护匹配的 Skeleton、Mesh 资产和 Socket 名;缺少映射时由调用方决定回退行为。

Smart Object Targeting 过滤器

GGS_TargetingFilterTask_InteractionSmartObjects 为 Targeting System 提供交互 Smart Object 过滤任务。它只负责过滤目标结果,不负责完整扫描策略、提示 UI 或启动 Gameplay Ability。把它放到项目的 Targeting 配置中后,仍需由交互组件和项目逻辑驱动搜索、候选排序与交互流程。

选择扩展点

  • 需要候选搜索时,由项目 trace、overlap 或 Targeting 配置提供检测策略,再把结果交给交互组件。
  • 需要跨 Mesh 的 Socket 调整时,把映射保存在 Data Asset,而不是在角色蓝图中散落硬编码。
  • 若工具行为不覆盖项目规则,应在项目模块扩展,不要依赖 GGS 的 Private 头文件。