BK's Spawners Cooldown

BK'S SPAWNER COOLDOWNS AND CONFIGURATION
Minecraft 1.20.1  |  Forge 47+

Replaces the behaviour of every mob spawner in the world.

--------------------------------------------------------------------------
SPAWNER BEHAVIOUR
--------------------------------------------------------------------------

- A spawner keeps one mob alive at a time. It records the mob it spawned and
  spawns nothing further while that mob is alive.

- A spawner spawns when a player comes within 32 blocks. Vanilla uses 16.

- Light level is not checked. A spawner works in a fully lit room.

- When the tied mob is killed, the spawner waits 5 minutes before spawning
  again.(fully configurable,in world config and can be set to 10 minutes)

- When the tied mob has been alive for 5 minutes, it is removed and a new one
  spawns immediately. This happens on schedule, including while a player is
  fighting it. A config option delays it until no player is within 32 blocks.

- When no player is within 128 blocks, the tied mob is removed and the spawner
  is rearmed, so returning to the area produces a new mob.

- When a player dies, every spawner within 64 blocks of the death point is
  reset unless there is another player in the proximity.

- Spawned mobs are marked persistent and do not despawn on their own.

- Spawners cannot be broken. Creative-mode players can break them by default.

--------------------------------------------------------------------------
ON-BLOCK DISPLAY
--------------------------------------------------------------------------

- A countdown is drawn above the spawner, showing time until its next action.
  Format is selectable: MM:SS, seconds, or ticks.

- The countdown is coloured by state: cooling down, armed, or mob active.

- A progress bar under the countdown fills as the timer runs out.

- Spawner particles change with state: sparse smoke while on cooldown, flame
  once armed.

- Every display element can be disabled individually, along with colours,
  scale, height, view distance, and whether the display shows through walls.

--------------------------------------------------------------------------
CONFIGURATION
--------------------------------------------------------------------------

Two files:

  <world>/serverconfig/bk_spawners-server.toml
      Gameplay rules. Sent to clients on join.

  config/bk_spawners-client.toml
      Display settings. Client-side only.

Configurable values include: cycle length, death cooldown, cooldown jitter,
retry delay, check interval, activation radius, reset radius, spawn radius,
spawn attempts, mobs per spawner, tether radius, player-death reset radius and
guard radius, whether mob spawn rules and light level are respected, spawning on
Peaceful, mob persistence, spawn effects, spawning on the block when blocked,
indestructibility, creative bypass, explosion immunity, and mob griefing
immunity.

Any gameplay value can be overridden for a single dimension or a single mob:

  [overrides]
    dimensionOverrides = ["minecraft:the_nether | cycleTicks=3000 | activationRange=24"]
    entityOverrides    = ["minecraft:blaze | spawnCount=2 | tetherRange=24",
                          "minecraft:wither_skeleton | deathCooldownTicks=12000"]

A mob override takes precedence over a dimension override for the same value.

Dimensions and mobs can be listed as a blacklist or a whitelist. Excluded
spawners keep vanilla behaviour entirely, including being breakable.

--------------------------------------------------------------------------