# Add Charge Used For Unit Ability

Grammar — Add inVal charges used for charge inCharge on ability inAbil on unit inUnit
Flags — Native | Action

Consumes the specified number of charges for the specified ability charge link.

# Arguments

• unit — Unit
• string [ gamelink::Abil ] — Ability
• string [ charge ] — Charge
• fixed — Value

Returns — void

native void UnitAbilityAddChargeUsed(
	unit inUnit,
	string inAbil,
	string inCharge,
	fixed inVal,
);

# Related

Category: Unit / Charges And Cooldowns

• [F] — void — Add Charge Remaining Regen Time For Unit Behavior — ( UnitBehaviorAddChargeRegenRemaining )
• [F] — void — Add Charge Remaining Regen Time For Unit Ability — ( UnitAbilityAddChargeRegenRemaining )
• [F] — void — Add Charge Remaining Regen Time For Unit — ( UnitAddChargeRegenRemaining )
• [F] — void — Add Charge Full Regen Time For Unit Behavior — ( UnitBehaviorAddChargeRegenFull )
• [F] — void — Add Charge Full Regen Time For Unit Ability — ( UnitAbilityAddChargeRegenFull )
• [F] — void — Add Charge Full Regen Time For Unit — ( UnitAddChargeRegenFull )
• [F] — void — Add Charge Used For Unit Behavior — ( UnitBehaviorAddChargeUsed )
• [F] — void — Add Charge Used For Unit Ability — ( UnitAbilityAddChargeUsed )
• [F] — void — Add Charge Used For Unit — ( UnitAddChargeUsed )
• [F] — void — Remove Charge Used For Unit Behavior — ( libNtve_gf_UnitBehaviorRemoveChargeUsed )
• [F] — void — Remove Charge Used For Unit Ability — ( libNtve_gf_UnitAbilityRemoveChargeUsed )
• [F] — void — Remove Charge Used For Unit — ( libNtve_gf_UnitRemoveChargeUsed )
• [F] — fixed — Charge Regen Remaining For Unit Behavior — ( UnitBehaviorGetChargeRegen )
• [F] — fixed — Charge Regen Remaining For Unit Ability — ( UnitAbilityGetChargeRegen )
• [F] — fixed — Charge Regen Remaining For Unit — ( UnitGetChargeRegen )
• [F] — fixed — Charge Regen Full For Unit Behavior — ( UnitBehaviorGetChargeRegenFull )
• [F] — fixed — Charge Regen Full For Unit Ability — ( UnitAbilityGetChargeRegenFull )
• [F] — fixed — Charge Regen Full For Unit — ( UnitGetChargeRegenFull )
• [F] — fixed — Charge Used For Unit Behavior — ( UnitBehaviorGetChargeUsed )
• [F] — fixed — Charge Used For Unit Ability — ( UnitAbilityGetChargeUsed )
• [F] — fixed — Charge Used For Unit — ( UnitGetChargeUsed )
• [F] — void — Add Cooldown For Unit Behavior — ( UnitBehaviorAddCooldown )
• [F] — void — Add Cooldown For Unit Ability — ( UnitAbilityAddCooldown )
• [F] — void — Modify Cooldown For Unit — ( UnitModifyCooldown )
• [F] — void — Clear Cooldowns For Unit — ( UnitClearCooldowns )
• [F] — void — Remove Cooldown For Unit Behavior — ( libNtve_gf_UnitBehaviorRemoveCooldown )
• [F] — void — Remove Cooldown For Unit Ability — ( libNtve_gf_UnitAbilityRemoveCooldown )
• [F] — void — Remove Cooldown For Unit — ( libNtve_gf_UnitRemoveCooldown )
• [F] — fixed — Cooldown For Unit Behavior — ( UnitBehaviorGetCooldown )
• [F] — fixed — Cooldown For Unit Abilty — ( UnitAbilityGetCooldown )
• [F] — fixed — Cooldown For Unit — ( UnitGetCooldown )
• [F] — void — Activate Ability Cooldowns — ( UnitAbilitySpendExplicit )
• [F] — void — Reset Ability Cooldowns — ( UnitAbilityReset )
• [F] — fixed — Ability Charge Info For Unit — ( UnitAbilityChargeInfo )

# Examples

# mods/core.sc2mod

— NativeLib.galaxy

// L5843
UnitAbilityAddChargeUsed(lp_inUnit, lp_inAbil, lp_inCharge, (-1.0 * UnitAbilityGetChargeUsed(lp_inUnit, lp_inAbil, lp_inCharge)))

// L4981
UnitAbilityAddChargeUsed(lp_inUnit, lp_inAbil, lp_inCharge, (-1.0 * UnitAbilityGetChargeUsed(lp_inUnit, lp_inAbil, lp_inCharge)))

# mods/heroesbrawlmods/brawlmapmods/coop/deadmansstand.stormmod

— LibPEB1.galaxy

// L2476
UnitAbilityAddChargeUsed(libPEB1_gv_currentScourgeMissileCaster, "GhostShipBombardChargedPort", "Abil/BattleshipBombardCharged", 1.0)

# mods/heroesmapmods/battlegroundmapmods/blackheartsbay.stormmod

— LibBBAY.galaxy

// L283
UnitAbilityAddChargeUsed(libBBAY_gv_mMBBCannonballsGhostShip, "GhostShipBombardChargedPort", "Abil/BattleshipBombardCharged", (lv_currentCharges - lv_targetCharges))

// L284
UnitAbilityAddChargeUsed(libBBAY_gv_mMBBCannonballsGhostShip, "GhostShipBombardChargedStarboard", "Abil/BattleshipBombardCharged", (lv_currentCharges - lv_targetCharges))

# mods/starcoop/starcoop.sc2mod

— LibCOMI.galaxy

// L14351
UnitAbilityAddChargeUsed(lv_warpGate, libCOMI_gv_warpGateTrainAbility, "WarpGateTrain", -1.0)

// L14454
UnitAbilityAddChargeUsed(lv_warpGate, libCOMI_gv_warpGateTrainAbility, "WarpGateTrain", -1.0)

# mods/starcoop/starcoop.sc2mod

— LibCOMU.galaxy

// L3413
UnitAbilityAddChargeUsed(libCOMU_gv_cT_CandyBowlUnit, "MutatorBuyCandy", "Abil/MutatorBuyCandy", 1.0)

// L7624
UnitAbilityAddChargeUsed(libCOMU_gv_cT_CandyBowlUnit, "MutatorBuyCandy", "Abil/MutatorBuyCandy", lv_initialCandy)