Lyra - GAS

2025-06-09 约 2821 字预计阅读 6 分钟次阅读

GAS 与 Input 调用

经过游戏体验DataAsset和一系列的组件初始化加载后，在 LyraHeroComponent 绑定按键

1
2
3
4
5


/*
	此函数是技能函数，比如鼠标左键枪开火
	在 ULyraInputConfig 里配置 AbilityInputActions
*/
LyraIC->BindAbilityActions(InputConfig, this, &ThisClass::Input_AbilityInputTagPressed, &ThisClass::Input_AbilityInputTagReleased, /*out*/ BindHandles);

在绑定了按键后，会在ASC的 void ULyraAbilitySystemComponent::AbilityInputTagPressed(const FGameplayTag& InputTag) 留下记录

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14


void ULyraAbilitySystemComponent::AbilityInputTagPressed(const FGameplayTag& InputTag)
{
	if (InputTag.IsValid())
	{
		for (const FGameplayAbilitySpec& AbilitySpec : ActivatableAbilities.Items)
		{
			if (AbilitySpec.Ability && (AbilitySpec.GetDynamicSpecSourceTags().HasTagExact(InputTag)))
			{
				InputPressedSpecHandles.AddUnique(AbilitySpec.Handle);
				InputHeldSpecHandles.AddUnique(AbilitySpec.Handle);
			}
		}
	}
}

自然松开的时候，会调用ASC的void ULyraAbilitySystemComponent::AbilityInputTagReleased(const FGameplayTag& InputTag) 并留下相对应的记录

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14


void ULyraAbilitySystemComponent::AbilityInputTagReleased(const FGameplayTag& InputTag)
{
	if (InputTag.IsValid())
	{
		for (const FGameplayAbilitySpec& AbilitySpec : ActivatableAbilities.Items)
		{
			if (AbilitySpec.Ability && (AbilitySpec.GetDynamicSpecSourceTags().HasTagExact(InputTag)))
			{
				InputReleasedSpecHandles.AddUnique(AbilitySpec.Handle);
				InputHeldSpecHandles.Remove(AbilitySpec.Handle);
			}
		}
	}
}

在然后，ALyraPlayerController中会Tick调用void ALyraPlayerController::PostProcessInput(const float DeltaTime, const bool bGamePaused)

随后检索一些TArray记录下来的东西，通过 TryActivateAbility(AbilitySpecHandle); 调用到实际技能

从武器到技能

举个例子，比如是捡到枪，或者默认装备枪，随后鼠标左键开火，这其实就是一个开枪技能

装备技能

捡到枪并且装备是通过 Lyra 的 Equipment系统和Inventory系统来实现的，在这里不详细讲，但是此时有一个ULyraEquipmentDefinition 中会记录一个 ULyraAbilitySet，里面有见到这个枪就会装备什么GameAbility技能，以及GameEffect效果，还有AttributeSet属性数值，这时候就会将GameAbility技能给GiveAbility装备上去

技能的实现

创建一个GA类，不管是蓝图还是c++，GameplayAbility有以下比较重要的接口

virtual bool CanActivateAbility(const FGameplayAbilitySpecHandle Handle, const FGameplayAbilityActorInfo* ActorInfo, const FGameplayTagContainer* SourceTags = nullptr, const FGameplayTagContainer* TargetTags = nullptr, OUT FGameplayTagContainer* OptionalRelevantTags = nullptr) const override;

判断是否可以激活此技能，在 TryActivateAbility 后，其实会进行一系列的检查，此接口就在其中
virtual void ActivateAbility(const FGameplayAbilitySpecHandle Handle, const FGameplayAbilityActorInfo* ActorInfo, const FGameplayAbilityActivationInfo ActivationInfo, const FGameplayEventData* TriggerEventData) override;

在经过一系列技能检查后就会触发，也就是此技能的核心逻辑，比如播放蒙太奇，然后蒙太奇播放完调用 EndAbility
virtual void EndAbility(const FGameplayAbilitySpecHandle Handle, const FGameplayAbilityActorInfo* ActorInfo, const FGameplayAbilityActivationInfo ActivationInfo, bool bReplicateEndAbility, bool bWasCancelled) override;

技能结束的核心逻辑写在这个函数，但是记住这个函数不代表跟技能相关的实例就会销毁
virtual void InputPressed(const FGameplayAbilitySpecHandle Handle, const FGameplayAbilityActorInfo ActorInfo, const FGameplayAbilityActivationInfo ActivationInfo) override;* 此函数的作用就在于，如果是通过按键去触发技能，那么在按下键的时候就会触发
virtual void InputReleased(const FGameplayAbilitySpecHandle Handle, const FGameplayAbilityActorInfo* ActorInfo, const FGameplayAbilityActivationInfo ActivationInfo) override;

抬起键的时候触发

随后不管c++还是蓝图，将其 InstancingPolicy 修改为：InstancedPerActor，此参数有以下几种：

NonInstanced：此能力从未实例化。任何执行此能力的操作都是在 CDO 上进行的。
InstancedPerActor：当这个 Ability 被授予给一个 Actor 时，系统会为这个 Actor 创建一个全新的 UGameplayAbility 对象实例。如果 10 个不同的 Actor 都被授予了这个 Ability，内存中就会有 10 个独立的 Ability 对象。
InstancedPerExecution：当这个 Ability 被授予时，系统不会立即创建实例。只有在每次这个 Ability 被激活 (ActivateAbility) 时，系统才会临时创建一个新的 Ability 对象实例。当这个 Ability 执行完毕并结束 (EndAbility) 时，这个临时的实例会被立即销毁（垃圾回收）。

随后还得将一个变量Ability Triggers修改，将你的按键绑定的Tag输入进去，这样就可以将按键跟技能上面关联上啦

检测到伤害目标

这里不详细讲如何检测到伤害目标（可能后续会更新？），比如枪发射子弹，就发出射线，进行扫描。如果是近战武器，则利用动画通知去生成碰撞盒子，来进行伤害目标

如果要在这拿到GA实例，只要能拿到ASC，则可以利用 ASC->GetActivatableAbilities()，拿到所有激活的技能Spec，在通过 AbilitySpec.GetPrimaryInstance() Cast 成你的GA实例就好了

应用GE

这时候我们就会有目标Actor了，我们获取到自己的ASC和Target的ASC，可以利用如下代码，创建GameplayEffectSpecHandle，并且应用

1
2
3
4
5
6


FGameplayEffectSpecHandle DamageSpecHandle = MakeOutgoingGameplayEffectSpec(DamageEffect, GetAbilityLevel());

if (DamageSpecHandle.IsValid())
{
    SourceASC->ApplyGameplayEffectSpecToTarget(*DamageSpecHandle.Data.Get(), TargetASC);
}

好，这时候注意力来到我们创建的GE，GE也有着很多的属性，我们关注点先放在Gameplay Effect

Modifiers：这个可以应用比较简单的Attributes。比如直接将Health -> Add -> -10，这样每次攻击，都会对Target扣10点血。但是这样缺点就是不灵活，因为这个伤害值计算确实很复杂，比如lyra的枪，他有距离衰减，物理散射，包括打头伤害更高之类的，所以就需要 Executions
Executions：我们可以创建一个 UGameplayEffectExecutionCalculation 的子类，这个类就可以帮助我们去算伤害的具体值，这个类的执行就是在应用AttricuteSet之前，所以我们可以直接操作他的伤害值

GameplayEffectContext

再聊到具体的 Executions 之前还得聊一聊这个，这个其实就是 GameplayEffect 的上下文，也就是储存着 GE 通知 AttricuteSet的各种信息，我们继承于这个Struct FGameplayEffectContext，这样就可以塞我们自己自定义的任何信息，比如伤害接口的伤害倍数，在这个struct有如下接口需要注意下，有可能用到：

1
2
3
4
5


// ~Begin FGameplayEffectContext Interface
virtual FGameplayEffectContext* Duplicate() const override;  // 进行拷贝结构体的
virtual UScriptStruct* GetScriptStruct() const override;  // 获取当前 GameplayEffectContext 实例的实际 UStruct 类型。
virtual bool NetSerialize(FArchive& Ar, class UPackageMap* Map, bool& bOutSuccess) override;  // 进行网络复制
// ~End FGameplayEffectContext Interface

我们如果想要我们自定义的生效，必须重写AbilitySystemGlobals方法，并且在Project Setting里设置我们默认的 AbilitySystemGlobals 类

并且要在我们的GA中重写 virtual FGameplayEffectContextHandle MakeEffectContext(const FGameplayAbilitySpecHandle Handle, const FGameplayAbilityActorInfo* ActorInfo) const override; 在这个函数里面去初始化我们的GEContext哦

AbilitySystemGlobals

1
2
3
4
5
6


virtual FGameplayEffectContext* AllocGameplayEffectContext() const override;

FGameplayEffectContext* USAbilitySystemGlobals::AllocGameplayEffectContext() const
{
	return new FSGameplayEffectContext();
}

Executions

好了，终于回到了我们的Executions，我们重写 virtual void Execute_Implementation(const FGameplayEffectCustomExecutionParameters& ExecutionParams, FGameplayEffectCustomExecutionOutput& OutExecutionOutput) const override;方法

ExecutionParams：这个参数就是带有各种数据，比如SourceASC，TargetASC
OutExecutionOutput：这个参数就是我们要给AttricuteSets的数据，所以我们弄好了伤害具体数值后就可以通过这个直接扔过去

我们要注意比如我们拿一个 BaseDamage，这个基础伤害，我们要通过FGameplayEffectAttributeCaptureDefinition 这个结构体去拿

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20


struct FDamageStatics
{
	FGameplayEffectAttributeCaptureDefinition BaseDamageDef;

	FDamageStatics()
	{
		BaseDamageDef = FGameplayEffectAttributeCaptureDefinition(USCombatSet::GetBaseDamageAttribute(), EGameplayEffectAttributeCaptureSource::Source, true);
	}
};

static FDamageStatics DamageStatics()
{
	static FDamageStatics Statics;
	return Statics;
}

USDamageExecution::USDamageExecution()
{
	RelevantAttributesToCapture.Add(DamageStatics().BaseDamageDef);
}

如上方代码所示，我们初始化的三个参数的意思分别为：

USCombatSet::GetBaseDamageAttribute()：到我们的这个AttricuteSet去拿一个 Attricute
EGameplayEffectAttributeCaptureSource::Source：是从Source拿不是从Target拿
True: 是否拍快照，这个基本都是true，要不然你的数据可能会被污染

然后我们放在RelevantAttributesToCapture里，通过一下方式去拿：

1
2
3
4
5
6


FAggregatorEvaluateParameters EvaluateParameters;
EvaluateParameters.SourceTags = SourceTags;
EvaluateParameters.TargetTags = TargetTags;

float BaseDamage = 0.0f;
ExecutionParams.AttemptCalculateCapturedAttributeMagnitude(DamageStatics().BaseDamageDef, EvaluateParameters, BaseDamage);

我们最后通过拿到准确数据后就塞到数据里返回回去：

1

OutExecutionOutput.AddOutputModifier(FGameplayModifierEvaluatedData(USHealthSet::GetDamageAttribute(), EGameplayModOp::Additive, DamageDone));

Lyra是通过WeaponInstance计算好具体的倍数，然后继承了一个接口，送到这里来的

最后别忘记要在GE把这个Executions设置进去哦

应用AttributeSet

好了这下数据都来AttributeSet了，我们就要修改角色身上的Attribute了，这Set也有几个很关键的接口

1
2
3
4
5
6


virtual bool PreGameplayEffectExecute(FGameplayEffectModCallbackData& Data) override;
virtual void PostGameplayEffectExecute(const FGameplayEffectModCallbackData& Data) override;

virtual void PreAttributeBaseChange(const FGameplayAttribute& Attribute, float& NewValue) const override;
virtual void PreAttributeChange(const FGameplayAttribute& Attribute, float& NewValue) override;
virtual void PostAttributeChange(const FGameplayAttribute& Attribute, float OldValue, float NewValue) override;

目录