内容范围
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 头文件。