# Unit Takes Damage

Grammar — u takes damageFatalOption damageType damage (from damageEffect effects)
Flags — Native | Event

This event fires when a unit takes damage. Use “Damage Source Position” to get the position of the damage source. Use “Damaging Player” to get the owner of the unit that is dealing damage. Use “Damaging Unit” to get the unit that is dealing damage. Use “Triggering Damage Amount” to get the amount of damage being dealt. Use “Triggering Player” to get the owner of the unit that is taking damage. Use “Triggering Unit” to get the unit that is taking damage.

# Arguments

• unitref [ unit ] — Unit
• int [ preset::DamageType ] — Damage Type
• int [ preset::DamageFatalOption ] — Damage Fatal Option
• string [ gamelink::Effect ] — Damage Effect

Returns — void

native void TriggerAddEventUnitDamaged(
	trigger inTrigger,
	unitref inUnit,
	int inDamageType,
	int inDamageFatal,
	string inEffect,
);

# Event parameters

• Triggering Game User — EventGameUser
• Triggering Player — EventPlayer
• Triggering Unit — EventUnit
• Item Used In Attack — EventUnitGetItem
• Item Type Used In Attack — EventUnitGetItemType
• Damaging Unit — EventUnitDamageSourceUnit
• Damaging Player — EventUnitDamageSourcePlayer
• Triggering Damage Taken — EventUnitDamageAmount
• Triggering Damage Attempted — EventUnitDamageAttempted
• Triggering Damage Attempted Vitals — EventUnitDamageAttemptedVitals
• Triggering Damage Absorbed — EventUnitDamageAbsorbed
• Triggering Damage Behavior Shield — EventUnitDamageBehaviorShield
• Triggering Vitals Leeched — EventUnitDamageVitalsLeeched
• Triggering Unit Kill XP — EventUnitDamageKillXP
• Damage Source Position — EventUnitDamageSourcePoint
• Healing Unit — EventUnitHealLaunchUnit
• Healing Player — EventUnitHealLaunchPlayer
• Triggering Heal Vital Type — EventUnitHealVital
• Triggering Heal Given — EventUnitHealAmount
• Triggering Spent Vital Type — EventUnitSpentVitalVital
• Triggering Vital Spent — EventUnitSpentVitalAmount

# Related

Category: Unit / Combat

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

# Examples

# campaigns/liberty.sc2campaign

— MapScript.galaxy

// L8081
TriggerAddEventUnitDamaged(gt_BossHPBar, null, c_unitDamageTypeAny, c_unitDamageEither, null)

// L8151
TriggerAddEventUnitDamaged(gt_UnitHPBar, null, c_unitDamageTypeAny, c_unitDamageEither, null)

// L2658
TriggerAddEventUnitDamaged(gt_ConvoyGuardsareUnderAttackQ, null, c_unitDamageTypeAny, c_unitDamageEither, null)

// L1183
TriggerAddEventUnitDamaged(gt_InfestorNorthFoundEarly, UnitRefFromUnit(UnitFromId(1110)), c_unitDamageTypeAny, c_unitDamageEither, null)

// L1213
TriggerAddEventUnitDamaged(gt_InfestorSouthFoundEarly, UnitRefFromUnit(UnitFromId(927)), c_unitDamageTypeAny, c_unitDamageEither, null)

// L3489
TriggerAddEventUnitDamaged(gt_TransmissionInfestedRefugeeSightedQ, null, c_unitDamageTypeAny, c_unitDamageEither, null)

// L3544
TriggerAddEventUnitDamaged(gt_TransmissionInfestedMarineSightedQ, null, c_unitDamageTypeAny, c_unitDamageEither, null)

// L3602
TriggerAddEventUnitDamaged(gt_TransmissionAberrationSightedQ, null, c_unitDamageTypeAny, c_unitDamageEither, null)

// L4343
TriggerAddEventUnitDamaged(gt_TransmissionBetaShipUnderAttackQ, null, c_unitDamageTypeAny, c_unitDamageEither, null)

// L4393
TriggerAddEventUnitDamaged(gt_TransmissionGammaShipUnderAttackQ, null, c_unitDamageTypeAny, c_unitDamageEither, null)

// L4443
TriggerAddEventUnitDamaged(gt_TransmissionOmegaShipUnderAttackQ, null, c_unitDamageTypeAny, c_unitDamageEither, null)

// L4502
TriggerAddEventUnitDamaged(gt_VictoryDestroyOrlanCompleted, null, c_unitDamageTypeAny, c_unitDamageEither, null)

// L4376
TriggerAddEventUnitDamaged(gt_AchievementOdinHealthBelow30Hard, null, c_unitDamageTypeAny, c_unitDamageEither, null)

// L5768
TriggerAddEventUnitDamaged(gt_MidValhallaDoorDamage, UnitRefFromUnit(UnitFromId(341)), c_unitDamageTypeAny, c_unitDamageEither, null)

// L1378
TriggerAddEventUnitDamaged(gt_CiviliansAttackedandCower, null, c_unitDamageTypeAny, c_unitDamageEither, EventUnitDamageEffect())

// L4908
TriggerAddEventUnitDamaged(gt_TransmissionCivilianSquishArea1Q, null, c_unitDamageTypeAny, c_unitDamageEither, EventUnitDamageEffect())

// L4948
TriggerAddEventUnitDamaged(gt_TransmissionCivilianSquishArea2Q, null, c_unitDamageTypeAny, c_unitDamageEither, EventUnitDamageEffect())

// L4988
TriggerAddEventUnitDamaged(gt_TransmissionCivilianSquishArea3Q, null, c_unitDamageTypeAny, c_unitDamageEither, EventUnitDamageEffect())

// L5028
TriggerAddEventUnitDamaged(gt_TransmissionCivilianSquishArea4Q, null, c_unitDamageTypeAny, c_unitDamageEither, EventUnitDamageEffect())

// L5068
TriggerAddEventUnitDamaged(gt_TransmissionCivilianSquishArea5Q, null, c_unitDamageTypeAny, c_unitDamageEither, EventUnitDamageEffect())

// L2576
TriggerAddEventUnitDamaged(gt_ScientistsRunFromFire, null, c_unitDamageTypeAny, c_unitDamageEither, null)

// L6210
TriggerAddEventUnitDamaged(gt_FusionCoreTakesDamage, null, c_unitDamageTypeAny, c_unitDamageEither, null)

// L6240
TriggerAddEventUnitDamaged(gt_Rockstakedamage, null, c_unitDamageTypeAny, c_unitDamageEither, null)

// L9961
TriggerAddEventUnitDamaged(gt_HybridRegeneration, null, c_unitDamageTypeAny, c_unitDamageEither, null)

// L1214
TriggerAddEventUnitDamaged(gt_RoadblockAttacked, null, c_unitDamageTypeAny, c_unitDamageEither, null)

// L2276
TriggerAddEventUnitDamaged(gt_EscapeDamage, UnitRefFromUnit(UnitFromId(1615)), c_unitDamageTypeAny, c_unitDamageEither, null)

// L2277
TriggerAddEventUnitDamaged(gt_EscapeDamage, UnitRefFromUnit(UnitFromId(1464)), c_unitDamageTypeAny, c_unitDamageEither, null)

// L4557
TriggerAddEventUnitDamaged(gt_ObjectiveDestroyDominionHoloboardsUpdate, null, c_unitDamageTypeAny, c_unitDamageFatal, null)

// L1028
TriggerAddEventUnitDamaged(gt_DirtyBanelingCrewViaDamage, null, c_unitDamageTypeAny, c_unitDamageEither, null)

// L1736
TriggerAddEventUnitDamaged(gt_BrutaliskRemovePingActor, UnitRefFromUnit(UnitFromId(407)), c_unitDamageTypeAny, c_unitDamageEither, null)

// L1390
TriggerAddEventUnitDamaged(gt_HarvestingSpeedBumpsNWesternTerritory, null, c_unitDamageTypeAny, c_unitDamageEither, null)

// L1437
TriggerAddEventUnitDamaged(gt_HarvestingSpeedBumpsCentralTerritory, null, c_unitDamageTypeAny, c_unitDamageEither, null)

// L1659
TriggerAddEventUnitDamaged(gt_ToshVictims, null, c_unitDamageTypeAny, c_unitDamageEither, null)

// L2372
TriggerAddEventUnitDamaged(gt_CellBlockAPatrolSearching, null, c_unitDamageTypeAny, c_unitDamageEither, null)

// L4420
TriggerAddEventUnitDamaged(gt_StatEnemiesKilledByNukes, null, c_unitDamageTypeAny, c_unitDamageFatal, "HeroNukeDamage")

// L4503
TriggerAddEventUnitDamaged(gt_StatToshLowestHealth, UnitRefFromVariable("gv_tosh"), c_unitDamageTypeAny, c_unitDamageEither, null)

// L1621
TriggerAddEventUnitDamaged(gt_P1MiTuGuardsEngaged, null, c_unitDamageTypeAny, c_unitDamageNonFatal, null)

// L1676
TriggerAddEventUnitDamaged(gt_P1MiTuHelpMeQ, null, c_unitDamageTypeAny, c_unitDamageNonFatal, null)

// L1887
TriggerAddEventUnitDamaged(gt_P1NighthawkSpot, null, c_unitDamageTypeAny, c_unitDamageNonFatal, null)

// L2400
TriggerAddEventUnitDamaged(gt_P2RavenAttacked, null, c_unitDamageTypeAny, c_unitDamageNonFatal, null)

// L2589
TriggerAddEventUnitDamaged(gt_P2LZVikingsLand, null, c_unitDamageTypeAny, c_unitDamageEither, null)

// L3177
TriggerAddEventUnitDamaged(gt_P2BansheeCloak, UnitRefFromUnit(UnitFromId(684)), c_unitDamageTypeAny, c_unitDamageEither, null)

// L3874
TriggerAddEventUnitDamaged(gt_P3SouthViking, null, c_unitDamageTypeAny, c_unitDamageEither, null)

// L3918
TriggerAddEventUnitDamaged(gt_P3NorthViking, null, c_unitDamageTypeAny, c_unitDamageEither, null)

// L3959
TriggerAddEventUnitDamaged(gt_P3SouthRavenDrone, null, c_unitDamageTypeAny, c_unitDamageEither, null)

// L4000
TriggerAddEventUnitDamaged(gt_P3SouthRavenTurrets, null, c_unitDamageTypeAny, c_unitDamageEither, null)

// L1104
TriggerAddEventUnitDamaged(gt_OutsideProtossBaseWarpIn, null, c_unitDamageTypeAny, c_unitDamageEither, null)

// L1321
TriggerAddEventUnitDamaged(gt_StalkerAggro, null, c_unitDamageTypeAny, c_unitDamageEither, null)

// L2066
TriggerAddEventUnitDamaged(gt_Laserisattackedbyenemy, UnitRefFromUnit(UnitFromId(409)), c_unitDamageTypeAny, c_unitDamageEither, null)

// L2115
TriggerAddEventUnitDamaged(gt_LaserisattackedbyplayerQ, UnitRefFromUnit(UnitFromId(409)), c_unitDamageTypeAny, c_unitDamageEither, null)

// L1964
TriggerAddEventUnitDamaged(gt_RipFieldGeneratorResponse1, null, c_unitDamageTypeAny, c_unitDamageEither, null)

// L1992
TriggerAddEventUnitDamaged(gt_RipFieldGeneratorResponse2, null, c_unitDamageTypeAny, c_unitDamageEither, null)

// L2020
TriggerAddEventUnitDamaged(gt_XelnagaVaultResponse, null, c_unitDamageTypeAny, c_unitDamageEither, null)

// L2584
TriggerAddEventUnitDamaged(gt_MothershipWarmholeVAULT, null, c_unitDamageTypeAny, c_unitDamageNonFatal, null)

// L2626
TriggerAddEventUnitDamaged(gt_MothershipWarmhole75health, null, c_unitDamageTypeAny, c_unitDamageNonFatal, null)

// L2668
TriggerAddEventUnitDamaged(gt_MothershipWarmhole30health, null, c_unitDamageTypeAny, c_unitDamageNonFatal, null)

// L1759
TriggerAddEventUnitDamaged(gt__1TeachSnipeTripViaDamage, null, c_unitDamageTypeAny, c_unitDamageEither, null)

// L1905
TriggerAddEventUnitDamaged(gt__1TeachSnipeAgainTripViaDamage, null, c_unitDamageTypeAny, c_unitDamageEither, null)

// L2058
TriggerAddEventUnitDamaged(gt__1TeachNadesTripViaDamage, null, c_unitDamageTypeAny, c_unitDamageEither, null)

// L2204
TriggerAddEventUnitDamaged(gt__1TeachNadesAgainTripViaDamage, null, c_unitDamageTypeAny, c_unitDamageEither, null)

// L2424
TriggerAddEventUnitDamaged(gt__1TeachBettyViaDamage, null, c_unitDamageTypeAny, c_unitDamageEither, null)

// L2608
TriggerAddEventUnitDamaged(gt__1ZergKillTeamTripViaDamage, null, c_unitDamageTypeAny, c_unitDamageEither, null)

// L3837
TriggerAddEventUnitDamaged(gt__2StoryTellingTripViaDamage, null, c_unitDamageTypeAny, c_unitDamageEither, null)

// L4007
TriggerAddEventUnitDamaged(gt__2ZombieRaid1TripViaDamage, null, c_unitDamageTypeAny, c_unitDamageEither, null)

// L4158
TriggerAddEventUnitDamaged(gt__2ZombieRaid2TripViaDamage, null, c_unitDamageTypeAny, c_unitDamageEither, null)

// L4439
TriggerAddEventUnitDamaged(gt__2BanelingSplashDetection, null, c_unitDamageTypeAny, c_unitDamageEither, null)

// L1893
TriggerAddEventUnitDamaged(gt_VoidPrisonVictim1Dies, UnitRefFromUnit(UnitFromId(36)), c_unitDamageTypeAny, c_unitDamageEither, null)

// L2042
TriggerAddEventUnitDamaged(gt_DyingUltralisk, UnitRefFromUnit(UnitFromId(230)), c_unitDamageTypeAny, c_unitDamageNonFatal, null)

// L4460
TriggerAddEventUnitDamaged(gt_DyingUltralisksHatchery2, null, c_unitDamageTypeAny, c_unitDamageEither, null)

// L5861
TriggerAddEventUnitDamaged(gt_KerriganRegeneration, null, c_unitDamageTypeAny, c_unitDamageEither, null)

// L7651
TriggerAddEventUnitDamaged(gt_AchievementZeratulHurtAdvanced, null, c_unitDamageTypeAny, c_unitDamageEither, null)

// L1953
TriggerAddEventUnitDamaged(gt_PsionicShockwaveFirst, null, c_unitDamageTypeAny, c_unitDamageEither, null)

// L2004
TriggerAddEventUnitDamaged(gt_PsionicShockwaveSecond, null, c_unitDamageTypeAny, c_unitDamageEither, null)

// L2059
TriggerAddEventUnitDamaged(gt_PsionicShockwaveThirdInsane, null, c_unitDamageTypeAny, c_unitDamageEither, null)

// L8081
TriggerAddEventUnitDamaged(gt_BossHPBar, null, c_unitDamageTypeAny, c_unitDamageEither, null)

// L8151
TriggerAddEventUnitDamaged(gt_UnitHPBar, null, c_unitDamageTypeAny, c_unitDamageEither, null)

// L2658
TriggerAddEventUnitDamaged(gt_ConvoyGuardsareUnderAttackQ, null, c_unitDamageTypeAny, c_unitDamageEither, null)

// L1183
TriggerAddEventUnitDamaged(gt_InfestorNorthFoundEarly, UnitRefFromUnit(UnitFromId(1110)), c_unitDamageTypeAny, c_unitDamageEither, null)

// L1213
TriggerAddEventUnitDamaged(gt_InfestorSouthFoundEarly, UnitRefFromUnit(UnitFromId(927)), c_unitDamageTypeAny, c_unitDamageEither, null)

// L3489
TriggerAddEventUnitDamaged(gt_TransmissionInfestedRefugeeSightedQ, null, c_unitDamageTypeAny, c_unitDamageEither, null)

// L3544
TriggerAddEventUnitDamaged(gt_TransmissionInfestedMarineSightedQ, null, c_unitDamageTypeAny, c_unitDamageEither, null)

// L3602
TriggerAddEventUnitDamaged(gt_TransmissionAberrationSightedQ, null, c_unitDamageTypeAny, c_unitDamageEither, null)

// L4343
TriggerAddEventUnitDamaged(gt_TransmissionBetaShipUnderAttackQ, null, c_unitDamageTypeAny, c_unitDamageEither, null)

// L4393
TriggerAddEventUnitDamaged(gt_TransmissionGammaShipUnderAttackQ, null, c_unitDamageTypeAny, c_unitDamageEither, null)

// L4443
TriggerAddEventUnitDamaged(gt_TransmissionOmegaShipUnderAttackQ, null, c_unitDamageTypeAny, c_unitDamageEither, null)

// L4502
TriggerAddEventUnitDamaged(gt_VictoryDestroyOrlanCompleted, null, c_unitDamageTypeAny, c_unitDamageEither, null)

// L4376
TriggerAddEventUnitDamaged(gt_AchievementOdinHealthBelow30Hard, null, c_unitDamageTypeAny, c_unitDamageEither, null)

// L5768
TriggerAddEventUnitDamaged(gt_MidValhallaDoorDamage, UnitRefFromUnit(UnitFromId(341)), c_unitDamageTypeAny, c_unitDamageEither, null)

// L1378
TriggerAddEventUnitDamaged(gt_CiviliansAttackedandCower, null, c_unitDamageTypeAny, c_unitDamageEither, EventUnitDamageEffect())

// L4908
TriggerAddEventUnitDamaged(gt_TransmissionCivilianSquishArea1Q, null, c_unitDamageTypeAny, c_unitDamageEither, EventUnitDamageEffect())

// L4948
TriggerAddEventUnitDamaged(gt_TransmissionCivilianSquishArea2Q, null, c_unitDamageTypeAny, c_unitDamageEither, EventUnitDamageEffect())

// L4988
TriggerAddEventUnitDamaged(gt_TransmissionCivilianSquishArea3Q, null, c_unitDamageTypeAny, c_unitDamageEither, EventUnitDamageEffect())

// L5028
TriggerAddEventUnitDamaged(gt_TransmissionCivilianSquishArea4Q, null, c_unitDamageTypeAny, c_unitDamageEither, EventUnitDamageEffect())

// L5068
TriggerAddEventUnitDamaged(gt_TransmissionCivilianSquishArea5Q, null, c_unitDamageTypeAny, c_unitDamageEither, EventUnitDamageEffect())

// L2576
TriggerAddEventUnitDamaged(gt_ScientistsRunFromFire, null, c_unitDamageTypeAny, c_unitDamageEither, null)

// L6210
TriggerAddEventUnitDamaged(gt_FusionCoreTakesDamage, null, c_unitDamageTypeAny, c_unitDamageEither, null)

// L6240
TriggerAddEventUnitDamaged(gt_Rockstakedamage, null, c_unitDamageTypeAny, c_unitDamageEither, null)

// L9961
TriggerAddEventUnitDamaged(gt_HybridRegeneration, null, c_unitDamageTypeAny, c_unitDamageEither, null)

// L1214
TriggerAddEventUnitDamaged(gt_RoadblockAttacked, null, c_unitDamageTypeAny, c_unitDamageEither, null)

// L2276
TriggerAddEventUnitDamaged(gt_EscapeDamage, UnitRefFromUnit(UnitFromId(1615)), c_unitDamageTypeAny, c_unitDamageEither, null)