Overview
WCGASStatusEffectComp is a comprehensive ActorComponent that tracks and manages active buffs and debuffs from the Gameplay Ability System. It automatically monitors GAS effect application and removal, providing Blueprint-friendly query APIs for UI widgets, gameplay logic, and AI systems. The component supports evolution systems (effects transforming into stronger versions), synergy systems (effect combinations triggering reactions), Synergy Chains (multi-step effect combos), team-based targeting, damage event integration, death detection, and save/load persistence.
Core Functionality
- Tracks active buffs and debuffs on individual actors via GAS delegate subscription
- Provides UI-ready query APIs returning effect icons, names, durations, and stack counts
- Monitors effect stack changes for evolution and synergy triggers
- Supports synergy systems where effect combinations create reactions (e.g., Fire + Water = Steam Explosion)
- Supports evolution systems where effects transform at stack thresholds (e.g., Burn → Inferno)
- Implements Synergy Chain system for multi-step combo sequences with timing windows
- Manages synergy and Synergy Chain cooldowns to prevent spam
- Integrates with team filtering for ally/enemy-aware synergy targeting
- Provides damage event hooks for ExecCalc integration (OnDamageDealt/OnDamageReceived synergies)
- Detects actor death via health attribute monitoring and clears all effects automatically
- Supports save/load persistence for active effect state
- Resolves evolution vs synergy conflicts via configurable project settings policies
- Caches AbilitySystemComponent and subsystem references for performance
- Replicates tracked effects to all clients for target visibility
- Integrates with immunity checks via Resistance Component