Combat Abilities

Combat abilities are offensive boss behaviors that deal damage, control positioning, or apply debuffs to players. Each ability is configured as a behavior entry in the entity JSON with a code and attributes object.

Common Properties

These properties are shared by most boss abilities and can be included in any stage configuration:

bossdash

EntityBehaviorBossDash — Boss performs a quick dash towards or away from the target.

Stages array: stages

{
  "code": "bossdash",
  "attributes": {
    "stages": [
      {
"whenHealthRelBelow": 1.0,
"cooldownSeconds": 8,
"minTargetRange": 5,
"maxTargetRange": 25,
"windupMs": 400,
"dashMs": 500,
"dashSpeed": 0.22,
"dashDirection": "towards",
"sound": "game:entity/drifter-idle"
      }
    ]
  }
}

bossteleport

EntityBehaviorBossTeleport — Boss teleports to a random position around the target.

Stages array: stages

{
  "code": "bossteleport",
  "attributes": {
    "stages": [
      {
"whenHealthRelBelow": 0.5,
"cooldownSeconds": 12,
"minRadius": 4,
"maxRadius": 8,
"windupMs": 300,
"requireSolidGround": true,
"teleportClones": true
      }
    ]
  }
}

bossgrab

EntityBehaviorBossGrab — Boss grabs a player and holds them, dealing periodic damage.

{
  "code": "bossgrab",
  "attributes": {
    "whenHealthRelBelow": 0.8,
    "cooldownSeconds": 15,
    "windupMs": 600,
    "grabMs": 4000,
    "victimWalkSpeedMult": 0.05,
    "damageIntervalMs": 400,
    "damage": 4,
    "damageTier": 1
  }
}

bosshook

EntityBehaviorBossHook — Boss pulls a target towards itself (like a hook/whip).

{
  "code": "bosshook",
  "attributes": {
    "whenHealthRelBelow": 1.0,
    "cooldownSeconds": 10,
    "minTargetRange": 8,
    "maxTargetRange": 25,
    "windupMs": 500,
    "pullSpeed": 1.0,
    "hookAnimation": "hook"
  }
}

bosslifedrainnova

EntityBehaviorBossLifeDrainNova — Boss creates a nova that drains health from nearby players and heals itself.

{
  "code": "bosslifedrainnova",
  "attributes": {
    "whenHealthRelBelow": 0.6,
    "cooldownSeconds": 20,
    "radius": 10,
    "durationMs": 6000,
    "drainDamage": 4,
    "healMultiplier": 0.75
  }
}

bossparasiteleech

EntityBehaviorBossParasiteLeech — Boss attaches parasites to players that drain health over time.

{
  "code": "bossparasiteleech",
  "attributes": {
    "whenHealthRelBelow": 0.7,
    "cooldownSeconds": 18,
    "maxParasites": 4,
    "parasiteDurationMs": 10000,
    "damagePerParasite": 2
  }
}

bosspushback

EntityBehaviorBossPushback — Boss creates a shockwave that pushes players away.

{
  "code": "bosspushback",
  "attributes": {
    "whenHealthRelBelow": 1.0,
    "cooldownSeconds": 8,
    "radius": 12,
    "force": 10,
    "windupMs": 400
  }
}

bossrandomlightning

EntityBehaviorBossRandomLightning — Boss summons lightning strikes on random nearby positions.

{
  "code": "bossrandomlightning",
  "attributes": {
    "whenHealthRelBelow": 0.5,
    "cooldownSeconds": 15,
    "radius": 20,
    "strikeCount": 5,
    "strikeIntervalMs": 400,
    "damage": 12
  }
}

bossrepulsestun

EntityBehaviorBossRepulseStun — Boss stuns and repulses nearby players.

{
  "code": "bossrepulsestun",
  "attributes": {
    "whenHealthRelBelow": 0.4,
    "cooldownSeconds": 20,
    "radius": 14,
    "stunDurationMs": 3000,
    "pushForce": 12,
    "windupMs": 700
  }
}

bossstillnessmark

EntityBehaviorBossStillnessMark — Boss marks a player; if they move, they take damage.

{
  "code": "bossstillnessmark",
  "attributes": {
    "whenHealthRelBelow": 0.6,
    "cooldownSeconds": 25,
    "markDurationMs": 5000,
    "damageIfMoved": 20,
    "radius": 25
  }
}

bosssurroundedresponse

EntityBehaviorBossSurroundedResponse — Boss triggers an ability when surrounded by multiple players.

{
  "code": "bosssurroundedresponse",
  "attributes": {
    "whenHealthRelBelow": 1.0,
    "cooldownSeconds": 10,
    "surroundRadius": 8,
    "minPlayers": 2,
    "responseType": "pushback"
  }
}

bosstrapclone

EntityBehaviorBossTrapClone — Boss creates fake clones that explode when attacked.

{
  "code": "bosstrapclone",
  "attributes": {
    "whenHealthRelBelow": 0.5,
    "cooldownSeconds": 30,
    "cloneCount": 4,
    "cloneDurationMs": 12000,
    "explosionDamage": 15,
    "explosionRadius": 6
  }
}

bosswoundedmark

EntityBehaviorBossWoundedMark — Boss marks players who deal high damage, making them take extra damage.

{
  "code": "bosswoundedmark",
  "attributes": {
    "whenHealthRelBelow": 1.0,
    "cooldownSeconds": 15,
    "damageThreshold": 40,
    "markDurationMs": 10000,
    "extraDamagePercent": 50
  }
}

bossfaketeleport

EntityBehaviorBossFakeTeleport — Boss creates a fake teleport illusion while actually staying in place.

{
  "code": "bossfaketeleport",
  "attributes": {
    "whenHealthRelBelow": 0.7,
    "cooldownSeconds": 20,
    "illusionDurationMs": 4000,
    "windupMs": 500
  }
}

explodeondeath

EntityBehaviorExplodeOnDeath — Boss explodes upon death after a fuse delay.

{
  "code": "explodeondeath",
  "attributes": {
    "fuseMs": 3000,
    "explosionRadius": 5,
    "explosionDamage": 20,
    "damageTier": 2,
    "explodeSound": "effect/largeexplosion",
    "explodeSoundVolume": 0.8
  }
}

bossashfloor

EntityBehaviorBossAshFloor — Boss creates a damaging ash floor area.

{
  "code": "bossashfloor",
  "attributes": {
    "whenHealthRelBelow": 0.5,
    "cooldownSeconds": 20,
    "radius": 12,
    "durationMs": 8000,
    "damageIntervalMs": 400,
    "damage": 3
  }
}

bosscorpseexplosion

EntityBehaviorBossCorpseExplosion — Boss's corpse explodes after death, damaging and poisoning nearby players.

{
  "code": "bosscorpseexplosion",
  "attributes": {
    "fuseMs": 3000,
    "explosionRadius": 5,
    "explosionDamage": 15,
    "damage": 20,
    "radius": 6,
    "poisonPerSecond": 10,
    "poisonDurationSeconds": 8,
    "explodeSound": "effect/largeexplosion"
  }
}

bossrequiemchains

EntityBehaviorBossRequiemChains — Boss binds random nearby players with chains, pulling them towards the boss.

{
  "code": "bossrequiemchains",
  "attributes": {
    "whenHealthRelBelow": 0.5,
    "cooldownSeconds": 15,
    "range": 12,
    "maxTargets": 3,
    "duration": 6,
    "pullSpeed": 0.1,
    "damagePerSecond": 8
  }
}

bossmindcontrol

EntityBehaviorBossMindControl — Boss takes control of a random nearby player.

{
  "code": "bossmindcontrol",
  "attributes": {
    "whenHealthRelBelow": 0.4,
    "cooldownSeconds": 30,
    "controlDurationSeconds": 7,
    "controlRange": 25,
    "victimMoveSpeed": 0.06,
    "attackDamage": 15,
    "attackDamageTier": 2,
    "controlSound": "albase:dark-magic-charge-up"
  }
}

bosscursemark

EntityBehaviorBossCurseMark — Boss marks a player. After a delay, the mark detonates dealing damage based on distance — closer to boss = more damage.

{
  "code": "bosscursemark",
  "attributes": {
    "whenHealthRelBelow": 0.6,
    "cooldownSeconds": 18,
    "maxTargetRange": 25,
    "markDelaySec": 4,
    "baseDamage": 20,
    "safeDistance": 12,
    "damageTier": 3
  }
}

bosscursestack

EntityBehaviorBossCurseStack — Reactive ability. Each time the boss deals damage to a player, it applies a curse stack. At max stacks, triggers an effect (stun, teleport, or slow). Stacks decay after a timeout.

{
  "code": "bosscursestack",
  "attributes": {
    "whenHealthRelBelow": 0.7,
    "maxStacks": 4,
    "effectType": "stun",
    "stackDecaySeconds": 5,
    "stunDurationMs": 3000
  }
}

bossexecute

EntityBehaviorBossExecute — Boss scans for low-HP players. If a player is below a threshold, the boss charges up (with sound + particles) then teleports to the player and deals massive damage. Cancelled if the player heals above threshold during charge.

{
  "code": "bossexecute",
  "attributes": {
    "whenHealthRelBelow": 0.5,
    "cooldownSeconds": 25,
    "maxTargetRange": 25,
    "executeThreshold": 0.25,
    "executeDamage": 50,
    "windupMs": 2500,
    "damageTier": 4
  }
}

bossgravity

EntityBehaviorBossGravity — Creates a gravity sphere at a target position that pulls players toward its center. Players reaching the center take damage + brief stun.

{
  "code": "bossgravity",
  "attributes": {
    "whenHealthRelBelow": 0.6,
    "cooldownSeconds": 20,
    "maxTargetRange": 25,
    "pullRadius": 10,
    "pullDurationSec": 6,
    "pullStrength": 0.15,
    "centerDamage": 20
  }
}

bossgroundslam

EntityBehaviorBossGroundSlam — Telegraphs with particles, then after windup deals AoE damage + knockback in a radius.

{
  "code": "bossgroundslam",
  "attributes": {
    "whenHealthRelBelow": 0.5,
    "cooldownSeconds": 12,
    "maxTargetRange": 20,
    "radius": 6,
    "damage": 15,
    "windupMs": 1500,
    "knockbackStrength": 2.0
  }
}

bossprojectile

EntityBehaviorBossProjectile — Fires particle-based projectiles toward players. Supports multiple shapes and variants.

{
  "code": "bossprojectile",
  "attributes": {
    "whenHealthRelBelow": 0.7,
    "cooldownSeconds": 8,
    "maxTargetRange": 25,
    "damage": 12,
    "speed": 14,
    "variant": "shadow",
    "shape": "homing",
    "damageTier": 3,
    "homingTurnDegPerSec": 25,
    "windupMs": 500,
    "windupSound": "albase:dark-magic-charge-up"
  }
}

bosssoulchain

EntityBehaviorBossSoulChain — Tethers the nearest player with a chain. While chained: player is slowed. Break by distance, damage dealt to boss, or timeout.

{
  "code": "bosssoulchain",
  "attributes": {
    "whenHealthRelBelow": 0.6,
    "cooldownSeconds": 20,
    "maxTargetRange": 25,
    "chainDurationSec": 6,
    "slowFactor": 0.5,
    "breakDistance": 14,
    "breakDamage": 25
  }
}

bosstrail

EntityBehaviorBossTrail — Leaves a damaging particle trail behind the boss as it moves. Trail segments persist and deal damage to players who walk through them.

{
  "code": "bosstrail",
  "attributes": {
    "whenHealthRelBelow": 0.5,
    "trailDps": 6,
    "trailRadius": 2,
    "lifetimeSec": 7,
    "trailIntervalMs": 250,
    "maxSegments": 25,
    "trailColor": "shadow"
  }
}

bossvoidzone

EntityBehaviorBossVoidZone — Places an expanding damage zone at target position. Grows from 0 to maxRadius over growDurationSec.

{
  "code": "bossvoidzone",
  "attributes": {
    "whenHealthRelBelow": 0.5,
    "cooldownSeconds": 15,
    "maxTargetRange": 25,
    "maxRadius": 8,
    "growDurationSec": 4,
    "dpsInZone": 5,
    "lifetimeSec": 10,
    "maxActiveZones": 2
  }
}

bosshazardzone

EntityBehaviorBossHazardZone — Universal hazard zone ability with multiple zone types. Zones are placed at target position, grow over time, and apply effects + DoT.

{
  "code": "bosshazardzone",
  "attributes": {
    "whenHealthRelBelow": 0.6,
    "cooldownSeconds": 18,
    "maxTargetRange": 25,
    "zoneType": "ember",
    "radius": 5,
    "lifetimeSec": 10,
    "dpsInZone": 6,
    "dotDps": 3,
    "maxActiveZones": 2
  }
}