# Triggering Damage Attempted

Grammar — Triggering damage attempted
Flags — Native | Function

Returns the triggering damage amount attempted. This is the damage done before clamping against the amount of life the target unit has. Not modified by damage responses.

Returns — fixed

native fixed EventUnitDamageAttempted();

# Supported triggers

• Unit Takes Damage — TriggerAddEventUnitDamaged

# Related

Category: Unit / Combat

• Get Unit Damage Dealt Time — fixed — UnitGetDamageDealtTime
• Get Unit Damage Taken Time — fixed — UnitGetDamageTakenTime
• Weapon Used In Attack — string<gamelink::Weapon> — EventUnitGetWeapon
• Item Used In Attack — unit — EventUnitGetItem
• Item Type Used In Attack — string<gamelink::Item> — EventUnitGetItemType
• Unit Dies — void — TriggerAddEventUnitDied
• Killing Unit — unit — libNtve_gf_KillingUnit
• Killing Player — int — libNtve_gf_KillingPlayer
• Triggering Death Type Check — bool — EventUnitDamageDeathCheck
• Unit Is Being Removed — void — TriggerAddEventUnitRemoved
• Unit Starts Attacking (Deprecated) — void — TriggerAddEventUnitStartedAttack
• Unit Starts Attacking — void — TriggerAddEventUnitStartedAttack2
• Unit Is Attacked (Deprecated) — void — TriggerAddEventUnitAttacked
• Unit Is Attacked — void — TriggerAddEventUnitAttacked2
• Attacking Unit — unit — EventUnitTarget
• Unit Absorbs Damage — void — TriggerAddEventUnitDamageAbsorbed
• Unit Takes Damage — void — TriggerAddEventUnitDamaged
• Damaging Unit — unit — EventUnitDamageSourceUnit
• Damaging Player — int — EventUnitDamageSourcePlayer
• Damaging Effect — string<gamelink::Effect> — EventUnitDamageEffect
• Triggering Damage Taken — fixed — EventUnitDamageAmount
• Triggering Damage Attempted — fixed — EventUnitDamageAttempted
• Triggering Damage Attempted Vitals — fixed — EventUnitDamageAttemptedVitals
• Triggering Damage Absorbed — fixed — EventUnitDamageAbsorbed
• Triggering Damage Behavior Shield — fixed — EventUnitDamageBehaviorShield
• Triggering Vitals Leeched — fixed — EventUnitDamageVitalsLeeched
• Triggering Unit Kill XP — int — EventUnitDamageKillXP
• Damage Source Position — point — EventUnitDamageSourcePoint
• Unit is Healed — void — TriggerAddEventUnitHealed
• Healing Unit — unit — EventUnitHealLaunchUnit
• Healing Player — int — EventUnitHealLaunchPlayer
• Triggering Heal Vital Type — int<preset::UnitVitalType> — EventUnitHealVital
• Triggering Heal Given — fixed — EventUnitHealAmount
• Healing Effect — string<gamelink::Effect> — EventUnitHealEffect
• Unit Spends Vital — void — TriggerAddEventUnitSpendVital
• Triggering Spent Vital Type — int<preset::UnitVitalType> — EventUnitSpentVitalVital
• Triggering Vital Spent — fixed — EventUnitSpentVitalAmount
• Unit Acquires Target — void — TriggerAddEventUnitAcquiredTarget
• Acquired Target — unit — libNtve_gf_AcquiredTarget
• Unit Is Revived — void — TriggerAddEventUnitRevive
• Triggering Victim Unit — unit — EventUnitVictimUnit
• Triggering Item Used — unit — EventUnitItemUsed
• Triggering Effect Used — string<gamelink::Effect> — EventUnitEffectUsed

# Examples

mods/heroesdata.stormmod — base.stormdata/TriggerLibs/GameDataHelperLib.galaxy:8923

    lv_chen = EventUnit();
    lv_chenOwner = UnitGetOwner(lv_chen);
    lv_damageTaken = EventUnitDamageAttempted();
    lv_damageTakenInteger = FixedToInt((lv_damageTaken * -1.0));

mods/heroesdata.stormmod — base.stormdata/TriggerLibs/GameDataHelperLib.galaxy:24169

    // Automatic Variable Declarations
    // Variable Initialization
    lv_damageDealt = EventUnitDamageAttempted();
    lv_damageScale = 1.75;
    lv_tyrande = EventUnitDamageSourceUnit();

mods/heroesdata.stormmod — base.stormdata/TriggerLibs/SupportLib.galaxy:2483

    }

    lv_damageAttempted = EventUnitDamageAttempted();
    lv_damageDone = EventUnitDamageAmount();
    lv_damagingEffect = EventUnitDamageEffect();

mods/heroesdata.stormmod — base.stormdata/TriggerLibs/UILib.galaxy:9026

        }

        if (!((EventUnitDamageAttempted() > 0))) {
            return false;
        }

mods/heromods/yrel.stormmod — base.stormdata/LibHYRL.galaxy:551

    }

    lv_damageAmount = (libHYRL_gv_heroYrelArdentDefenderDamageConversionScale * (EventUnitDamageAttempted() + EventUnitDamageBehaviorShield()));
    CatalogFieldValueSetFixed(c_gameCatalogEffect, "YrelArdentDefenderCreateHealer", "RechargeVitalRate", lv_yrelPlayer, lv_damageAmount);
    UnitCreateEffectUnit(lv_yrelUnit, "YrelArdentDefenderHealSet", lv_yrelUnit);

mods/starcoop/starcoop.sc2mod — base.sc2data/LibCOMI.galaxy:18149

    }

    lv_damageDone = EventUnitDamageAttempted();
    UnitSetCustomValue(EventUnit(), 62, (UnitGetCustomValue(EventUnit(), 62) + lv_damageDone));
    return true;