Reactor: enemy spawns

A station on the rim of a vast industrial pit — descend the gantries through deepening gas, restart the auxiliary generators or mask up, and bring the dormant reactor back to life.

Level id
reactor
Difficulty tier
3 — Explicit difficulty tier of the level (0 = the starting level). Metadata only: no automatic scaling of counts, damage or loot, and no enemy family is enabled by it. LEVELS.reactor.tier in game/src/levels/registry.ts:163 (repository access required)
Spawn profile
Reactor — REACTOR_SPAWN_PROFILE in game/src/ai/spawnTables.ts:687 (repository access required)
Spawns tried per level
39–54 (E = 46.5), over 5 generation contexts
Room modifiers
All 28 room keys resolve to 1× for every family (neutral); the profile sets no room modifiers

Generation contexts

A generation context is one run of the enemy placement code. Each run draws one count, uniformly from its range, and tries to place that many spawns. The contexts below are parts of the one Reactor level and are generated with it; they are not separate levels. A context that runs more than once per level (for example once per storey) draws a new count each run.

Reactor: spawns each context tries to place (count per run, uniform; per level = runs × count)
ContextStoreys one run coversRuns per levelCount per runE[count] per runPer levelE per level
Rim (station, rim gallery, rim office)stationthe rim storey (level 0: the station platform, the rim gallery, the rim control office)12–4U{2..4}32–43
Upper walkway tier (zone 1; each of tiers 1-2)floorone UPPER walkway tier (each of tiers 1-2: galleries, landings, bridges, side rooms)26–8U{6..8}712–1614
Deep walkway tier (zone 2; each of tiers 3-4)ringone DEEP walkway tier (each of tiers 3-4: galleries, landings, bridges, side rooms incl. the switchgear room)28–11U{8..11}9.516–2219
Core floor (vessel ring, pump hall, control room)pitthe core floor (round the vessel, the pump hall, the control room)19–12U{9..12}10.59–1210.5
Service annex (per annex)serviceone seeded service annex off a rim-station track tunnel (its rooms and corridors only)0–1one per zone (seeded)5–6U{5..6}5.50–6zone budget, not in the total5.5per zone
Whole levelall core contexts (zones reported separately)39–5446.5

Spawns the level's context runs try to place (Σ runs × count). The family roll replaces, never adds; placed totals can fall short where eligible, spaced cells run out. Not included: the zone context 'service' (a per-zone budget of 5-6 per zone, 0-6 per level), reported separately.

Service annex (per annex): A PER-ANNEX ZONE BUDGET: one run per seeded service annex (0 to TRACK_EXT.annex.max per level, a generation census quantity — see docs/enemy-spawns.md "Service annexes"), on the annex's own fork, appended after every core spawn and tagged 'service'. It is additive to the core contexts and NOT in the whole-level total above; the level's zombie types apply; its spawns draw from the annexes' OWN family pool (SERVICE_FAMILY_POOL: a configured 20 % rat/dog selection share, Blightbelly 5 %, Strainer 8 % (the only pool that enables it: STRAINER_CONTEXTS), no Siren — per-spawn probabilities, not quotas). The seeded roster pass then runs on the finished level (see the seeded roster): it fixes the level's Strainers at EXACTLY ONE on the maps whose seed rolled the Strainer present, and at none on the others, and it decides per level whether Blightbellies and rat/dogs are there at all (the slot rules of the roster-only Screacher and BB list the core contexts, not the annex). The sampled census shows the outcome with the pass applied. Killed annex enemies stay dead for the run (per-index memory).

Upper walkway tier (zone 1; each of tiers 1-2): its own family pool (configured selection share per spawn) — zombie 84 % · blightbelly 4 % · siren 0 % · ratdog 12 % · strainer 0 % · screacher 0 % · bb 0 %. This context's OWN pool: its spawns draw their family from it (the same single roll per spawn, room modifiers and eligibility on top) instead of the level pool. The shares are CONFIGURED selection probabilities per spawn, not quotas: a 5-6-enemy annex may hold none or several; the sampled census shows the placed outcome.

Deep walkway tier (zone 2; each of tiers 3-4): its own family pool (configured selection share per spawn) — zombie 41 % · blightbelly 14 % · siren 35 % · ratdog 10 % · strainer 0 % · screacher 0 % · bb 0 %. This context's OWN pool: its spawns draw their family from it (the same single roll per spawn, room modifiers and eligibility on top) instead of the level pool. The shares are CONFIGURED selection probabilities per spawn, not quotas: a 5-6-enemy annex may hold none or several; the sampled census shows the placed outcome.

Core floor (vessel ring, pump hall, control room): its own family pool (configured selection share per spawn) — zombie 41 % · blightbelly 16 % · siren 35 % · ratdog 8 % · strainer 0 % · screacher 0 % · bb 0 %. This context's OWN pool: its spawns draw their family from it (the same single roll per spawn, room modifiers and eligibility on top) instead of the level pool. The shares are CONFIGURED selection probabilities per spawn, not quotas: a 5-6-enemy annex may hold none or several; the sampled census shows the placed outcome.

Service annex (per annex): its own family pool (configured selection share per spawn) — zombie 67 % · blightbelly 5 % · siren 0 % · ratdog 20 % · strainer 8 % · screacher 0 % · bb 0 %. This context's OWN pool: its spawns draw their family from it (the same single roll per spawn, room modifiers and eligibility on top) instead of the level pool. The shares are CONFIGURED selection probabilities per spawn, not quotas: a 5-6-enemy annex may hold none or several; the sampled census shows the placed outcome.

These are targets: the generator can place fewer when it runs out of eligible, spaced floor (see placement rules). The game has no per-area or per-square-metre spawn rate; the count is spread over the eligible areas of the context.

Generator: generateReactorLevel in game/src/gen/reactor/index.ts:88 (repository access required). ONE continuous level (LevelId 'reactor', tier 3): a rim subway station at the TOP of a vertical industrial pit, walkway tiers going down and the core floor round the dormant reactor vessel, generated once per level seed: placeOfficeEnemies runs the station context once (the rim storey), the floor context once per UPPER walkway tier, the ring context once per DEEP walkway tier and the pit context once (the core floor), each on its own fork (reactor-enemies-<storey>) with its OWN depth-graded family pool, and tags its spawns with the context; then (Track 2) the rim station's tunnel / service annex (at most 1) is attached and placeServiceSpawns runs the service context once per seeded service annex, appended last; assignEnemyArchetypes rolls every family ONCE at the end (the deep-tier Siren eligibility included) and applyFamilySpacing keeps the Sirens apart. Moving between tiers never rerolls anything. Last of all the level registry runs the SEEDED ROSTER pass on the finished layout (ai/enemyRoster.ts applyEnemyRoster, roster version 4): from the level seed alone it decides which special families this map holds at all, and it only ever changes the family of ordinary ambient zombie slots — never a count, a position, an index, a horde member or an outfit zombie (see the seeded roster).

Ambient budget

Ambient spawns in the whole level
at most 54 (the contexts can try at most 60)
Ambient spawns of one storey run
at most 12

Caps of the AMBIENT pool only: the whole-level total and one storey run. The contexts' count ranges stay below them by construction (validation); the horde pool has its own budget.

Defined at REACTOR_SPAWN_PROFILE.budgets in game/src/ai/spawnTables.ts:704 (repository access required).

Enemy families

Every placed spawn is one enemy family. A family's conditional share = weight / Σ weights (denominator 1) is the chance that the per-spawn roll of one placed spawn draws that family. It changes the mix, not how many spawns are placed. The seeded roster then decides whether this level holds each special family at all.

Every placed spawn draws its family independently: roll = enemyRoll(level seed, spawn index) ∈ [0, 1), walked over the pool weights of the spawn's room (the level pool when the room has no modifier), in registry order (the rat/dog keeps the top band; a family at weight 0 — the roster-only Screacher / BB — has no band). A drawn family REPLACES a zombie; it never adds to the count. Then the eligibility rule of siren: a draw where the rule fails becomes the fallback family — the other families' draws are untouched. Then the whole-level spacing of siren (with the cap, in spawn order; a too-close draw becomes the fallback). Last, the seeded roster pass (roster version 4) runs once on the finished level: a family the level's seed rolled absent has exactly none there, a present one is placed by its policy (see the seeded roster).

Reactor: family pool (per-spawn roll: shares conditional on one placed spawn; denominator 1) and the seeded roster on top
FamilyWeightConditional share (per-spawn roll)Expected per level by the per-spawn roll alone (before the roster)Seeded roster: chance the level's roll includes itPer level with the roster (sampled)
Infectedzombie0.90.9 / 1draw share; 75.6% of the placed spawns after the rule, before the roster pass sampled (takes the fallback draws of an eligibility rule)36.45 sampledalwaysthe baseline: never rolledin 20 of 20 levels · 35.8 per level sampled
Blightbellyblightbelly0.050.05 / 12.33100%of level map seeds · share top-upin 20 of 20 levels · 4.95 per level sampled
Sirensiren00 / 1level pool; its weight is in a context's own pool: Deep walkway tier (zone 2; each of tiers 3-4) 35%, Core floor (vessel ring, pump hall, control room) 35%1.45 sampled85%of level map seeds · at least one where a room qualifiesin 15 of 20 levels · 1.25 per level · 1.67 per level that holds it sampled
Tunnel scavenger (rat/dog)ratdog0.050.05 / 12.33100%of level map seeds · share top-upin 20 of 20 levels · 5.2 per level sampled
Strainerstrainer00 / 1level pool; its weight is in a context's own pool: Service annex (per annex) 8%035%of the map seeds whose map has a spawn in its contexts · exactly one, in its contextsin 1 of 20 levels · 0.05 per level · 1 per level that holds it sampled
Screacherscreacher00 / 1roster-only: no per-spawn roll draws it (placed by the seeded roster alone)040%of level map seeds · a count in place of ordinary zombiesin 5 of 20 levels · 0.45 per level · 1.8 per level that holds it sampled
BBbb00 / 1roster-only: no per-spawn roll draws it (placed by the seeded roster alone)040%of level map seeds · a count in place of ordinary zombiesin 5 of 20 levels · 0.5 per level · 2 per level that holds it sampled

Expected per level by the per-spawn roll alone = share × spawns tried per level (E = 46.5), with neutral room modifiers and before any placement shortfall; a family with an eligibility rule and its fallback family are measured instead (sampled placed per level, see family eligibility). That is the stage before the roster pass. The last two columns are the seeded roster: a level either holds a family or has none of it, so the per-level figure of a level that holds it is higher than the long-run mean. Defined at REACTOR_SPAWN_PROFILE.families in game/src/ai/spawnTables.ts:689 (repository access required).

Family eligibility

A family with an eligibility rule takes a placed slot only where its rule holds. Its draw share (weight / Σ weights) is exact; a draw where the rule fails becomes the fallback family, so the family's placed share is lower and is measured below. The other families' draws never change (the roll is the same; nothing is renormalised). The seeded roster runs after this rule and decides whether the level holds the family at all.

Siren · siren

deep-tier / core-floor side rooms only (dark alcoves off the galleries), room ≥ 4 x 4 m, clear patch, doorways ≥ 3 m away, never seals passage, ≤ 2 per level. A draw of Siren becomes Infectedzombie unless every criterion holds:

  1. the spawn's generation context is Deep walkway tier (zone 2; each of tiers 3-4) (ring) / Core floor (vessel ring, pump hall, control room) (pit); draws in any other context fall back
  2. area kind room
  3. never in (room type or purpose): washroom, stair-core
  4. the area's shorter side ≥ 8 cells (4 m)
  5. the area ≥ 100 cells (25 m²)
  6. a clear 1.5 × 1.5 m patch: every cell within 1 cell(s) is walkable floor of the same area
  7. ≥ 3 m from the centre of every doorway of its area
  8. fair passage: a 2.5 m disc around the spawn, treated as blocked, never splits the storey's walkable floor (pockets of ≤ 8 cells ignored)
  9. at most 2 per generated level (all contexts; later draws in spawn order fall back)
  10. ≥ 30 m (straight 3D line) from every earlier placed one of the level, in spawn order (applied with the cap: the cap counts only placed ones)

Whole-level spacing 30 m: two sleeping Sirens never share a stretch of the descent. REACTOR_SIREN_SPACING in game/src/ai/spawnTables.ts:683 (repository access required)

Rule defined at REACTOR_SIREN_ELIGIBILITY in game/src/ai/spawnTables.ts:675 (repository access required).

sampled Observed, not a rule. SAMPLED: 20 generated levels of LEVELS.reactor.generate (seeds 5003..155464, 20 seeds, shipped start weapon), measured BEFORE the seeded roster pass: the per-spawn roll and the eligibility rule alone. A draw is a spawn whose roll lands on the family; it is placed only where the eligibility rule holds, otherwise it becomes the fallback family. Ambient spawns only (horde members are the separate horde pool). The roster pass then decides per level whether the family is there at all — the seeded roster census of the same levels shows what a level holds. Not exhaustive; not a runtime rule.

These tables measure the per-spawn roll and the eligibility rule alone. What the same levels hold after the roster pass is in the seeded roster census.

Reactor: placed spawns per family by the per-spawn roll and the eligibility rule, before the roster pass (sampled eligibility census: 20 layouts)
FamilyPlaced over the sampleMean per levelPlaced share
Infectedzombie72936.45
Blightbellyblightbelly994.95
Sirensiren291.45
Tunnel scavenger (rat/dog)ratdog1045.2
Strainerstrainer30.15
Screacherscreacher00
BBbb00
Reactor: Siren draws vs placed, before the roster pass (sampled: 20 layouts)
Draws (roll landed on it)PlacedPlaced per level (mean)Levels with noneMost in one level
0291.454 of 202
Reactor: Siren per generated level, before the roster pass (sampled histogram)
Placed in one levelLayouts
04
13
213

Placed by context: Core floor (vessel ring, pump hall, control room) 8 · Deep walkway tier (zone 2; each of tiers 3-4) 21.

Seeded roster (which families this level holds at all)

The seeded roster pass (roster version 4) runs once on the finished Reactor layout, after every generation context, the per-spawn family roll, the eligibility rules and the hordes. One roll per family per level map seed; every storey of the level shares it. It never changes how many enemies the level has or where they stand — only which family an ordinary ambient zombie slot is.

Reactor: seeded roster — whether the level can hold each family, and the chance that a map's roll includes it
FamilyCan this level hold itChance the roll includes itOn this levelThe roll itself over level seeds 1 to 10000Sample levels with the roster (sampled)
Infectedzombiealways: the baseline, never rolledalwaysthe baseline: never rolledAlways: the baseline family, never rolled. The other families only ever take ordinary ambient zombie slots.not rolledin 20 of 20 levels · 35.8 per level sampled
Blightbellyblightbellyyes: every map of the level is rolled100%of level map seeds · share top-upThe roll includes it on every map of this level (rate 100 %): what the per-spawn roll placed stays and nothing is topped up; a map on which that roll placed none still gets one.10000 of 10000 include it100% of those seedsin 20 of 20 levels · 4.95 per level sampled
Sirensirenyes: every map of the level is rolled85%of level map seeds · at least one where a room qualifiesThe roll includes her in 85 % of this level's map seeds: such a map holds at least one when an enemy stands in a room where she is eligible (else none: "no slot"). Every other map holds none.8506 of 10000 include it85.1% of those seedsin 15 of 20 levels · 1.25 per level · 1.67 per level that holds it sampled
Tunnel scavenger (rat/dog)ratdogyes: every map of the level is rolled100%of level map seeds · share top-upThe roll includes it on every map of this level (rate 100 %): what the per-spawn roll placed stays and nothing is topped up; a map on which that roll placed none still gets one.10000 of 10000 include it100% of those seedsin 20 of 20 levels · 5.2 per level sampled
Strainerstrainerdepends on the map: only a map with a spawn in its contexts is rolled35%of the map seeds whose map has a spawn in its contexts · exactly one, in its contextsThe roll includes it in 35 % of the map seeds whose map has an ambient spawn in its context here (service): such a map holds exactly one, there. A map without such a spawn is never rolled, and every other map holds none.3553 of 10000 include it35.5% of those seedsin 1 of 20 levels · 0.05 per level · 1 per level that holds it sampled
Screacherscreacher roster-onlyyes: every map of the level is rolled40%of level map seeds · a count in place of ordinary zombiesThe roll includes it in 40 % of this level's map seeds: such a map holds its count. Every other map holds none.3932 of 10000 include it39.3% of those seedsin 5 of 20 levels · 0.45 per level · 1.8 per level that holds it sampled
BBbb roster-onlyyes: every map of the level is rolled40%of level map seeds · a count in place of ordinary zombiesThe roll includes it in 40 % of this level's map seeds: such a map holds its count. Every other map holds none.4096 of 10000 include it41% of those seedsin 5 of 20 levels · 0.5 per level · 2 per level that holds it sampled

How a family this level holds is placed

Order: Strainer, then Siren, then Screacher, then Blightbelly, then Tunnel scavenger (rat/dog), then BB — the most constrained first (BB last: added in a later roster version, it takes only slots the others left), each on the ordinary zombie slots still left.

Sampled roster census

sampled Observed, not a rule. SAMPLED: the same 20 generated levels of LEVELS.reactor.generate (seeds 5003..155464, 20 seeds, shipped start weapon), each followed by the seeded roster pass at roster version 4 — what a level holds. "Before" = what the per-spawn roll alone had placed; "after" = with the pass applied. The pass never changes the 48.2 ambient spawns per level of this sample, only their families. A SMALL sample: the long-run share of levels that hold a family is its roster rate, not this count. The roll depends on the level seed and the family only, so these seeds roll the same families present on every level. Ambient spawns only (horde members are the separate horde pool). Not exhaustive.

Reactor: the seeded roster pass on the sample levels (sampled: 20 layouts; 964 ambient spawns, 48.2 per level, before and after)
FamilyLevels that could hold itLevels whose roll included itLevels that hold itPlaced by the per-spawn roll alone (before the pass)Slots the pass took from itSlots the pass gave itWith the roster (after the pass)Mean per levelMean per level that holds itMost in one levelShare of the ambient enemiesPresent without a legal slotLevels by number held (number: levels)
Infectedzombie20202072922971635.835.8450—
Blightbellyblightbelly2020209900994.954.95900: 0 · 1: 0 · 2: 3 · 3: 2 · 4: 5 · 5: 1 · 6: 4 · 7: 3 · 8: 1 · 9: 1
Sirensiren2015152973251.251.67200: 5 · 1: 5 · 2: 10
Tunnel scavenger (rat/dog)ratdog202020104001045.25.2800: 0 · 1: 0 · 2: 1 · 3: 2 · 4: 2 · 5: 9 · 6: 2 · 7: 1 · 8: 3
Strainerstrainer51132010.051100: 19 · 1: 1
Screacherscreacher205500990.451.8300: 15 · 1: 2 · 2: 2 · 3: 1
BBbb20550010100.52300: 15 · 1: 1 · 2: 3 · 3: 1

“Slots the pass took from it”: spawns the per-spawn roll made this family that are another family after the pass (an absent family's all become ordinary zombies). “Slots the pass gave it”: spawns that became this family in the pass. For the baseline family the two are the slots the other families took and gave back.

Roster version 4; the rules of the pass and every family's rule: the seeded roster. Defined at applyEnemyRoster in game/src/ai/enemyRoster.ts:285 (repository access required).

Zombie types (inside the zombie family)

Not separate enemy families. The types (coated, shambler) split the Infected family only; the family shares above do not change with them. Wardrobe outfits are a further appearance choice, also not a family.

Reactor: zombie type chance per spawn (before the at-least-one-of-each rule)
TypeChance per spawn
coated
shambler

Each spawn of a run: coated with the coated chance, else shambler; then, if the run has no coated, its first spawn becomes coated, and (count > 1) if it has no shambler, its second becomes shambler. Ratdogs keep the rolled type but ignore it.

Reactor: expected coated share of one context run (exact, including the at-least-one-of-each rule)
ContextSpawns in the run (n)Expected coated share
Rim (station, rim gallery, rim office)2
Rim (station, rim gallery, rim office)4
Upper walkway tier (zone 1; each of tiers 1-2)6
Upper walkway tier (zone 1; each of tiers 1-2)8
Deep walkway tier (zone 2; each of tiers 3-4)8
Deep walkway tier (zone 2; each of tiers 3-4)11
Core floor (vessel ring, pump hall, control room)9
Core floor (vessel ring, pump hall, control room)12
Service annex (per annex)5
Service annex (per annex)6

Shambler / coated type (the profile's zombie type roll) and the wardrobe outfit chosen at spawn time from (level seed, spawn index, type) by ai/wardrobe.ts pickZombieLook — sub-distributions of the zombie family, not separate families.

Defined at ZOMBIE_TYPES in game/src/ai/spawnTables.ts:379 (repository access required).

Baseline placement rules

These are the generator's own rules for where the counted spawns go. Room modifiers at 1× leave every one of them unchanged. They are also why a generated level can hold fewer spawns than its count drew.

Rim (station, rim gallery, rim office) · station · count 2–4 per run × 1 run

One run covers: the rim storey (level 0: the station platform, the rim gallery, the rim control office). Count per run uniform integer U{2..4} (rng.int, inclusive); E[count] = 3.

Which cells can hold a spawn

  1. a FLOOR cell of the context's storeys (not the outer border row)
  2. walking distance from the start ≥ 36 cells (18 m)
  3. every cell within 1 cell(s) walkable
  4. not a stair ramp, not in a stair-role area, the area on its own storey
  5. ≥ 5 m from every keep point of the storey
  6. the area's effective weight (area weight × room intensity) > 0
Reactor · Rim (station, rim gallery, rim office): keep-away and clearance rules
RuleValueUnitIn metres
walking distance from the player start36cells18
clear walkable cells around the candidate (radius)1cells0.5
straight-line keep-off from stair / elevator landings, the roof hatch and the ladder foot5m5

Which areas are visited first

First matching rule wins (shop sales floors, stock rooms and back-of-house rooms otherwise). A relative weight in the weighted area order, multiplied by the room intensity D of its room key (1 when the room has no modifier). Weight 0 = never a candidate.

Reactor · Rim (station, rim gallery, rim office): area weights (relative order preference; first matching rule wins)
Areas matchingArea weightWhy
kind platform2.2the platforms of the station at the bottom of the pit
type exit-stair / washroom0.5closed street exits and washrooms
type office-stair / stair-core / office-elevator0never in a stairwell, stair core or an elevator cab
kind closet0.5closets
public space1gallery walkways, bridges, the pit plaza and courts
any other area1.3

How many spawns one area may hold

The placement walks the area order once per pass (caps 1, 2, 3); an area takes one more spawn per visit while it is below its cap for that pass. Room modifiers never raise a cap.

Reactor · Rim (station, rim gallery, rim office): spawns one area may hold (passes 1, 2, 3)
Areas matchingCapWhy
kind platformpass cap + 1platforms hold one more per pass
kind closetat most 1closets: at most one
any other areathe pass cap
Tries per area visit
14 random eligible cells
Spacing
at least 4 m between spawns (straight line, same storey)

Placement defined at MALL_PLACEMENT in game/src/ai/spawnTables.ts:487 (repository access required).

How a run places its count, and why it can fall short

  1. Draw count = U{2..4} (one draw per run), then the zombie types of that many spawns.
  2. Collect every eligible cell, grouped by area; order the areas by a weighted shuffle (Efraimidis–Spirakis keys u^(1/weight)).
  3. For each cap pass (1, 2, 3), walk the order: an area below its cap gets up to 14 random cell picks; the first pick ≥ 4 m from every enemy already placed on that storey takes one spawn.
  4. Stop when the count is reached. Spacing, caps and eligible floor can leave a run short of its count (placed < count); validation regenerates the attempt where the profile requires it.
  5. Each placed spawn is then a family by its own roll (see the family pool) — independent of the area unless a room modifier says otherwise.

Checks that reject a whole generation attempt

Context defined at REACTOR_SPAWN_PROFILE.contexts.station in game/src/ai/spawnTables.ts:691 (repository access required).

Upper walkway tier (zone 1; each of tiers 1-2) · floor · count 6–8 per run × 2 runs

One run covers: one UPPER walkway tier (each of tiers 1-2: galleries, landings, bridges, side rooms). Count per run uniform integer U{6..8} (rng.int, inclusive); E[count] = 7.

Same cell eligibility, keep-away, area weights, caps, tries and spacing as Rim (station, rim gallery, rim office) (identical source values).

How a run places its count, and why it can fall short

  1. Draw count = U{6..8} (one draw per run), then the zombie types of that many spawns.
  2. Collect every eligible cell, grouped by area; order the areas by a weighted shuffle (Efraimidis–Spirakis keys u^(1/weight)).
  3. For each cap pass (1, 2, 3), walk the order: an area below its cap gets up to 14 random cell picks; the first pick ≥ 4 m from every enemy already placed on that storey takes one spawn.
  4. Stop when the count is reached. Spacing, caps and eligible floor can leave a run short of its count (placed < count); validation regenerates the attempt where the profile requires it.
  5. Each placed spawn is then a family by its own roll (see the family pool) — independent of the area unless a room modifier says otherwise.

Checks that reject a whole generation attempt

Context defined at REACTOR_SPAWN_PROFILE.contexts.floor in game/src/ai/spawnTables.ts:694 (repository access required).

Deep walkway tier (zone 2; each of tiers 3-4) · ring · count 8–11 per run × 2 runs

One run covers: one DEEP walkway tier (each of tiers 3-4: galleries, landings, bridges, side rooms incl. the switchgear room). Count per run uniform integer U{8..11} (rng.int, inclusive); E[count] = 9.5.

Same cell eligibility, keep-away, area weights, caps, tries and spacing as Rim (station, rim gallery, rim office) (identical source values).

How a run places its count, and why it can fall short

  1. Draw count = U{8..11} (one draw per run), then the zombie types of that many spawns.
  2. Collect every eligible cell, grouped by area; order the areas by a weighted shuffle (Efraimidis–Spirakis keys u^(1/weight)).
  3. For each cap pass (1, 2, 3), walk the order: an area below its cap gets up to 14 random cell picks; the first pick ≥ 4 m from every enemy already placed on that storey takes one spawn.
  4. Stop when the count is reached. Spacing, caps and eligible floor can leave a run short of its count (placed < count); validation regenerates the attempt where the profile requires it.
  5. Each placed spawn is then a family by its own roll (see the family pool) — independent of the area unless a room modifier says otherwise.

Checks that reject a whole generation attempt

Context defined at REACTOR_SPAWN_PROFILE.contexts.ring in game/src/ai/spawnTables.ts:695 (repository access required).

Core floor (vessel ring, pump hall, control room) · pit · count 9–12 per run × 1 run

One run covers: the core floor (round the vessel, the pump hall, the control room). Count per run uniform integer U{9..12} (rng.int, inclusive); E[count] = 10.5.

Same cell eligibility, keep-away, area weights, caps, tries and spacing as Rim (station, rim gallery, rim office) (identical source values).

How a run places its count, and why it can fall short

  1. Draw count = U{9..12} (one draw per run), then the zombie types of that many spawns.
  2. Collect every eligible cell, grouped by area; order the areas by a weighted shuffle (Efraimidis–Spirakis keys u^(1/weight)).
  3. For each cap pass (1, 2, 3), walk the order: an area below its cap gets up to 14 random cell picks; the first pick ≥ 4 m from every enemy already placed on that storey takes one spawn.
  4. Stop when the count is reached. Spacing, caps and eligible floor can leave a run short of its count (placed < count); validation regenerates the attempt where the profile requires it.
  5. Each placed spawn is then a family by its own roll (see the family pool) — independent of the area unless a room modifier says otherwise.

Checks that reject a whole generation attempt

Context defined at REACTOR_SPAWN_PROFILE.contexts.pit in game/src/ai/spawnTables.ts:696 (repository access required).

Service annex (per annex) · service · count 5–6 per run × one run per zone (0–1 per level)

One run covers: one seeded service annex off a rim-station track tunnel (its rooms and corridors only). Count per run uniform integer U{5..6} (rng.int, inclusive); E[count] = 5.5.

Which cells can hold a spawn

  1. a FLOOR cell of the context's storeys (not the outer border row)
  2. walking distance from the start ≥ 36 cells (18 m)
  3. every cell within 1 cell(s) walkable
  4. the area's effective weight (area weight × room intensity) > 0
  5. an area of the zone (one service annex), ≥ 6 m from the annex's entry door (its keep point)
Reactor · Service annex (per annex): keep-away and clearance rules
RuleValueUnitIn metres
walking distance from the player start36cells18
clear walkable cells around the candidate (radius)1cells0.5
straight-line keep-off from stair / elevator landings, the roof hatch and the ladder foot6m6

Which areas are visited first

First matching rule wins (annex rooms (pump / electrical rooms, stores, workshops, custodial rooms) otherwise). A relative weight in the weighted area order, multiplied by the room intensity D of its room key (1 when the room has no modifier). Weight 0 = never a candidate.

Reactor · Service annex (per annex): area weights (relative order preference; first matching rule wins)
Areas matchingArea weightWhy
kind closet0.6annex closets (janitor / electrical / supply)
kind service1annex service corridors (1.5-2 m wide)
any other area1.4

How many spawns one area may hold

The placement walks the area order once per pass (caps 1, 2); an area takes one more spawn per visit while it is below its cap for that pass. Room modifiers never raise a cap.

Reactor · Service annex (per annex): spawns one area may hold (passes 1, 2)
Areas matchingCapWhy
kind closetat most 1closets: at most one
any other areathe pass cap
Tries per area visit
12 random eligible cells
Spacing
at least 5 m between spawns (straight line)

Placement defined at SERVICE_PLACEMENT in game/src/ai/spawnTables.ts:405 (repository access required).

How a run places its count, and why it can fall short

  1. Draw count = U{5..6} (one draw per run), then the zombie types of that many spawns.
  2. Collect every eligible cell, grouped by area; order the areas by a weighted shuffle (Efraimidis–Spirakis keys u^(1/weight)).
  3. For each cap pass (1, 2), walk the order: an area below its cap gets up to 12 random cell picks; the first pick ≥ 5 m from every enemy already placed takes one spawn.
  4. Stop when the count is reached. Spacing, caps and eligible floor can leave a run short of its count (placed < count); validation regenerates the attempt where the profile requires it.
  5. Each placed spawn is then a family by its own roll (see the family pool) — independent of the area unless a room modifier says otherwise.

Checks that reject a whole generation attempt

Context defined at REACTOR_SPAWN_PROFILE.contexts.service in game/src/ai/spawnTables.ts:697 (repository access required).

Room modifiers

All 28 room keys resolve to 1× for every family (neutral); the profile sets no room modifiers. A room key or family without an entry resolves to 1×, which leaves the baseline placement unchanged.

Room key = the area's purpose id (gen/purposes.ts) when it has one, else its room type. Each field resolves: purpose entry → room-type entry → 1 (missing = neutral). Two modifiers exist per room key and family. Density changes local intensity: how strongly the room's areas are preferred when spawns are spread. Weight changes conditional composition: which family a spawn placed in that room is. Neither changes the count range, and caps and spacing still apply. No explicit entries: every other room / family resolves to 1×. Rows list the room keys seen in the sampled census plus any explicit entry; a key not listed resolves to 1× as well.

What each room modifier changes (per room key and enemy family)
ModifierChangesHowAt 0At 2
Density (local intensity)local intensityarea weight × D, D = all.density × Σ_f p_f·w_f·d_f / Σ_f p_f·w_f (p = pool weight, w = weight modifier, d = density modifier); the room's family mix uses p_f·w_f·d_fD = 0: the room is never a candidate (no spawns there); the count roll and the other rooms are unchanged, so its spawns go elsewhere when capacity allows.The room is visited earlier in every cap pass, so it tends to fill its caps before the count runs out: more spawns there, fewer elsewhere, the same total.
Weight (conditional composition)conditional compositionP(family f | spawn lands in the room) = p_f·w_f·d_f / Σ_g p_g·w_g·d_gThat family never spawns in that room (its spawns there become the other families).Twice its relative odds in that room before normalisation; the room still attracts the same number of spawns.

The profile sets no explicit room modifier entries: every room key below resolves to the neutral 1×.

Reactor: resolved room modifiers for every room key the level can produce (1× = neutral)
Room keyKey kindSampled room typesRoom intensity D(room)Infected: densityInfected: weightBlightbelly: densityBlightbelly: weightSiren: densitySiren: weightTunnel scavenger (rat/dog): densityTunnel scavenger (rat/dog): weightStrainer: densityStrainer: weightScreacher: densityScreacher: weightBB: densityBB: weight
Station agent officeagent-officeRoom purposeStation agent office agent-office1×1×1×1×1×1×1×1×1×1×1×1×1×1×1×
Picked-over storesannex-pickedRoom purposeUtility room utility1×1×1×1×1×1×1×1×1×1×1×1×1×1×1×
ConcourseconcourseRoom typeConcourse concourse1×1×1×1×1×1×1×1×1×1×1×1×1×1×1×
Custodial & waste roomcustodial-roomRoom purposeUtility room utility1×1×1×1×1×1×1×1×1×1×1×1×1×1×1×
Electrical closetelectrical-closetRoom purposeJanitor closet janitor-closet, Utility room utility1×1×1×1×1×1×1×1×1×1×1×1×1×1×1×
Electrical roomelectrical-roomRoom purposeUtility room utility1×1×1×1×1×1×1×1×1×1×1×1×1×1×1×
Ticket hallfare-hallRoom typeTicket hall fare-hall1×1×1×1×1×1×1×1×1×1×1×1×1×1×1×
First-aid roomfirst-aid-roomRoom purposeCrew room crew-room, Utility room utility1×1×1×1×1×1×1×1×1×1×1×1×1×1×1×
Generator roomgenerator-roomRoom purposeUtility room utility1×1×1×1×1×1×1×1×1×1×1×1×1×1×1×
Janitor closetjanitor-closetRoom purposeJanitor closet janitor-closet1×1×1×1×1×1×1×1×1×1×1×1×1×1×1×
Crew locker roomlocker-roomRoom purposeCrew room crew-room1×1×1×1×1×1×1×1×1×1×1×1×1×1×1×
PlatformplatformRoom typePlatform platform1×1×1×1×1×1×1×1×1×1×1×1×1×1×1×
Pump roompump-roomRoom purposeUtility room utility1×1×1×1×1×1×1×1×1×1×1×1×1×1×1×
Armouryreactor-bunker-armouryRoom purposeStorage room storage1×1×1×1×1×1×1×1×1×1×1×1×1×1×1×
Decontaminationreactor-bunker-deconRoom purposeUtility room utility1×1×1×1×1×1×1×1×1×1×1×1×1×1×1×
Dormitoryreactor-bunker-dormitoryRoom purposeCrew room crew-room1×1×1×1×1×1×1×1×1×1×1×1×1×1×1×
Radio roomreactor-bunker-radioRoom purposeUtility room utility1×1×1×1×1×1×1×1×1×1×1×1×1×1×1×
Transit security officesecurity-officeRoom purposeUtility room utility1×1×1×1×1×1×1×1×1×1×1×1×1×1×1×
Service corridorservice-corridorRoom purposeService corridor service-corridor1×1×1×1×1×1×1×1×1×1×1×1×1×1×1×
Signal relay roomsignal-roomRoom purposeUtility room utility1×1×1×1×1×1×1×1×1×1×1×1×1×1×1×
Staff roomstaff-roomRoom purposeCrew room crew-room1×1×1×1×1×1×1×1×1×1×1×1×1×1×1×
Stock roomstock-roomRoom purposeStock room stock-room1×1×1×1×1×1×1×1×1×1×1×1×1×1×1×
Maintenance storagestorageRoom purposeStorage room storage1×1×1×1×1×1×1×1×1×1×1×1×1×1×1×
Supply closetsupply-closetRoom purposeSupply closet supply-closet1×1×1×1×1×1×1×1×1×1×1×1×1×1×1×
Turbine hallturbine-hallRoom purposeStorage room storage1×1×1×1×1×1×1×1×1×1×1×1×1×1×1×
Ventilation plantventilation-plantRoom purposeUtility room utility1×1×1×1×1×1×1×1×1×1×1×1×1×1×1×
WashroomwashroomRoom purposeWashroom washroom1×1×1×1×1×1×1×1×1×1×1×1×1×1×1×
Maintenance workshopworkshopRoom purposeStorage room storage, Utility room utility1×1×1×1×1×1×1×1×1×1×1×1×1×1×1×

Room intensity D(room) multiplies the room's baseline area weight (see placement rules). Defined at roomIntensity in game/src/ai/spawnTables.ts:992 (repository access required). Meaning of each field: room modifiers.

Sampled census

sampled Observed, not a rule. These figures come from running the real Reactor generator on a small fixed corpus: 4 generated layouts from seeds 11, 222, 3333, 44444, pistol start. Eligible floor is the floor the generator's own candidate filter accepted (67691 cells of 0.25 m², 16922.8 m² in total), not the map's bounding box. Densities are placed spawns per 100 m² of that eligible floor over this sample only. Families are counted with the seeded roster applied: what these levels hold. The roster changes families only, so the totals are the generator's.

SAMPLED: 4 sample levels of the registered generator (seeds 11, 222, 3333, 44444, shipped start weapon) WITH THE SEEDED ROSTER APPLIED (roster version 4: what a level holds; the roster only changes families, so counts, positions and eligible floor are the generator's). Eligible floor = cells the generator's own candidate filter accepted (walking distance, clearance, storey, stair / landing keep-off, weight > 0) x 0.25 m² — never bounding boxes. Not exhaustive; not a runtime rule.

Reactor: placed spawns per family with the seeded roster applied (sampled: 4 layouts)
FamilyPlaced over the sample (with the roster)Mean per levelSample levels that hold itPer 100 m² eligible floor (sampled)Placed by the per-spawn roll alone (before the roster pass)
Infectedzombie12932.254 of 40.762134
Blightbellyblightbelly184.54 of 40.10618
Sirensiren61.54 of 40.0354
Tunnel scavenger (rat/dog)ratdog307.54 of 40.17730
Strainerstrainer000 of 400
Screacherscreacher20.51 of 40.0120
BBbb10.251 of 40.0060
Reactor: placed spawns per generation context (sampled)
ContextEligible floor m²Placed over the sampleMean per levelPer 100 m² eligible floor (sampled)Placed by family (sampled outcome)
Rim (station, rim gallery, rim office)3753112.750.293zombie 10 (90.9 %) · ratdog 1 (9.1 %)
Upper walkway tier (zone 1; each of tiers 1-2)50925413.51.06zombie 39 (72.2 %) · blightbelly 2 (3.7 %) · ratdog 12 (22.2 %) · screacher 1 (1.9 %)
Deep walkway tier (zone 2; each of tiers 3-4)3443.380202.32zombie 51 (63.8 %) · blightbelly 12 (15 %) · siren 4 (5 %) · ratdog 13 (16.3 %)
Core floor (vessel ring, pump hall, control room)4634.54110.250.885zombie 29 (70.7 %) · blightbelly 4 (9.8 %) · siren 2 (4.9 %) · ratdog 4 (9.8 %) · screacher 1 (2.4 %) · bb 1 (2.4 %)
Reactor: placed spawns per area kind (sampled)
Area kindEligible floor m²Infected placedBlightbelly placedSiren placedTunnel scavenger (rat/dog) placedStrainer placedScreacher placedBB placedPer 100 m² eligible floor (sampled)
closet23.2510010008.6
concourse9949.8419090000.593
passage36560030102.74
platform930.500000000
room4057.54666130111.8
service1596.8353040002.63
Reactor: Infected spawns by type (sampled)
TypePlaced over the sample
coated53
shambler76
Reactor: room keys in the sample (sampled; baseline area weights as the generator assigned them)
Room keyBaseline area weight(s)Layouts with itAreasEligible floor m²Infected placedBlightbelly placedSiren placedTunnel scavenger (rat/dog) placedStrainer placedScreacher placedBB placedPer 100 m² eligible floor (sampled)
Station agent officeagent-office1.3489410000012.13
Picked-over storesannex-picked1.3415263.811000000.758
Concourseconcourse1, 1.341319949.5419090000.593
Custodial & waste roomcustodial-room1.344126.500010000.791
Electrical closetelectrical-closet0.5, 1.33433.520000005.97
Electrical roomelectrical-room1.341319261110004.69
Ticket hallfare-hall1110.2500000000
First-aid roomfirst-aid-room1.3414206.830010102.42
Generator roomgenerator-room1.341257410020000.523
Janitor closetjanitor-closet0.5223.500000000
Crew locker roomlocker-room1.341926660020003.01
Platformplatform2.244930.500000000
Pump roompump-room1.341113141010004.58
Armouryreactor-bunker-armoury1.34448.2500000000
Decontaminationreactor-bunker-decon1.34458.500000000
Dormitoryreactor-bunker-dormitory1.344104.500000000
Radio roomreactor-bunker-radio1.3448410000001.19
Transit security officesecurity-office1.344110.800000000
Service corridorservice-corridor1.341521961.8413070102.65
Signal relay roomsignal-room1.349115.822100004.32
Staff roomstaff-room1.3413124.341010004.83
Stock roomstock-room1.34453.2500010001.88
Maintenance storagestorage1.3436608.3100110001.97
Supply closetsupply-closet0.54716.500010006.06
Turbine hallturbine-hall1.34836000120000.833
Ventilation plantventilation-plant1.34717930000001.68
Washroomwashroom0.54759.7500000000
Maintenance workshopworkshop1.341726730200001.87

How to read these numbers

More: How to read enemy numbers.

Where to tune it

Each value names the source file and export where it lives (the game repository is private).

Reactor: where each enemy spawn value is tuned
ValueCurrentWhere it lives
count range (station)2–4REACTOR_SPAWN_PROFILE.contexts.station.count in game/src/ai/spawnTables.ts:691 (repository access required)
count range (floor)6–8REACTOR_SPAWN_PROFILE.contexts.floor.count in game/src/ai/spawnTables.ts:694 (repository access required)
count range (ring)8–11REACTOR_SPAWN_PROFILE.contexts.ring.count in game/src/ai/spawnTables.ts:695 (repository access required)
count range (pit)9–12REACTOR_SPAWN_PROFILE.contexts.pit.count in game/src/ai/spawnTables.ts:696 (repository access required)
count range (service)5–6REACTOR_SPAWN_PROFILE.contexts.service.count in game/src/ai/spawnTables.ts:717 (repository access required)
family pool weightszombie 0.9, blightbelly 0.05, siren 0, ratdog 0.05, strainer 0, screacher 0, bb 0REACTOR_SPAWN_PROFILE.families in game/src/ai/spawnTables.ts:689 (repository access required)
coated chance0.4ZOMBIE_TYPES in game/src/ai/spawnTables.ts:379 (repository access required)
area weights5 rules, otherwise 1.3MALL_AREA_WEIGHTS in game/src/ai/spawnTables.ts:467 (repository access required)
capspasses 1 / 2 / 3; 2 rulesMALL_CAPS in game/src/ai/spawnTables.ts:479 (repository access required)
tries per area visit14MALL_PLACEMENT.tries in game/src/ai/spawnTables.ts:488 (repository access required)
spacing (m)4MALL_PLACEMENT.spacingM in game/src/ai/spawnTables.ts:488 (repository access required)
keep-away from the start (cells)18 m walking36MALL_PLACEMENT.startCells in game/src/ai/spawnTables.ts:488 (repository access required)
landing keep-off (m)5MALL_PLACEMENT.landingKeepM in game/src/ai/spawnTables.ts:488 (repository access required)
area weights2 rules, otherwise 1.4SERVICE_AREA_WEIGHTS in game/src/ai/spawnTables.ts:387 (repository access required)
capspasses 1 / 2; 1 rulesSERVICE_CAPS in game/src/ai/spawnTables.ts:396 (repository access required)
tries per area visit12SERVICE_PLACEMENT.tries in game/src/ai/spawnTables.ts:406 (repository access required)
spacing (m)5SERVICE_PLACEMENT.spacingM in game/src/ai/spawnTables.ts:406 (repository access required)
keep-away from the start (cells)18 m walking36SERVICE_PLACEMENT.startCells in game/src/ai/spawnTables.ts:406 (repository access required)
landing keep-off (m)6SERVICE_PLACEMENT.landingKeepM in game/src/ai/spawnTables.ts:406 (repository access required)
room modifiersroom key → family (or all) → {density, weight}none (all 1×)REACTOR_SPAWN_PROFILE.rooms in game/src/ai/spawnTables.ts:699 (repository access required)
eligibility (siren)ring / pit; fallback zombie; at most 2 per levelREACTOR_SIREN_ELIGIBILITY in game/src/ai/spawnTables.ts:675 (repository access required)
spacing (siren, m)whole level, with the cap30REACTOR_SIREN_SPACING in game/src/ai/spawnTables.ts:683 (repository access required)
difficulty tiermetadata only (no scaling)3LEVELS.reactor.tier in game/src/levels/registry.ts:163 (repository access required)
ambient budget (total / per storey)54 / 12REACTOR_SPAWN_PROFILE.budgets in game/src/ai/spawnTables.ts:704 (repository access required)
seeded roster rate (blightbelly)chance a level map holds the family at all; one roll per level seed1FAMILY_ROSTER.blightbelly in game/src/ai/enemyRoster.ts:154 (repository access required)
seeded roster rate (siren)chance a level map holds the family at all; one roll per level seed0.85FAMILY_ROSTER.siren in game/src/ai/enemyRoster.ts:156 (repository access required)
seeded roster rate (ratdog)chance a level map holds the family at all; one roll per level seed1FAMILY_ROSTER.ratdog in game/src/ai/enemyRoster.ts:158 (repository access required)
seeded roster rate (strainer)chance a level map holds the family at all; one roll per level seed0.35FAMILY_ROSTER.strainer in game/src/ai/enemyRoster.ts:160 (repository access required)
seeded roster rate (screacher)chance a level map holds the family at all; one roll per level seed0.4FAMILY_ROSTER.screacher in game/src/ai/enemyRoster.ts:162 (repository access required)
seeded roster rate (bb)chance a level map holds the family at all; one roll per level seed0.4FAMILY_ROSTER.bb in game/src/ai/enemyRoster.ts:175 (repository access required)