JisolGame/JEX_GAS/Assets/GAS/Wiki/GameplayEffect.md

EX-GAS Wiki -- GameplayEffect

GameplayEffect的作用

GameplayEffect是EX-GAS的核心之一，一切的游戏数值体系交互基于GameplayEffect。

GameplayEffect掌握了游戏内元素的属性控制权。理论上，只有它可以对游戏内元素的属性进行修改 （这里指的是修改，数值的初始化不算是修改）。当然，实际情况下，游戏开发人员当然可以手动直接修改属性值。 但是还是希望游戏开发者尽可能的不要打破EX-GAS的数值体系逻辑，因为过多的额外操作可能会导致游戏的数值体系变得混乱，难以追踪数值变化等等。

另外GameplayEffect还可以触发Cue（游戏提示）完成游戏效果的表现，以及控制获取额外的能力等。

---

由于GameplayEffect是被封装好的，程序开发者不会接触它的实现逻辑，所以本文Wiki将跳过对其接口以及代码逻辑的解析。 后续，可能会完善代码接口的介绍。

GameplayEffect的使用

GameplayEffect的配置界面如图，接下来逐一解释各个参数的含义。

• Name：GameplayEffect的名称，纯粹用于显示，不会影响游戏逻辑。方便编辑者区分GameplayEffect。
• Description：GameplayEffect的描述，纯粹用于显示，不会影响游戏逻辑。方便编辑者阅读理解GameplayEffect。
• DurationPolicy：GameplayEffect的执行策略，有以下几种：
  • Instant：即时执行，GameplayEffect被添加时立即执行，执行完毕后销毁自身。
  • Duration：持续执行，GameplayEffect被添加时立即执行，持续时间结束后移除自身。
  • Infinite：无限执行，GameplayEffect被添加时立即执行，执行完毕后不会移除，需要手动移除。
  • None：无效果,这是默认占位符，因为GameplayEffect是结构体，None方便视作GameplayEffect的空值。 GameplayEffect配置的执行策略禁止使用None！！！
• Duration：持续时间，只有DurationPolicy为Duration时有效。
• Every(Period)：周期，只有DurationPolicy为Duration或者Infinite时有效。每隔Period时间执行一次PeriodExecution。
• PeriodExecution：周期执行的GameplayEffect，只有DurationPolicy为Duration或者Infinite，且Period>0时有效。每隔Period时间执行一次PeriodExecution。 _PeriodExecution禁止为空!!_PeriodExecution原则上只允许是Instant类型的GameplayEffect。但如果根据开发者需求，也可以使用其他类型的GameplayEffect。
• GrantedAbilities：授予的能力，只有DurationPolicy为Duration或者Infinite时有效。在GameplayEffect生命周期内，GameplayEffect的持有者会被授予这些能力。 GameplayEffect被移除时，这些能力也会被移除。
• Modifiers: 属性修改器。GameplayEffect的核心功能，用于修改GameplayEffect持有者的属性。
  • Attribute：属性名称，需要填写属性的全名，比如战斗属性集里的生命值：AS_Fight.Health
  • ModifierMagnitude：基础模值，这个模值是否使用依赖于MMC的类型。在中有Wiki-MMC详细介绍。
  • Operation：属性修改操作，有加法、乘法、赋值（覆写）等。
  • MMC：属性修改计算类，用于计算ModifierMagnitude的值。 EX-GAS提供了多种ModifierCalculation，开发者也可以自定义ModifierCalculation。 ModifierCalculation的类型在Wiki-MMC详细介绍。
• Tags：标签。Tag具有非常重要的作用，合适的tag可以处理GameplayEffect之间复杂的关系。
  • AssetTags：描述性质的标签，用来描述GameplayEffect的特性表现，比如伤害、治疗、控制等。
  • GrantedTags：GameplayEffect的持有者会获得这些标签，GameplayEffect被移除时，这些标签也会被移除。 Instant类型的GameplayEffect的GrantedTags是无效的。
  • ApplicationRequiredTags：GameplayEffect的目标单位必须拥有 【所有】 这些标签，否则GameplayEffect无法被施加到目标身上。
  • OngoingRequiredTags：GameplayEffect的目标单位必须拥有 【所有】 这些标签，否则GameplayEffect不会被激活（施加和激活是两个概念， 如果已经被施加的GameplayEffect持续过程中，目标的tag变化了，不满足，效果就会失活；满足了，就会被激活）。 Instant类型的GameplayEffect的OngoingRequiredTags是无效的。
  • RemoveGameplayEffectsWithTags：GameplayEffect的目标单位当前持有的所有GameplayEffect中，拥有 【任意】 这些标签的GameplayEffect会被移除。
• Cues：GameplayEffect的提示。GameplayEffect可以触发Cue（游戏提示）完成游戏效果的表现，以及控制获取额外的能力等。
  • DurationPolicy为Instant时
    • CueOnExecute（Instant）：GameplayEffect执行时触发。
  • DurationPolicy为Duration或者Infinite时
    • CueDurational（Durational）：生命周期完全和GameplayEffect同步
    • CueOnAdd（Instant）：GameplayEffect添加时触发
    • CueOnRemove（Instant）：GameplayEffect移除时触发
    • CueOnActivate（Instant）：GameplayEffect激活时触发。
    • CueOnDeactivate（Instant）：GameplayEffect失活时触发。

GameplayEffect的施加（Apply）和激活（Activate）

GameplayEffect的施加（Apply）和激活（Activate）是两个概念，施加是指GameplayEffect被添加到目标身上，激活是指GameplayEffect实际生效。

为什么做区分？

举个例子：固有被动技能（Ability）是持续回血，被动技能的逻辑显然是永久激活的状态，而持续回血的效果（GameplayEffect） 来源于被动技能，那如果单位受到了外部的debuff禁止所有的回血效果，那么是不是被动技能被禁止？显然不是，被动技能还是会持续激活的。 那应该是移除回血效果吗？显然也不是，被动技能整个过程是不做任何变化，如果移除回血效果，那debuff一旦消失，谁再把回血效果加回来？ 所以，这里需要区分施加和激活，被动技能的持续回血效果被施加到单位身上，而debuff做的是让回血效果失活，而不是移除回血效果，一旦debuff结束， 回血效果又被激活，而这个激活的操作可以理解为回血效果自己激活的（依赖于Tag系统）。