AI Logic: Ability Usage Conditions

Sections on this Page

General Notes

This page lists out abilities available to enemy spellcasters and provides you with information on the conditions the AI uses to determine when and where to cast any ability. For units with multiple abilities, abilities at the top will be prioritized over abilities below them if they are off cooldown.

Usually for ability usage, "Vitality" is a key factor that is taken into consideration. Vitality is simply the sum of the current HP + Shields of a unit.

"Units Within Range" corresponds to the units within the range of the skill + 1, which allows for the unit to move a bit before casting its ability at maximum range.

Sometimes, a Vitality Score may be used for a group of units. A vitality score assigns a score from 0.0 to 1.0 for each enemy unit, spanning from vitality 0.0 to a certain damage value (which will be specified for each individual ability). You may think of a Vitality score as the number of units that an ability is expected to kill. An additional 1.0 points may be added for units with bonus tags. Unfortunately, further details on the Vitality Score calculation cannot be extracted.

Text that have been struck through is logic that is not being followed due to bugs in the code.

SUGGEST implies that an order suggestion will be sent to the AI for further decision-making. It may or may not carry out the order if it deems it unncessary.

Protoss Units

High Templar

High Templar

200 Energy

Skills:

Skill Name Description Cooldown Energy Cost
Psionic Storm Psionic Storm Creates a storm of psionic energy that lasts 4 seconds, causing up to 80 damage to all enemy units in the target area. Does not damage friendly units. 2s 75
Usage Logic
  • If High Templar is at 60% vitality or more:
    1. There are 3 or more enemy units within range
    2. The total vitality of those units is 100 or more
      ↪Trigger Psionic Storm

  • If High Templar is at less than 60% vitality:
    1. There is an enemy unit within range
    2. It has a vitality of 15 or more
      ↪Trigger Psionic Storm
Archon Merge Archon Merge Sacrifices 2 Templar to create an Archon. Can attack ground and air units. - -
Usage Logic
  1. A High Templar gets to a vitality of less than 60%
    ↪Trigger Archon Merge with any High Templar within 5 range.
Oracle

Oracle

200 Energy

Skills:

Skill Name Description Cooldown Energy Cost
Pulsar Beam Pulsar Beam Charges the Oracle's Pulsar Beam and allows it to attack enemy ground units. 4s 1.4/s
Usage Logic
  • If Oracle is at 50% vitality or more:
    1. There are 5 or more ground units
      ↪Trigger Pulsar Beam

  • If Oracle is at less than 50% vitality:
    1. There is a ground unit to attack
      ↪Trigger Pulsar Beam
Stasis Ward Stasis Ward Places a cloaked Stasis Ward at the target location. Once activated by an enemy ground unit, the ward traps nearby enemies in stasis for 15 seconds. Trapped units cannot be attacked or affected by abilities. 0s 50
Usage Logic
  • There are no enemies nearby
  • Oracle is less than 60 range away from the nearest enemy structure
  • Oracle has 80 energy or more
  • No stasis ward exists within 10 range
    ↪Trigger Stasis Ward
Sentry

Sentry

200 Energy

Skills:

Skill Name Description Cooldown Energy Cost
Guardian Shield Guardian Shield Creates a range 4 aura that reduces all incoming attack damage to friendly units by 2. Lasts 15 seconds. 15s 75
Usage Logic
  1. Sentry does not have Guardian Shield buff from another sentry
  2. There are 3 or more ranged enemy units or structures within range
    ↪Trigger Guardian Shield

Force Field Force Field Barrier that lasts 15 seconds and impedes movement of ground units. Massive units will shatter Force Fields on contact. 0s 50
Usage Logic
  1. Melee enemy within 1.5 range of the sentry
    ↪Trigger Force Field between Sentry and enemy unit
  1. Ally unit with less than 20 vitality with an enemy melee unit within 1.5 range of it
    ↪Trigger Force Field between ally unit and enemy unit
  1. Ally ranged unit with an enemy melee unit within 1.5 range of it
    ↪Trigger Force Field between ally unit and enemy unit
  1. Sentry has more than 125 energy
  2. Sentry has 40 vitality or less
  3. There are 6 or more ranged enemy units
  4. The enemy units have a Vitality Score of 6.0 with damage value 1
    ↪Trigger Force Field to split up enemy units

Terran Units

Note: AI Logic surrounding the usage of Ghost Nukes cannot be extracted from the game files.

For Liberators:

Liberators will switch to anti-air mode if:

For Siege Tanks:

Siege Tanks will siege up as long as there is a valid ground target within range.

Battlecruiser

Battlecruiser

200 Energy

Skills:

Skill Name Description Cooldown Energy Cost
Yamato Cannon Yamato Cannon Blasts a target with a devastating plasma cannon, causing 300 damage. 0s 100
Usage Logic
  1. Enemy unit or structure is not Heroic
  2. Enemy unit or structure has 225 vitality or more
    ↪Trigger Yamato Cannon
Ghost

Ghost

200 Energy

Skills:

Skill Name Description Cooldown Energy Cost
Snipe Sniper Round A careful shot, dealing 25(50 vs. Psionic) damage. Ignores armor. Can only target biological units. 0s 25
Usage Logic
  1. Enemy unit has 19 vitality or more
  2. Enemy unit is Biological and Visible
  3. Enemy unit is not Heroic
    ↪Trigger Sniper Round

EMP Round EMP Round Deals 100 damage to shields and depletes the energy of enemy units in the target area. Cloaked units are revealed for 10 seconds after being hit. 0s 75
Usage Logic
  1. Enemy unit has either: (70 shields or more) or (70 energy or more)
  2. There are 4 or more units in the range of the EMP
    ↪Trigger EMP Round

Raven

Raven

200 Energy

Skills:

Skill Name Description Cooldown Energy Cost
Seeker Missile Seeker Missile Deploys a Seeker Missile which activates after 5 seconds and pursues the target unit, dealing 100 (+35 vs. shields) splash damage upon contact. 0s 75
Usage Logic
  1. Enemy unit has 50 vitality or more
    ↪Trigger Seeker Missile
Point Defense Drone Point Defense Drone Uses a laser to shoot down enemy missiles. Cannot target special attacks. Times out after 180 seconds. Each shot consumes 10 energy. 0s 100
Usage Logic
  1. Calculates a score based on the number of enemy units nearby as follows:
    • Battlecruiser: +3/unit
    • Corruptor: +2/unit
    • Hydralisk: +1/unit
    • Mutalisk: +2/unit
    • Phoenix: +2/unit
    • Stalker: +1/unit
    • Viking (Fighter Mode): +2/unit
  2. Total score is 6 or more
    ↪Trigger Point Defense Drone
Build Auto-Turret Build Auto-Turret Automated defensive turret. Times out after 180 seconds. Can attack ground and air units. 0s 50
Usage Logic
  1. 2 or more enemy units within range of where the turret would be dropped
  2. If the Raven is at 65% vitality or more, vitality score of 1.5, otherwise Vitality Score of 0.5, both with damage value 40.
    ↪Trigger Build Auto-Turret
Science Vessel

Science Vessel

200 Energy

Skills:

Skill Name Description Cooldown Energy Cost
Defensive Matrix Defensive Matrix Surrounds the target with a shield that can absorb up to 200 damage. Effect lasts for 20 seconds. 20s 50
Usage Logic
  1. Unit does not have Defensive Matrix already
  2. Unit has lost more than 105 vitality
    ↪Trigger Defensive Matrix
Irradiate Irradiate Damages an enemy biological unit and adjacent enemy biological units, dealing 250 damage over 25 seconds. 0s 25
Usage Logic
  1. Enemy unit is Biological
  2. Enemy unit is not Heroic
    ↪Trigger Irradiate

Zerg Units

Brood Queen

Brood Queen

200 Energy

Skills:

Skill Name Description Cooldown Energy Cost
Ensnare Ensnare Reduces movement of units in the targeted area by 50% for 6 seconds. Reveals cloaked and burrowed units. 0s 25
Usage Logic
  1. The enemy units do not have Ensnare on them
  2. There are 2 or more enemy units or structures
  3. Vitality Score of 1.5 with damage value 20
    ↪Trigger Ensnare
Spawn Broodlings Spawn Broodlings Kills target enemy ground or air unit and spawns 2 Broodlings from its corpse. Massive units and heroic units are immune. 0s 100
Usage Logic
  1. The enemy units is a Siege Tank
    ↪Trigger Spawn Broodlings
Corruptor

Corruptor

0 Energy

Skills:

Skill Name Description Cooldown Energy Cost
Corruption Corruption Covers the target enemy unit in Zerg slime, increasing the damage taken by 20% for 30 seconds. 45s -
Usage Logic
  • If Corruptor is at 30% vitality or more:
    1. Enemy unit does not have Corruption on it
    2. Enemy unit has 120 vitality or more
      ↪Trigger Corruption

  • If Corruptor is at less than 30% vitality:
    1. Enemy unit does not have Corruption on it
    2. Enemy unit has 40 vitality or more
      ↪Trigger Corruption

Caustic Spray Caustic Spray Emits a stream of acid that deals 5 damage per second for 6 seconds, then increases to 25 damage per second. Channeled ability. Can only target enemy structures. 45s -
Usage Logic
  1. There are no enemy air units in range
  2. 1 or more enemy structures in range
    ↪Trigger Caustic Spray

Infestor

Infestor

200 Energy

Skills:

Skill Name Description Cooldown Energy Cost
Fungal Growth Fungal Growth Immobilizes enemy units and deals 38 damage over 4 seconds. Reveals cloaked and burrowed units. 0s 75
Usage Logic
  1. The enemy unit does not have Fungal Growth on it
  2. There are 5 or more enemy units
  3. Vitality Score of 3.5 with damage value 30
    ↪Trigger Fungal Growth
Infested Terran Infested Terran Spawn an Infested Terran. Infested Terrans last 30 seconds. 0s 25
Usage Logic
  • If Infestor is at 60% vitality or more:
    1. There are 4 or more enemy units within range
    2. Infestor has 125 energy or more
      ↪Trigger Infested Terran

  • If Infestor is at less than 60% vitality:
    1. There are 1 or more enemy units within range
      ↪Trigger Infested Terran

Viper

Viper

200 Energy

Skills:

Skill Name Description Cooldown Energy Cost
Parasitic Bomb Parasitic Bomb Creates a parasitic cloud of radius 3 that deals 90 damage over 10 seconds to the target and enemy air units nearby. If the target dies, the cloud remains in the air where the enemy died until it expires. Cannot target ground units or structures. 0s 125
Usage Logic
  1. Enemy air unit doesn't have Parasitic Bomb casted on it
  2. 1 Enemy unit or more
  3. A Vitality Score of 0.5 with damage value 50
    ↪Trigger Parasitic Bomb
Disabling Cloud Disabling Cloud Creates a cloud that slows movement speed and prevents enemy units and structures from attacking and using energy-based abilities. Lasts for 10 seconds. 0s 75
Usage Logic
  1. There are 5 or more enemy units within range
  2. Enemies have a vitality of 50 or more
  3. Vitality Score of 4.5, with damage value 10
    ↪Trigger Disabling Cloud
Abduct Abduct Pulls target unit to the Viper. Enemy is stunned for 1 second. 0s 25
Usage Logic
  1. The enemy unit is more than 8 range away from the Viper
  2. Enemy unit is either: (Massive) or (a Siege Tank)
    ↪Trigger Abduct
Consumption Consumption Drains up to 75 life from a friendly Zerg unit and gives the Viper 2 energy for each point of life drained. 10s 0
Usage Logic
  1. There is an allied unit nearby
  2. The allied unit has more than 75 life
    ↪Trigger Consumption

Mission Objective Units

For a lot of mission objective units, the presence of a single enemy unit is enough for it to start spamming its skills, picking random units to target. If an objective unit is not present in this list, it may be assumed that this logic applies.

Additionally, only real abilities will be listed here. Simulated abilities (such as Part and Parcel's Hybrid Abilities) will not be shown.

Choker

Choker

0 Energy

Skills:

Skill Name Description Cooldown Energy Cost
Tentacle Attack Tentacle Attack Shoots up to 5 tentacles that pull targets toward the Choker and deal damage over time. 6s -
Usage Logic
  1. 1 Enemy unit or more
  2. A Vitality Score of 2.0 with damage value 64
    ↪Trigger Tentacle Attack
Slayn Elemental

Slayn
Elemental

0 Energy

Skills:

Skill Name Description Cooldown Energy Cost
Essence Leech AOE Essence Leech AOE - 0s -
Usage Logic
  1. There are 8 or more non-heroic enemy units within 10 range or structures within 15 range
  2. A Vitality Score of 3.5 with damage value 10
    ↪Trigger Essence Leech AOE
Essence Leech Essence Leech Siphons energy from targeted unit. 0s -
Usage Logic
  1. Slayn Elemental is in combat
    • If the last attacking unit is within 20 range of the elemental:
      ↪Trigger Essence Leech
      ↪Trigger Essence Leech AOE
    • If the last attacking unit is over 20 range of the elemental:
      ↪Trigger Essence Leech on random nearest enemy unit within 10 range
      ↪Trigger Essence Leech AOE on random nearest enemy unit within 10 range
Stank

Stank

0 Energy

Skills:

Skill Name Description Cooldown Energy Cost
Headbutt Headbutt Deals massive damage to structures. 5s -
Usage Logic
  1. Stank is 40% vitality or less
  2. There is either (4 or more enemy units within range) or (1 or more enemy sturctures within range):
    ↪Trigger Headbutt
Void Shard

Void
Shard

0 Energy

Skills:

Skill Name Description Cooldown Energy Cost
Void Zone Void Zone - 30s -
Usage Logic
  1. There are 1 or more enemy units nearby
  2. Highest Vitality Score from 1-4 with damage value 35
    ↪Trigger Void Zone
Void Thrasher

Void
Thrasher

0 Energy

Skills:

Skill Name Description Cooldown Energy Cost
Lightning AoE Lightning AoE Launches a lightning based ability that does area-of-effect damage at target location. 10s -
Usage Logic
  1. There are 1 or more enemy units or structures nearby
  2. The enemy unit is not an Observer or Overseer
  3. Highest Vitality Score from 1-4 with damage value 30
    ↪SUGGEST Trigger Lightning AoE

Hybrid Units

Hybrid Destroyer

Hybrid
Destroyer

0 Energy

Skills:

Skill Name Description Cooldown Energy Cost
Graviton Prison Graviton Prison Makes the target unit float in the air, disabling its abilities. 0s -
Usage Logic
  1. Enemy unit in range
    ↪Trigger Graviton Prison
Hybrid Reaver

Hybrid
Reaver

0 Energy

Skills:

Skill Name Description Cooldown Energy Cost
Consume DNA Consume DNA Absorbs the target unit's life essence. 10s -
Usage Logic
  1. Enemy unit has 75 vitality or more
    ↪Trigger Consume DNA.
Hybrid Behemoth

Hybrid
Behemoth

0 Energy

Skills:

Skill Name Description Cooldown Energy Cost
Constricting Slime Constricting Slime Sprays slime on nearby enemies, slowing them for 5 seconds. 15s -
Usage Logic
  1. There are 6 or more enemy units within 6 range
    ↪Trigger Constricting Slime.
Consume DNA Consume DNA Absorbs the target unit's life essence. 10s -
Usage Logic
  1. Enemy unit has 75 vitality or more
    ↪Trigger Consume DNA.
Hybrid Dominator

Hybrid
Dominator

200 Energy

Skills:

Skill Name Description Cooldown Energy Cost
Plasma Blast Plasma Blast Shoots a ball of bio-plasma toward a target, causing 260 damage. 10s 25
Usage Logic
  1. Enemy unit or structure has 130 vitality or more
    ↪Trigger Plasma Blast
Psionic Storm Psionic Storm Creates a storm of psionic energy that lasts 4 seconds, causing up to 80 damage to all enemy units in the target area. Does not damage friendly units. 8s 25
Usage Logic
  1. There are 1 or more enemy units in the area
  2. Vitality Score of 3.0 with damage value 40
    ↪Trigger Psionic Storm

Mutator Units

Note: Amon Karax is not listed as he uses his abilities as soon as they come off cooldown.

Artanis

Artanis

0 Energy

Skills:

Skill Name Description Cooldown Energy Cost
Astral Wind Astral Wind Heals Artanis and all nearby friendly units for 300 life and 200 shields. 15s -
Usage Logic
  1. Artanis has lost more than 150 shields
    ↪Trigger Astral Wind
Lightning Dash Lightning Dash Artanis charges forward, unleashing a blast of energy that deals 100 damage to nearby enemies and stuns them for 2 seconds. 5s -
Usage Logic
  1. There are 3 or more enemy units in the area
  2. Vitality Score of 2.0 with damage value 100
    ↪Trigger Lightning Dash
Dehaka

Dehaka

0 Energy

Skills:

Skill Name Description Cooldown Energy Cost
Mend Mend Heals Dehaka for 150, and heals nearby friendly units for 50. An additional 50% of the amount healed regenerates over 15 seconds. 10s -
Usage Logic
  1. Dehaka has lost more than 150 HP
    ↪Trigger Mend
Generate Spawns Generate Spawns Generates two Spawns of Dehaka that deal 100% normal damage but have 50% life. Spawns last 30 seconds. 45s -
Usage Logic
  1. 1 or more enemy units or structures nearby
    ↪Trigger Generate Spawns
Drag Drag Pulls the target to Dehaka's location and temporarily stuns it (5 seconds). 10s -
Usage Logic
  1. Enemy unit is visible
    ↪Trigger Drag
Kerrigan

Kerrigan

200 Energy

Skills:

Skill Name Description Cooldown Energy Cost
Apocalypse Apocalypse Deals 300 damage to enemy units and 700 damage to enemy structures in a large area. 60s -
Usage Logic
  1. There are 4 or more enemy units or structures in the area
  2. Vitality Score of 1.0 with damage value 300
    ↪Trigger Apocalypse
Leaping Strike Leaping Strike Kerrigan leaps to her target and deals 150 damage. Can be used without a target to travel quickly. 0s 50
Usage Logic
  1. 1 or more enemy units nearby
  2. Enemy unit has 150 vitality or more
  3. Enemy is within 6 range of Kerrigan
    ↪Trigger Leaping Strike
Psionic Shift Psionic Shift Kerrigan dashes through enemies, dealing 50 damage to all enemies in her path. 0s 50
Usage Logic
  1. There are 3 or more enemy units in the area
  2. Vitality Score of 2.0 with damage value 50
    ↪Trigger Psionic Shift
Nova

Nova

100 Energy

Skills:

Skill Name Description Cooldown Energy Cost
Nuke Nuke Calls down a Nuclear Strike at a target location. Nukes take 5 seconds to land, but they deal up to 600 damage to enemies in a large radius. 60s -
Usage Logic
  1. There are 4 or more enemy units or structures in the area
  2. Vitality Score of 2.0 with damage value 600
    ↪Trigger Nuke
Snipe Snipe Deals 200 damage to target enemy ground or air unit from long range. Can target biological and mechanical units. 0s 50
Usage Logic
  1. 1 or more enemy units nearby
  2. Enemy unit has 75 vitality or more
  3. Enemy is within 10 range of Nova
    ↪Trigger Snipe
Raynor

Raynor

0 Energy

Skills:

Skill Name Description Cooldown Energy Cost
Penetrator Round Penetrator Round After carefully aiming, Raynor fires a Penetrator Round that strikes enemies along its path, dealing 300 damage. 20s -
Usage Logic
  1. There are 1 or more enemy units in the area
  2. Vitality Score of 1.0 with damage value 80
    ↪Trigger Penetrator Round
Tychus

Tychus

0 Energy

Skills:

Skill Name Description Cooldown Energy Cost
Toss Shredder Grenade Toss Shredder Grenade Tosses a grenade that explodes for 200 damage in a small radius (2 range). Does not harm friendly units. 20s -
Usage Logic
  1. There are 3 or more enemy units in the area
  2. Vitality Score of 1.0 with damage value 80
    ↪Trigger Toss Shredder Grenade
Zagara

Zagara

200 Energy

Skills:

Skill Name Description Cooldown Energy Cost
Baneling Barrage Baneling Barrage Launches 4 Banelings towards the target point. Each Baneling explodes for 40 damage (80 vs structures). 10s 50
Usage Logic
  • If there are enemy units nearby:
    1. 1 or more enemy units nearby
    2. The enemy unit is within 10 range of Zagara
      ↪Trigger Baneling Barrage
  • If there are no enemy units nearby:
    1. 1 or more enemy structures nearby
    2. The enemy unit is within 10 range of Zagara
      ↪Trigger Baneling Barrage
Spawn Hunter Killers Spawn Hunter Killers Spawns 4 Hunter Killers at the target point that last 20 seconds. 30s 60
Usage Logic
  1. 1 or more enemy units or structures nearby
    ↪Trigger Spawn Hunter Killers
Infested Drop Infested Drop Calls down 10 drop-pods onto the target area, dealing 50 damage with each drop-pod and spawning a total of 10 Roaches that last 30 seconds. 60s -
Usage Logic
  1. There are 2 or more enemy units or structures in the area
  2. Vitality Score of 3.0 with damage value 500
    ↪Trigger Infested Drop
Mass Frenzy Mass Frenzy Grants all friendly units on the map 25% attack speed and 25% movement speed for 15 seconds. 120s 25
Usage Logic
  1. 1 or more enemy units or structures nearby
  2. There are 5 or more ally units within 15 range of Zagara
  3. Vitality Score of 3.0 with damage value 500
    ↪Trigger Frenzy
Zeratul

Zeratul

0 Energy

Skills:

Skill Name Description Cooldown Energy Cost
Void Armor Void Armor Grants nearby friendly units +100 shields for 10 seconds. 20s -
Usage Logic
  1. 1 or more enemy units nearby
    ↪SUGGEST Trigger Void Armor
Blink Blink Teleports Zeratul to a nearby location. 3s -
Usage Logic
  1. 1 or more enemy units nearby
  2. Enemy unit is within 8 range of Zeratul
    ↪SUGGEST Trigger Blink towards enemy unit
Shadow Blade Shadow Blade Slashes an enemy unit for 500 damage. Can only target ground units. 6s -
Usage Logic
  1. 1 or more enemy units nearby
  2. Enemy unit is within 1 range of Zeratul
    ↪SUGGEST Trigger Shadow Blade