healer-man/docs/DISARM_WEAPON_CONTRIBUTIONS_2026-10-05.md

# Disarm weapon contribution audit — 2026-10-05

This pass adds reusable character-side projections for item-dependent auras,
spell-selected weapon channels, and temporary weapon damage under the
source-backed Ascension/Epoch Disarm tags. The helpers are in
`src/game/enemyDisarmRuntime.ts`; the checks are in
`src/game/enemyDisarmRuntime.test.ts`.

## Core behavior verified

In the read-only historical AzerothCore tree, `SpellAuraEffects.cpp` maps Aura
67/254/278 to main-hand/off-hand/ranged flags. Applying Disarm recalculates the
player's item-dependent auras and weapon damage while retaining equipped item
stats. Removing Disarm clears the flag and recalculates the affected channel's
weapon auras. Creature spells use `Spell::CheckItems` to reject damage-class
melee/ranged spells whose selected attack type is unavailable.

`Player::HasItemFitToSpellRequirements` searches other usable equipped items
for a class/subclass/inventory-mask match. Passive item-requirement auras are
removed when Disarm leaves no matching usable weapon. The core keeps an active
nonpassive aura spell through the specific aura-cast exception. Separately,
`UpdateWeaponDependentAuras` recalculates weapon-aura contributions per attack
type, and `CheckAttackFitToAuraRequirement` tests the item in that channel.

`Spell` selects main-hand for a melee damage-class spell by default and
off-hand when AttributesEx3 `0x01000000` is set. A ranged damage-class spell
uses ranged when the core classifies it as a ranged-weapon spell; that decision
uses AttributesEx `USES_RANGED_SLOT` (`0x00000002`), the ranged weapon subclass
mask, or a Hunter-family exception. Other ranged damage-class spells use the
main-hand attack type. The player item check does not impose a blanket gate on
all physical damage-class casts.

The source was read from:

- `../wow-pvt-server-backups-2/azerothcore-wotlk/src/server/game/Spells/Auras/SpellAuraEffects.cpp`
- `../wow-pvt-server-backups-2/azerothcore-wotlk/src/server/game/Entities/Player/Player.cpp`
- `../wow-pvt-server-backups-2/azerothcore-wotlk/src/server/game/Spells/Spell.cpp`
- `../wow-pvt-server-backups-2/azerothcore-wotlk/src/server/game/Spells/SpellInfo.cpp`
- `../wow-pvt-server-backups-2/azerothcore-wotlk/src/server/shared/SharedDefines.h`
- `../wow-pvt-server-backups-2/azerothcore-wotlk/src/server/game/Entities/Item/ItemTemplate.h`

## Helper contracts

`enemyDisarmItemDependentAuraSuppressionIds` returns source-caster-owned
passive aura instance IDs whose matching equipped weapon slots are all
disabled. It preserves nonpassive aura spells and the stored aura state, so a
caller can build an effective combat aura view that restores the passive
contribution automatically when Disarm expires.

`enemyDisarmAurasForWeaponChannel` creates the attack-type-specific aura view.
It keeps an item-requirement aura contribution only when the selected usable
weapon matches the aura requirement, and suppresses it while that channel is
disarmed. This allows an enabled matching off-hand contribution to remain
available while the main-hand calculation uses the unarmed profile.

`enemyDisarmAbilityWeaponChannel` mirrors the source spell attack-type choice.
`enemyDisarmAdjustedAbilityWeapon` returns the 1–2 damage, 2-second unarmed
main-hand profile, no weapon for disabled off-hand/ranged channels, or the
unchanged weapon for other channels. Feral main-hand weapon stats remain
unchanged. `enemyDisarmBlocksNpcWeaponAbility` exposes the NPC-only selected
damage-class channel gate separately from player ability requirement checks.

## Integration boundary and limits

The party runtime uses `effectiveActorAuras` for global passive suppression and
channel-specific weapon-aura views. Party ability casts retain the player-style
equipped-item requirement gate, and generic amount calculations receive the
member's active Disarm channel set so source-selected weapon contribution can
be adjusted without rejecting unrelated physical casts. Party main-hand autos
use the source 1–2 / 2-second WoW punch; the dual-wield integration case confirms
an enabled off-hand still contributes. The party auto path also asks the native
Runewaker helper for a verified unarmed main-hand profile and cadence, while
ranged autos retain their existing channel behavior. Periodic party effects
are applied through `CombatStore.applyTimedActorEffect`; its native snapshot
path checks the source actor's active main-hand channel before passing the
verified profile into the native periodic calculator.

Generated party characters use the player's class item-requirement rules. The
hostile creature `Spell::CheckItems` channel gate remains available as a
separate helper and is not imposed on party class builds. The centralized
combat store owns the player and party passive-aura projection and generic
ability weapon contribution. The simulator still cannot infer item durability
or equipment eligibility missing from its resolved loadout.

Native Runewaker unarmed main-hand damage is implemented only when the active
five training profile is source-verifiable. Its sidecar does not model
`Main_DMG_Per`, `DMG_AllWeapon`, `DMG_Unarmed`, `AtkSpeed`, `Main_ATKSpeed_Per`,
`AttackSpeed_AllWeapon`, or `AttackSpeed_Unarmed`; those rate channels remain an
explicit neutral-rate boundary. Unsupported profiles keep their existing
fallback behavior rather than borrowing the WoW punch profile.

## Focused validation

`npx vitest run src/game/enemyWeaponDebuffs.test.ts
src/game/enemyDisarmRuntime.test.ts
src/game/enemyDisarmRuntime.integration.test.ts
src/game/romNativeDisarm.test.ts` passes: 4 files, 21 tests. The party integration
tests cover player and companion cast handling, an enabled party off-hand, native
main-hand damage/cadence, and the existing ranged Scout channel behavior.