Utility Abilities

Utility abilities handle phase transitions, summoning, respawning, UI elements, and atmospheric effects for bosses. 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:

bossrebirth2

EntityBehaviorBossRebirth2 — Boss transforms into another entity upon death.

{
  "code": "bossrebirth2",
  "attributes": {
    "nextEntityCode": "boss_phase2",
    "isFinalStage": false,
    "spawnDelayMs": 3000,
    "spawnLightning": true,
    "sound": "game:entity/bell-idle"
  }
}

bossformswap

EntityBehaviorBossFormSwap — Boss swaps into a different entity form.

{
  "code": "bossformswap",
  "attributes": {
    "whenHealthRelBelow": 0.5,
    "alternateEntityCode": "boss_enraged",
    "swapChance": 1.0,
    "keepHealthFraction": true
  }
}

bossformswaplist

EntityBehaviorBossFormSwapList — Boss swaps into one of several predefined forms from stages.

{
  "code": "bossformswaplist",
  "attributes": {
    "stages": [
      { "whenHealthRelBelow": 0.7, "entityCode": "boss_form_fire", "keepHealthFraction": true },
      { "whenHealthRelBelow": 0.4, "entityCode": "boss_form_ice", "keepHealthFraction": true }
    ]
  }
}

bossintermissiondispel

EntityBehaviorBossIntermissionDispel — Boss enters an intermission phase: takes reduced damage, freezes, and spawns adds and dispel objects.

{
  "code": "bossintermissiondispel",
  "attributes": {
    "whenHealthRelBelow": 0.5,
    "intermissionMaxMs": 15000,
    "freezeBoss": true,
    "incomingDamageMultiplier": 0,
    "dispelEntityCode": "dispel_crystal",
    "dispelCount": 3,
    "adds": [
      { "entityCode": "game:drifter-normal", "count": 4 }
    ]
  }
}

bossplayerclone

EntityBehaviorBossPlayerClone — Boss creates clones of nearby players.

{
  "code": "bossplayerclone",
  "attributes": {
    "whenHealthRelBelow": 0.4,
    "cloneEntityCode": "player_clone",
    "cloneRange": 25
  }
}

bossrespawn

EntityBehaviorBossRespawn — Boss corpse remains and respawns into a new entity after a set time.

{
  "code": "bossrespawn",
  "attributes": {
    "respawnInGameHours": 48,
    "spawnNewBoss": true,
    "respawnEntityCode": "boss_revived"
  }
}

bossmodelswap

EntityBehaviorBossModelSwap — Boss temporarily changes its visual model. Uses stages with a forms array.

Forms item properties:

{
  "code": "bossmodelswap",
  "attributes": {
    "stages": [
      {
"whenHealthRelBelow": 0.6,
"cooldownSeconds": 30,
"swapSound": "albase:dark-magic-charge-up",
"forms": [
  { "shape": "entity/boss_shadow", "texture": "entity/boss_shadow", "durationMs": 12000 },
  { "shape": "entity/boss_flame", "texture": "entity/boss_flame", "durationMs": 10000 }
]
      }
    ]
  }
}

bosssummonritual

EntityBehaviorBossSummonRitual — Boss performs a ritual to summon minions.

Spawns item properties: entityCode, minCount, maxCount, chance, spawnDelayMs

{
  "code": "bosssummonritual",
  "attributes": {
    "stages": [
      {
"whenHealthRelBelow": 0.7,
"cooldownSeconds": 30,
"ritualMs": 5000,
"spawnRange": 8,
"maxNearby": 6,
"nearbyRange": 20,
"spawns": [
  { "entityCode": "game:drifter-normal", "minCount": 2, "maxCount": 4 },
  { "entityCode": "game:drifter-bow", "minCount": 1, "maxCount": 2 }
],
"sound": "game:effect/intromusic"
      }
    ]
  }
}

bosscloning

EntityBehaviorBossCloning — Boss creates permanent clones of itself.

{
  "code": "bosscloning",
  "attributes": {
    "whenHealthRelBelow": 0.6,
    "cloneCount": 3,
    "spawnRange": 10,
    "cloneDamageMult": 0.5,
    "cloneWalkSpeedMult": 1.2,
    "cloneFollowOwner": true
  }
}

bossperiodicspawn

EntityBehaviorBossPeriodicSpawn — Boss periodically spawns entities at intervals.

{
  "code": "bossperiodicspawn",
  "attributes": {
    "whenHealthRelBelow": 1.0,
    "entityCode": "game:drifter-normal",
    "minCount": 1,
    "maxCount": 3,
    "chance": 0.8,
    "maxNearby": 8,
    "spawnRange": 10,
    "requireHasTarget": true
  }
}

bossanticheese

EntityBehaviorBossAntiCheese — Prevents players from cheesing the boss by teleporting to them when they exploit terrain or distance.

{
  "code": "bossanticheese",
  "attributes": {
    "whenHealthRelBelow": 1.0,
    "cooldownSeconds": 10,
    "searchRange": 50,
    "farRange": 20,
    "farSeconds": 3.0,
    "noLosSeconds": 2.5,
    "minRadius": 2,
    "maxRadius": 5
  }
}

bosshastargetsync

EntityBehaviorBossHasTargetSync — Syncs the "has target" state to clients for visual effects. No configurable properties.

{
  "code": "bosshastargetsync"
}

bosshealthbaroverride

EntityBehaviorBossHealthbarOverride — Overrides the boss healthbar display.

{
  "code": "bosshealthbaroverride",
  "attributes": {
    "showHealthbar": true,
    "displayName": "Ancient Guardian"
  }
}

bosshuntcombatmarker

EntityBehaviorBossHuntCombatMarker — Marks boss as part of the Boss Hunt system. Tracks attackers and damage. No configurable properties.

{
  "code": "bosshuntcombatmarker"
}

bossmusiccontroller

EntityBehaviorBossMusicController — Plays custom music during boss fight.

{
  "code": "bossmusiccontroller",
  "attributes": {
    "musicTrack": "music/boss_battle",
    "fadeOutMs": 3000
  }
}

bossmusicurlcontroller

EntityBehaviorBossMusicUrlController — Plays music from URL during boss fight.

{
  "code": "bossmusicurlcontroller",
  "attributes": {
    "musicUrl": "https://example.com/boss_music.ogg",
    "volume": 0.8
  }
}

bossnametag

EntityBehaviorBossNameTag — Customizes boss nametag display.

{
  "code": "bossnametag",
  "attributes": {
    "displayName": "Dread Lord",
    "showHealth": true,
    "color": "#8B0000"
  }
}

bossbloodprice

EntityBehaviorBossBloodPrice — Reactive ability. When the boss deals damage, it heals for a percentage of damage dealt. After healing past a threshold, triggers a vulnerability window.

{
  "code": "bossbloodprice",
  "attributes": {
    "whenHealthRelBelow": 0.6,
    "cooldownSeconds": 15,
    "maxTargetRange": 25,
    "healPercent": 0.4,
    "healThreshold": 8
  }
}

bossenrage

EntityBehaviorBossEnrage — After a configurable timer from first damage, boss gains +50% damage and +50% move speed permanently until death/soft reset. Warning pulse at 10 seconds before enrage.

{
  "code": "bossenrage",
  "attributes": {
    "enrageTimerSeconds": 180
  }
}

bossghostflight

EntityBehaviorBossGhostFlight — Entity floats above ground and periodically becomes invisible. While invisible: moves faster, doesn't attack. Reappears behind the player for a surprise attack.

{
  "code": "bossghostflight",
  "attributes": {
    "hoverHeight": 2.0,
    "invisDurationSec": 4,
    "invisCooldownSec": 15,
    "reappearBehindDistance": 4
  }
}

bossmirrorimage

EntityBehaviorBossMirrorImage — Boss creates illusion entities and teleports. Illusions have 1 HP and auto-despawn after lifetime.

{
  "code": "bossmirrorimage",
  "attributes": {
    "whenHealthRelBelow": 0.5,
    "cooldownSeconds": 30,
    "maxTargetRange": 25,
    "imageCount": 3,
    "imageLifetimeSec": 8,
    "teleportOnCast": true,
    "teleportRadius": 8
  }
}

bossmovementstyle

EntityBehaviorBossMovementStyle — Souls-like movement patterns. Bosses strafe, dash, retreat, and pause instead of just walking straight at the player.

{
  "code": "bossmovementstyle",
  "attributes": {
    "style": "assassin",
    "strafeSpeed": 0.04,
    "dashSpeed": 0.15,
    "engageDistance": 3
  }
}

bossphaseshift

EntityBehaviorBossPhaseShift — Boss teleports to a random position within shiftRadius. Visual: dissolve particles at old position, reappear particles at new position.

{
  "code": "bossphaseshift",
  "attributes": {
    "whenHealthRelBelow": 0.5,
    "cooldownSeconds": 12,
    "maxTargetRange": 25,
    "shiftRadius": 10,
    "durationMs": 2000
  }
}

bossshieldphase

EntityBehaviorBossShieldPhase — At configured HP threshold, boss becomes invulnerable and spawns mobs. Kill all mobs to break the shield. Boss doesn't attack during shield phase. Max duration failsafe.

{
  "code": "bossshieldphase",
  "attributes": {
    "shieldHealthThreshold": 0.5,
    "mobCode": "game:drifter-deep",
    "mobCount": 6,
    "spawnRadius": 6,
    "maxShieldDurationSec": 90
  }
}

bosssplit

EntityBehaviorBossSplit — At configured HP threshold, boss despawns and spawns 2 mini-copies. Each copy has 25% of original max HP. Both must be killed.

{
  "code": "bosssplit",
  "attributes": {
    "splitHealthThreshold": 0.4
  }
}

bosstelegraph

EntityBehaviorBossTelegraph — Displays a particle zone on the ground before a powerful attack. The attack is delayed by windup time, giving players time to dodge. Supports circle, line, and cone shapes.

{
  "code": "bosstelegraph",
  "attributes": {
    "windupMs": 1500,
    "shape": "circle",
    "radius": 6
  }
}