Skip to content

Threat Registry

A per-creature, per-attacker threat-score accumulator. The foundation for the boss-encounter mechanics — tanks, off-tanks, threat modifiers, taunts. It's purely additive: vanilla trash mobs are unaware of it and still pick the nearest target. Bosses that opt in consult the table on every AI tick and chase the player with the highest accumulated threat instead.

How to use it

There is no player-facing command. The system is invisible from outside the encounter — what you see is a boss that doesn't just instantly switch to whoever last hit it. If you're tanking, the boss stays on you while your party DPS pumps damage into its back. If you're a healer dropping heals at range, your healing reads as threat too (depending on the boss tuning).

The encounter designer marks a creature as threat-aware. Once a creature is threat-aware:

  • Every point of damage from a player to the creature adds threat equal to the damage amount.
  • The creature's AI consults the table on every target-reacquire tick and prefers the highest-threat valid target (alive, same map, within perception range) over the nearest-target heuristic.
  • If no attacker beats the minimum threshold, the creature falls back to standard targeting.

Behaviour notes

  • In-memory only. The table lives in memory and resets on server reboot. This is deliberate — combat ends, the registry forgets you exist.
  • Idle eviction. If a creature's table hasn't been touched for 5 minutes, the whole entry drops. A sweep runs roughly once a minute.
  • Disconnect sweep. When a player disconnects, every mob's table loses that player's row.
  • Death cleanup. When the creature dies, its whole table drops immediately.