update readme

EVENTS.md

@@ -165,10 +165,21 @@ end
 Fire when a spell cast applies an aura. "Self" covers casts that land on the active player (including cases where the active player is the caster with no explicit target); "Other" covers all other targets.
 
 These events are gated behind the `NP_EnableAuraCastEvents` CVar (default 0). Set it to `1` to enable.
-**Note:** some auras do not have spell effects and won’t trigger these events; the BUFF/DEBUFF gain events are the only way to track those.
+**Note:** some auras do not have spell effects and won't trigger these events; the BUFF/DEBUFF gain events are the only way to track those.
 
 These events are primarily intended for basic tracking of aura applications when buff/debuff caps prevent normal GAINS events from firing.
 
+#### Multi-Target Behavior
+These events fire separately for each target affected by the spell:
+- **Self-targeting spells** (e.g., buffs with TARGET_UNIT_CASTER) trigger once on the caster
+- **Single-target spells** (e.g., healing/damage spells) trigger once on the primary target
+- **AOE spells** (e.g., area buffs/debuffs) trigger once for each affected target based on the spell's implicit targeting rules
+- For AOE enemy spells, the event fires on all targets except the caster (if the caster is in the area)
+
+Each event fires once per qualifying spell effect per target. A spell with multiple aura-applying effects will trigger multiple events for the same target.
+
+**Note:** There may be edge cases or bugs with certain spells where targeting logic doesn't work as expected. If you encounter issues with specific spells not firing events correctly or firing too many/too few times, please report them in the issues tracker.
+
 Parameters:
 1.  int spellId
 2.  string casterGuid - caster guid like "0xF5300000000000A5"

README.md

@@ -146,7 +146,7 @@ Available events:
 - SPELL_CAST_EVENT - Fires when you cast a spell with additional information
 - SPELL_DAMAGE_EVENT_SELF and SPELL_DAMAGE_EVENT_OTHER - Combat damage events
 - Buff/Debuff Events (BUFF_ADDED_SELF, BUFF_REMOVED_SELF, etc.)
-- AURA_CAST_ON_SELF and AURA_CAST_ON_OTHER - Aura application events (fires once per aura effect; "Self" fires when the aura lands on the active player, including self-cast with no explicit target; includes aura metadata + amplitude/misc + aura cap bitfield for buff/debuff slots). Some auras don’t have spell effects and won’t trigger this; use BUFF/DEBUFF gains for those. Set `NP_EnableAuraCastEvents=1` to enable.
+- AURA_CAST_ON_SELF and AURA_CAST_ON_OTHER - Aura application events (fires once per aura effect per target; "Self" fires when the aura lands on the active player, including self-cast with no explicit target; includes aura metadata + amplitude/misc + aura cap bitfield for buff/debuff slots). Handles single-target and multi-target (AOE) spells. Some auras don't have spell effects and won't trigger this; use BUFF/DEBUFF gains for those. Set `NP_EnableAuraCastEvents=1` to enable. See EVENTS.md for details on multi-target behavior and known limitations.
 - UNIT_DIED - Fires when a unit dies
 
 ## Bug Reporting