Overflow Function Library

Purpose

This Blueprint Function Library provides automatic overflow event detection and broadcasting for damage and healing meta attributes that exceed target capacity. It enables event-triggered abilities to activate automatically when overkill damage or overheal occurs, supporting gameplay patterns like chain damage, shield conversion, death explosions, and heal bouncing. Integrates with any AttributeSet via a single function call in PostGameplayEffectExecute, reading overflow amounts from meta attributes and broadcasting Gameplay Events to configured recipients (source/target ASCs) for seamless ability activation.

Works In

AttributeSet C++ implementations within the PostGameplayEffectExecute function. This library is called on server authority during Gameplay Effect execution after attribute clamping logic writes overflow amounts to meta attributes (e.g., Meta.Damage.Overflow, Meta.Healing.Overflow). Works with any AttributeSet without requiring inheritance or custom base classes. Broadcasts events using GAS's native event system to trigger event-tagged abilities granted to source (attacker/healer) or target (damaged/healed) ASCs. Configuration managed through Project Settings → Wonderscape GAS Ally.

Common Use Cases

Overkill chain damage spreading excess damage to nearby enemies when target dies
Overheal shield conversion transforming excess healing into temporary shields
Death explosions scaling damage based on overkill magnitude
Heal bounce redirecting overheal to lowest-health allies
Absorb shield overflow triggering counterattack abilities when shields break

Blueprint Name	C++ Name	Pins	Brief Description of Purpose
Check And Broadcast Overflow Event	`CheckAndBroadcastOverflowEvent`	Input: Data (Gameplay Effect Mod Callback Data ref)<br>Output: None	Detects damage/healing overflow from meta attributes and broadcasts Gameplay Events to trigger event-tagged abilities on source/target ASCs

Performance Notes

Event-Driven Execution: Only runs during Gameplay Effect execution (PostGameplayEffectExecute), not per-frame
Early Exit Optimization: Skips processing if overflow is zero or configuration tags are invalid
Server Authority Only: Executes on server during PostGameplayEffectExecute (no client overhead)
Minimal Overhead: Simple attribute reads with conditional event broadcast using GAS native functionality

Common Pin Types

Data: FGameplayEffectModCallbackData - Callback data from PostGameplayEffectExecute containing effect context, evaluated attribute, magnitude, source/target ASCs, and ability instance reference for overflow detection and event payload construction