# Get Unit Damage Taken Time

Flags — Native | Function

Returns time for how long it’s been since the unit has taken damage.

# Arguments

unit — Unit

Returns — fixed

native fixed UnitGetDamageTakenTime(unit inUnit);

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

campaigns/void.sc2campaign — base.sc2maps/maps/campaign/void/pkorhal02.sc2map/MapScript.galaxy:1965

                            autoE09DFEAF_var = UnitGroupUnitFromEnd(autoE09DFEAF_g, autoE09DFEAF_u);
                            if (autoE09DFEAF_var == null) { break; }
                            if ((UnitGetDamageTakenTime(autoE09DFEAF_var) <= 1.0)) {
                                lv_campAggro = true;
                            }

campaigns/void.sc2campaign — base.sc2maps/maps/campaign/void/ppurifier03.sc2map/MapScript.galaxy:2905


    while ((libVCMI_gf_GameIsOver() == false)) {
        if ((UnitGetDamageTakenTime(gv_purifierCoreMatrix) <= 4.0)) {
            if ((lv_pingActive == false)) {
                lv_pingActive = true;

campaigns/void.sc2campaign — base.sc2maps/maps/campaign/void/ppurifier03.sc2map/MapScript.galaxy:2982

    libVoiC_gf_SetAllSoundChannelVolumesCampaign(libVoiC_ge_VolumeChannelModeCampaign_Game);
    TriggerQueueExit();
    while (!((UnitGetDamageTakenTime(gv_purifierCoreMatrix) > 20.0))) {
        Wait(1.0, c_timeAI);
    }

campaigns/void.sc2campaign — base.sc2maps/maps/campaign/void/sc2epilogue02.sc2map/MapScript.galaxy:3119

    libVoiC_gf_SetAllSoundChannelVolumesCampaign(libVoiC_ge_VolumeChannelModeCampaign_Game);
    TriggerQueueExit();
    while (!((UnitGetDamageTakenTime(gv_kERRIGAN) > 20.0))) {
        Wait(1.0, c_timeGame);
    }

campaigns/void.sc2campaign — base.sc2maps/maps/campaign/void/sc2epilogue02.sc2map/MapScript.galaxy:3170

    libVoiC_gf_SetAllSoundChannelVolumesCampaign(libVoiC_ge_VolumeChannelModeCampaign_Game);
    TriggerQueueExit();
    while (!((UnitGetDamageTakenTime(gv_kERRIGAN) > 20.0))) {
        Wait(1.0, c_timeGame);
    }

campaigns/void.sc2campaign — base.sc2maps/maps/campaign/void/sc2epilogue02.sc2map/MapScript.galaxy:3221

    libVoiC_gf_SetAllSoundChannelVolumesCampaign(libVoiC_ge_VolumeChannelModeCampaign_Game);
    TriggerQueueExit();
    while (!((UnitGetDamageTakenTime(gv_kERRIGAN) > 20.0))) {
        Wait(1.0, c_timeGame);
    }

campaigns/void.sc2campaign/base.sc2maps/maps/campaign/void/pkorhal02.sc2map — MapScript.galaxy:1965

                            autoE09DFEAF_var = UnitGroupUnitFromEnd(autoE09DFEAF_g, autoE09DFEAF_u);
                            if (autoE09DFEAF_var == null) { break; }
                            if ((UnitGetDamageTakenTime(autoE09DFEAF_var) <= 1.0)) {
                                lv_campAggro = true;
                            }

campaigns/void.sc2campaign/base.sc2maps/maps/campaign/void/ppurifier03.sc2map — MapScript.galaxy:2905


    while ((libVCMI_gf_GameIsOver() == false)) {
        if ((UnitGetDamageTakenTime(gv_purifierCoreMatrix) <= 4.0)) {
            if ((lv_pingActive == false)) {
                lv_pingActive = true;

campaigns/void.sc2campaign/base.sc2maps/maps/campaign/void/ppurifier03.sc2map — MapScript.galaxy:2982

    libVoiC_gf_SetAllSoundChannelVolumesCampaign(libVoiC_ge_VolumeChannelModeCampaign_Game);
    TriggerQueueExit();
    while (!((UnitGetDamageTakenTime(gv_purifierCoreMatrix) > 20.0))) {
        Wait(1.0, c_timeAI);
    }

campaigns/void.sc2campaign/base.sc2maps/maps/campaign/void/sc2epilogue02.sc2map — MapScript.galaxy:3119

    libVoiC_gf_SetAllSoundChannelVolumesCampaign(libVoiC_ge_VolumeChannelModeCampaign_Game);
    TriggerQueueExit();
    while (!((UnitGetDamageTakenTime(gv_kERRIGAN) > 20.0))) {
        Wait(1.0, c_timeGame);
    }

campaigns/void.sc2campaign/base.sc2maps/maps/campaign/void/sc2epilogue02.sc2map — MapScript.galaxy:3170

    libVoiC_gf_SetAllSoundChannelVolumesCampaign(libVoiC_ge_VolumeChannelModeCampaign_Game);
    TriggerQueueExit();
    while (!((UnitGetDamageTakenTime(gv_kERRIGAN) > 20.0))) {
        Wait(1.0, c_timeGame);
    }

campaigns/void.sc2campaign/base.sc2maps/maps/campaign/void/sc2epilogue02.sc2map — MapScript.galaxy:3221

    libVoiC_gf_SetAllSoundChannelVolumesCampaign(libVoiC_ge_VolumeChannelModeCampaign_Game);
    TriggerQueueExit();
    while (!((UnitGetDamageTakenTime(gv_kERRIGAN) > 20.0))) {
        Wait(1.0, c_timeGame);
    }

mods/warcoop/warclassicsystem.sc2mod — base.sc2data/TriggerLibs/WarClassicTactical.galaxy:89

    // Automatic Variable Declarations
    // Implementation
    return ((UnitGetDamageTakenTime(lp_hero) < 1) && (UnitGetPropertyFixed(lp_hero, c_unitPropLife, c_unitPropCurrent) < libGAwT_gv_dYING_HERO_HP));
}

mods/warcoop/warclassicsystem.sc2mod — base.sc2data/TriggerLibs/WarClassicTactical.galaxy:437

    }

    if ((UnitGetDamageTakenTime(lp_aIUnit) > 1.0) && (UnitGetPropertyFixed(lp_aIUnit, c_unitPropLifePercent, c_unitPropCurrent) > 50.0) && (UnitGroupCount(UnitGroupFilterAlliance(lp_nearByUnits, lp_owner, c_unitAllianceEnemy, 3), c_unitCountAlive) <= 2)) {
        return ;
    }

mods/warcoop/warclassicsystem.sc2mod — base.sc2data/TriggerLibs/WarClassicTactical.galaxy:465

    }

    if ((UnitGetDamageTakenTime(lp_aIUnit) > 1.0)) {
        return ;
    }

mods/warcoop/warclassicsystem.sc2mod — base.sc2data/TriggerLibs/WarClassicTactical.galaxy:582


    lv_cost = libGAwT_gf_AIEffectAbilManaCost(lp_owner, lp_aIUnit, lp_abil, lv_level);
    if ((UnitGetDamageTakenTime(lp_aIUnit) > 1.0) && ((UnitGetPropertyFixed(lp_aIUnit, c_unitPropEnergy, c_unitPropCurrent) / 3.0) <= lv_cost)) {
        return ;
    }

# Get Unit Damage Taken Time

# Arguments

# Related

# Examples