THE MAN I INVENTED / 主程序

装备框架

第一人称科幻动作生存 · USC MFA 论文项目

以下按工程职责查看实现与演示。录屏与截图呈现各自录制时的版本。

装备框架

继承与扩展解耦

  1. 装备基类 装备 / 卸下 · 插槽
  2. 武器基类 共用武器入口
  3. 枪械基类 弹药 · 枪口 · 能力
  4. 具体枪械 只扩展特殊行为

AEquipmentBase 统一装备/卸下、插槽与动画层;AWeaponBase 承接武器分支,AFirearm 再提供弹药、枪口和能力配置。子类只扩展自己的特殊行为,不改共用装备流程。例如解体枪在成功开火回调中加入释放特效,装备切换仍由同一管理组件处理。

装备表现与物品数据解耦

可切换装备
  1. 角色配置 InitialEquipmentClasses
  2. 生成 AEquipmentBase Actor
  3. 切换 / 手持 / 收纳
背包物品
  1. 角色配置 InitialInventoryItems
  2. 记录物品类型与数量
  3. HasItem 查询权限

角色分别配置 InitialEquipmentClasses 和 InitialInventoryItems。前者存放 AEquipmentBase 子类,装备管理组件据此生成 Actor,负责切换、手持与收纳;后者存放物品类型和数量,不生成手持装备 Actor。权限卡走物品路径,不占武器槽,门通过 HasItem 查询权限。

枪械与弹体解耦

  1. 枪械 弹药 · 枪口 · BulletClass
  2. 通用射击能力 发射当前弹体
  3. 弹体 移动 · 碰撞 · 命中
  4. 目标 自身效果

AFirearm 保存弹药、射击间隔、枪口与 BulletClass;GA_Shoot 负责开火,ABulletBase 负责移动、碰撞和命中入口。具体命中效果由弹体扩展。例如爆炸枪复用通用开火流程,爆炸弹独自处理附着、延时引爆与范围伤害。

输入、能力与反馈解耦

左键 · 开火与反馈
  1. PrimaryFire Tag
  2. 当前主能力调用射击流程
  3. 弹体 · 枪口 · 动画 · 震动 · 可选后坐力
右键
  1. SecondaryFire Tag
  2. 当前副能力
  3. 瞄准或其他功能

角色的左右键只向 ASC 发送 PrimaryFire 和 SecondaryFire Tag;当前枪械分别授予主、副能力。GA_Shoot 读取当前枪械的弹体与反馈配置,在同一次有效射击中处理发射、枪口效果、开火动画、音效、相机震动和可选视角后坐力。接入新武器时,可按特性配置主、副能力、弹体及反馈参数,复用角色输入和通用射击流程;特殊命中行为留给具体弹体。

维修枪 · 左键发射维修弹

左键发送 Input.Weapon.PrimaryFire,GA_Shoot 从当前维修枪读取弹体配置并发射维修弹;枪口效果、开火动画、音效和震动也在这次射击中按该枪配置播放。

爆炸枪 · 左键发射爆炸弹

换成爆炸枪后,左键和 GA_Shoot 的入口保持一致;射击能力发射爆炸枪配置的弹体,附着、延时引爆与范围伤害交给爆炸弹处理。

潜伏者瞄准步枪 · 右键瞄准,左键射击

右键发送 Input.Weapon.SecondaryFire,当前步枪授予的瞄准能力进入 ADS,松开右键退出;左键仍由 GA_Shoot 执行射击。瞄准和射击可分别配置能力,角色按键绑定不变。

装备技能的授予与回收

玩家 ASC 由 PlayerState 持有,跨角色切换持续存在。装备授予主攻击、副攻击和换弹能力时,保存技能句柄与授予时的 ASC 弱引用;卸装时按句柄回收对应能力,并在角色无法再取得 ASC 时使用保存的引用。

  1. 01

    授予时保存归属

    装备授予主攻击、副攻击与换弹能力时,保存各自的技能句柄,同时用弱引用记录授予时的 ASC。

  2. 02

    销毁前先卸装

    EquipmentManager 在 EndPlay 先调用当前装备的 Unequip,再销毁库存。回收函数无法从角色取得 ASC 时,回退到授予时保存的引用。

  3. 03

    按句柄回收并复位

    只清理该装备授予的能力;对副攻击先取消再清除。随后重置技能句柄和 ASC 缓存,使下一次装备进入新的授予周期。

设计取舍与边界

保留 PlayerState 上的 ASC 跨角色存在,让装备管理自己授予的技能。只在 EndPlay 增加卸装调用仍不够,因为此时角色可能已失去 PlayerState;因此需要保留授予时的引用。弱引用不延长 ASC 生命周期,回收前仍检查有效性。