Stat buffs, Defense boost, Haste |
Effects can be configured to run at Turn Start or Turn End.
The ACFTurnAbilitySystemComponent provides several Blueprint-callable functions:
For Turn Start Effects:
Add Instant Turn Start Effect
- Effect Class: The Gameplay Effect to apply
- Level: Effect level (default 1.0)
- Duration: Number of turns (-1 for infinite)
Add Persistent Turn Start Effect
- Effect Class: The Gameplay Effect to apply
- Level: Effect level (default 1.0)
- Duration: Number of turns (-1 for infinite)For Turn End Effects:
Add Instant Turn End Effect
- Effect Class: The Gameplay Effect to apply
- Level: Effect level (default 1.0)
- Duration: Number of turns (-1 for infinite)
Add Persistent Turn End Effect
- Effect Class: The Gameplay Effect to apply
- Level: Effect level (default 1.0)
- Duration: Number of turns (-1 for infinite)You can configure default effects directly in the component details panel:
Select the ACFTurnAbilitySystemComponent on your character
Find Default Turn Start Effects and Default Turn End Effects arrays
Add entries with:
Turn Effect: The GE class
Level: Effect level
Application Mode: ApplyEachTurn or ApplyOnceWithDuration
bInfinite: Check for permanent effects
Turns Duration: Number of turns (only used if bInfinite is false)
Turn Effect: GE_ManaRegen
Level: 1.0
Application Mode: ApplyEachTurn
bInfinite: ✓This applies mana regeneration at the start of every turn, forever.
Turn Effect: GE_PoisonDamage
Level: 1.0
Application Mode: ApplyEachTurn
bInfinite: ✗
Turns Duration: 3This applies poison damage for 3 turns, then expires.
Turn Effect: GE_DefenseBoost
Level: 1.0
Application Mode: ApplyOnceWithDuration
bInfinite: ✗
Turns Duration: 5This applies the defense buff once on first turn, keeps it active for 5 turns, then removes it.
Turn Effect: GE_PassiveAura
Level: 1.0
Application Mode: ApplyOnceWithDuration
bInfinite: ✓This applies the effect once and never removes it.
The ACFBuffTurnAbility is a ready-to-use ability class for applying turn-managed effects to targets.
Create a new Blueprint class based on ACFBuffTurnAbility
Configure the Turn Effect struct in the ability defaults
Set bApplyAtTurnStart to choose when the effect triggers
Add a montage with the Actions.AbilitySystem.ApplyBuff notify (optional)
If you add an ACFNotifyAction with tag Actions.AbilitySystem.ApplyBuff in your montage, the buff applies at that exact frame
If you forget the notify, the buff automatically applies when the ability ends (safety fallback)
If the ability is cancelled, no buff is applied
1. Create BP_Ability_Haste (parent: ACFBuffTurnAbility)
2. Set Turn Effect:
- Turn Effect: GE_HasteBoost
- Level: 1.0
- Application Mode: ApplyOnceWithDuration
- bInfinite: false
- Turns Duration: 3
3. Set bApplyAtTurnStart: true
4. Assign montage with casting animation
5. Add ACFNotifyAction at the "magic release" frame with tag: Actions.AbilitySystem.ApplyBuffYou can check effect status from Blueprint:
Has Turn Start Effect (Effect Class) → bool
Has Turn End Effect (Effect Class) → bool
Get Turn Start Effect Remaining Turns (Effect Class) → int32 (-1 if not found)
Get Turn End Effect Remaining Turns (Effect Class) → int32 (-1 if not found)The component broadcasts events you can bind to:
On Turn Effect Expired: Fires when any managed effect expires (useful for UI notifications)