Seed to world: the core specs composed, from the game seed to a populated level and a drop
Purpose
Section titled “Purpose”This spec composes the core specs into one call order. The inputs are a game seed, the difficulty, the game type and
the inputs of § Inputs (where the player walks, what simulation does, the player’s character, quest state). The
output is everything the server builds from them: each level’s layout and rooms, the objects, the monster population
with its packs, special monsters and creation stats, the revisit re-creations, and, from a dying unit’s seed, every
item it drops down to its last property. It adds no mechanic of its own. Each step is specified in the spec it links,
and this page states only the order, the seeds that cross from one spec to the next, and the run that checked the
composition with no oracle inside it. Primitives (Step, Range, Init) are those of rng.
Entry points
Section titled “Entry points”| When | Function | Tag |
|---|---|---|
| Game creation | GAME_InitSeeds, GameCreate |
[C] |
| A level is first needed | DRLG_LevelCreate |
[C] |
| A room activates | DRLG_RoomActivate |
[C] |
| New rooms of an act, start of the next frame | NewRoomsUpdate |
[C] |
| A monster dies | MONSTER_DropItems → TC_ResolveDrops |
[C] |
| A player operates a chest | OBJ_OperateDispatch |
[C] |
The first four rows are the entry points of rng/seeds, drlg/overview, drlg/room-tiles and drlg/lifecycle, and the last two those of items/tc and objects § J. [C]
Inputs
Section titled “Inputs”Tables
Section titled “Tables”None of its own. Each step reads the tables its own spec lists; the composition adds no table read. [C]
Runtime state
Section titled “Runtime state”What a reimplementation supplies, by class, with the count of each in the 37 logs. Besides these, only the remaining oracles listed under Inputs and oracles enter the composition, each counted.
| Input | Class | What it fixes | Count in the run | Tag |
|---|---|---|---|---|
seed N (-seed), difficulty, game type |
configuration | the game seed and the map seed (rng/seeds step 1), the region pools, the level parameters | 37 games | [C] |
| which rooms activate, in which order, with which near rooms active | player actions | each room’s near list, so its grid stamp, the act’s room list order, so the walk order (§ C, § D) | 18 459 activations (AROOM) |
[I] |
| when a player operates which object | player actions | the operate’s draws and the operate spawns (oracle 8) | operate and trap spawns 6, 25 and 2; non-container OperateFns 53 |
[C] |
| the dying unit’s seed at death | simulation | the TC resolution and the quality rolls of its drop (§ G); combat draws on it | 3 784 TC_ResolveDrops calls (TCR) |
[C] |
| the game seed at each drop | simulation | each dropped item’s unit and start seeds (§ G); every server unit simulation creates steps it | 3 784 (TCR gseed) |
[C] |
| when an object timer event runs | simulation | which timer draws happen; their draws are modelled | 20 109 timer draws | [C] |
| a restored monster’s class, unit id, cell and alive or dead state (oracle 25) | simulation (monster AI and movement) | which records the revisit restore re-creates, where, and dead or alive (§ F) | 7 290 re-creations (103 made no unit) | [C] |
| the killer’s magic find, and a summon’s owner’s | the player’s character | the quality roll’s magic-find terms | QKMF 473, QMF 479 |
[C] |
| quest state | quest state | the state InitFns’ modes and interact bytes, class 434’s mode, the Chaos Sanctuary gate test, the quest seed at a scripted drop |
modes 952, interact bytes 49, class 434 3 | [C] |
| a revisited room’s saved objects | simulation and player history | the saved interact, mode and sparkle of a re-created object | 35 | [C] |
- [I] Activation order is an input beyond the per-room seeds. The level seed and the active-room seed do not depend on it, but the game seed (one step per server unit), the object-region seed (carried across rooms) and each room’s near list do.
- [I] The activation order is answered with a limit, sim/frame § H:
the order is derivable from a per-frame record of (a) each client’s new room at the room sync, (b) every on-demand
activation and
RoomUpdateOnecall and (c) the room pins. (a) is the end of the player’s movement, so it stays a logged input until a movement model exists. - [I] The game seed at a pass entry is a chained value only while no unit was created by simulation since the previous pass; a missile or a summon in between shifts it. For the same reason the game seed at each drop is an input.
Constants
Section titled “Constants”None of its own.
Inputs and oracles
Section titled “Inputs and oracles”A retired oracle is a callee that an earlier reproduction took from the log at a subsystem’s boundary and that a model now predicts inside the chain; the model is in the spec linked. [C]
| # | Former oracle | Now | Model | Tag |
|---|---|---|---|---|
| 1 | the property roll ItemApplyProps |
modelled | items/properties § B | [C] |
| 2 | ITEMS_RollStaffMods |
modelled, the default since | items/affixes § I | [C] |
| 3 | the builders under a failed unique or set | modelled | items/affixes after items/uniques-sets § E | [C] |
| 5 | the drop quality roll | modelled | items/quality | [C] |
| 6 | TC_ResolveDrops at an object’s drop |
modelled | items/tc § J, objects § J | [C] |
| 7 | the gold drop of InitFn 28 |
modelled in its seeds and marks; the spot read, predicted for 69 of 71 | objects § H row 28 | [C] the seeds and marks; [I] the spot |
| 14 | the unit seed after SUnitCreate |
modelled | monsters/spawn § J, monsters/pool § D, monsters/stats § B | [C] |
| 15, 16 | the presets window and its preset monsters | modelled | objects § I, monsters/spawn § H | [C] |
| 17 | InitFn 46 (City of the Damned) |
modelled; the other monster-creating InitFns stay seed oracles |
objects § H row 46 | [C] |
| 21 | another room’s seed in a pass | chain state | that room’s seed (§ D6) | [C] |
| 22 | Orient89Unit’s units |
the presets window’s | drlg/room-tiles step 11, then § D2 | [C] |
| 26–31 | position predicates, maze and outdoor windows, preset drop rolls, special mods, tile placement | — | drlg/collision, drlg/maze, drlg/outdoor, drlg/preset, monsters/special | [C] |
Remaining oracles inside the chain, taken from the log and counted, with the reason. The 2 189 populations the run counts as oracle-free hold no seed taken from the log in their window or pass; the value inputs of oracles 19 and 20 below are read in every one of them, and a window holding any other row of this table does not count. [C] (review ruling 2)
| Remaining | Why it stays | Count in the run | Tag |
|---|---|---|---|
oracle 19, the gate’s DRLG parts (room flags 0x30000, RoomPopLevelId, the preset and town tests, LevelRoomCount) |
read and asserted against the reading at every gate, but the room flags are DRLG state not yet handed from the DRLG model to the walk | 4 883 gates (4 801, 3 885 and 3 676 assertions, 82 closed by 0x30000), LevelRoomCount in 88 windows |
[C] |
oracle 20, the grid snapshot at pass entry (SN), the barrier grid of the flood (LG0), the type-11 point (NWW) |
the composed grid equals the snapshot in 4 723 of 4 883 pass rooms; the residue is unit bits of players, monsters that walked, items and corpses; the barrier grid and the type-11 point are read, not modelled | SN 4 883, LG0 7 343, NWW 21 943 |
[C] |
| MonPlace rows 5, 10 and 11 | not modelled in the chain | 3, 4, 3 | [C] |
| a creation outside the model with no level known; a region append by a creation outside the model | the creation is an operate or InitFn spawn the model does not run |
34; 12 | [C] |
| a presets-window cell test whose room has no cells in the model | the cell lies in an active room the grid model holds no cells for | 35 each | [C] |
| the special-count increment in a preset monster’s creation | taken from the log | 8 | [C] |
| a gold pile’s spot | the model’s spot disagrees | 1 | [C] |
| a chest’s interact byte at its operate | its writer is not read (Open questions) | 7 (lock bit set 2, lock bit cleared 3, cleared to 0 2) | [C] |
- [C] Where the objects checker takes a seed at a preset monster’s or an
InitFn46 request’s exit and the monsters checker predicts and asserts it at the same line, both run in one check and a failed assert fails the run; the composed value is the model’s. These are not oracles of the composition, and this spec states the one call order. (Phase 1 review ruling 1, log)
Algorithm
Section titled “Algorithm”A. Game creation [C] (GAME_InitSeeds, § 1) A1. game.seed ← Init(N); mapSeed ← N ; rng/seeds step 1, override branch A2. game draw 1 → monster regions: Init(low) ; monsters/pool § A, then the region build A3. game draw 2 → object-region seed O: Init(low) ; objects § A A4. game draw 3 → store seed; game draw 4 → quest seed
B. Acts and levels [C] B1. act.seed ← Init(mapSeed); Step; levelSeedBase ← low; the act's own draws ; rng/seeds step 3 B2. when a level is first needed: level.seed ← Init(levelSeedBase + levelId) ; rng/seeds step 4 B3. the level's generator on level.seed (preset, maze, outdoor) with the preset drop rolls ; drlg/overview B4. each DRLG room: one level draw ; rng/seeds step 5
C. Room activation, in the player's order [C] C1. DRLG room re-seeded, k room-type draws, Orient89Unit's draws ; drlg/room-tiles steps 1–11 C2. the collision grid stamped from the tiles of the active near rooms ; drlg/collision § A C3. Step(DRLG room seed); activeRoom.seed ← Init(low) ; rng/seeds step 6
D. The new-rooms walk, per act with new rooms, per room of the act's room list [C] D1. RoomWandererTick: one active-room step, always ; drlg/lifecycle § I if the room's flags bit 0 is clear (first activation): D2. presets window: the room's preset units in order ; objects § I; preset monsters through E D3. inactive restore: no record, no draw ; drlg/lifecycle § H D4. object population on O: the gate, the slots, each object's creation ; objects §§ C–H D5. population pass on the room seed and the game seed ; monsters/spawn §§ A–K, each creation through E D6. every room the pass drew on keeps its seed as chain state for its next request else, once per activation: the revisit restore only ; § F
E. One monster creation (SUnitCreate type 1, from MonSpawnTry) [C] E1. Step(game.seed); unit.seed ← Init(low) ; rng/seeds 7a E2. MonRegionFindAdd: an appended class rolls MonVariantRoll(unit.seed, entry, 3) ; monsters/pool § D E3. MonStatsInit's unit-seed draws, then MonEquip's ; monsters/stats § B, B12 each MonEquip item: two game-seed steps ; § G's item creation E4. for a special: the mod picks and handlers ; monsters/special E5. the grid marks of the creation ; drlg/collision § F
F. Revisit restore of a released room [C] F1. monster records, oldest first: MonSpawnTry at the record's cell, then E1–E3 and E5 ; drlg/lifecycle § H a special's or minion's mods come from the record, not from new picks ; drlg/lifecycle H2b, H2c F2. item records, then the other unit records ; drlg/lifecycle § H4, objects § B5
G. Death and drop [C] G1. the TC on the dying unit's seed; each pick's quality on the same seed ; items/tc §§ B–H, items/quality G2. each item: Step(game.seed) → unit seed Init(low); Step(game.seed) → start seed ; rng/seeds 7a G3. base stats on the unit seed ; items/properties § A G4. the item chain on Init(start) ; § H a chest's drop: G1–H on the object's unit seed ; objects § J
H. The item chain [C] H1. uniques and sets, the fallback builders ; items/uniques-sets H2. the builder's picks with their property rolls, the staff mods ; items/affixes, items/properties § B H3. the ethereal roll, the socket roll, the automagic pick ; items/properties § F, items/affixes § JStep notes:
-
A. [C] reproduces, from
-seed Nalone, the game seed, the four game-creation draws, the act bases and their own draws and every level’s seed; on-seed 12345it prints the rng/seeds worked example. -
B. [C] A level’s seed does not depend on the order in which levels are built: it is a sum, not a draw. The run built 176 (level, difficulty, game type) with every generator kind (DrlgType 1: 65, 2: 36, 3: 75) and every act of each game type in each difficulty.
-
C. [I]
Orient89Unitmakes a preset unit of the room at activation, not a unit; the units its rows name are created later in the presets window (D2). -
C. [C] A room’s near list at activation holds the near rooms already active, and the grid stamp reads their tiles, so the activation order reaches the grid.
-
D. [C] The walk restores and populates a room whose flags bit 0 is clear and only restores one with bit 0 set and bit 1 clear; a re-activated room is never populated again.
-
D2. [C] A preset monster below
nMonStatsgoes throughPresetClassSpawntoSpawnAtPosand E; the MonPlace fixed rows take their class throughLevelClassVariant; a superunique or MonPlace 2/3 preset goes through monsters/special § G–H; a tile unit (preset type 5) steps the game seed once and takesInit(low). 311 class-case presets of the 62 Phase 1 logs were predicted. -
D4. [C] The object-region seed
Ois one object for the whole game, carried across every room’s population, every operate and every timer event, so the order of the object populations decides each room’s object draws. -
D4. [C] The objects window draws the room seed, the game seed and
O; on the run it created 13 056 objects (2 888 by the population, 10 168 presets) with every seed predicted. -
D5. [C]
NearWarpTestcan activate a room and step the level seed inside a pass. -
D6. [C] A request placed on another room’s tile draws from that room’s seed: its predicted activation seed, or its seed after its last pass.
-
E. [C] Every server unit other than a player steps the game seed once at its creation, and an item twice. On the run, 12 580 unit seeds after
SUnitCreatewere predicted, of 12 580 creations. -
E3. [C] MonEquip’s item creation runs on the stock table only for classes 234 and 267 (Blood Raven), each with one row of level 0 and one location; the run reproduced its 4 creations with their items. Its other branches are
[I](Open questions). -
E4. [C] 63 champion packs and 162 unique and minion packs, with 217 special-mods rolls, were predicted.
-
F. [C] A re-created monster gets a new unit seed and a full
MonsterInit(E1–E3), and its marks are those of drlg/lifecycle § H5. Where it lands and whether it is dead are oracle 25’s input. -
G. [C] 1 314 monster drops with an item (1 492 items) were predicted from the dying unit’s logged seed with no builder oracle; all 3 784
TC_ResolveDropscalls and 1 913 item creations reproduce. -
G. [C] At a chest’s drop the object’s unit seed after the drop is the resolver’s exit seed and the game seed after it is two steps per item created;
Odoes not move.
Entry contracts
Section titled “Entry contracts”What each step receives. The seed column is the seed state at the step’s entry; “chain” means the value the steps before it leave, with no input between. [C]
| Step | Entry | Seed in | Arguments | State read | Spec | Tag |
|---|---|---|---|---|---|---|
| A | game creation | Init(N) |
difficulty, game type | the tables | rng/seeds, monsters/pool § A, objects § A | [C] |
| B | DRLG_LevelCreate |
Init(levelSeedBase + levelId) |
level id | Levels, LvlPrest, LvlMaze, LvlSub and the DS1 files | drlg/overview | [C] |
| C | DRLG_RoomActivate |
the DRLG room’s seed | the room | the near rooms already active (input order), the DT1 tiles | drlg/room-tiles, drlg/collision § A | [C] |
| D1 | RoomWandererTick |
the active room seed | the room | the region’s wanderer count, the room’s client list | drlg/lifecycle § I | [C] |
| D2–D4 | the window RW1 → RW4 |
room seed, game seed and O: chain |
the room, its preset units | the grid, quest state (inputs), the gate’s DRLG parts (oracle 19) | objects § B | [C] |
| D5 | RoomPopulate |
room seed and game seed: chain | the room | the level’s region, the grid snapshot (oracle 20), the logic boxes, the warp points | monsters/spawn § A | [C] |
| E | SUnitCreate type 1 |
game seed: chain | class, cell, mode, request flags | the region entry, MonStats, MonStats2, MonLvl, MonProp, MonEquip | monsters/spawn § J, monsters/stats | [C] |
| F | RoomInactiveUnitsRestore |
room seed and game seed: chain | the room’s records | the records’ class, id, cell and state (oracle 25) | drlg/lifecycle § H | [C] |
| G | TC_ResolveDrops |
the dying unit’s seed (input) | TC, item level, the killer | magic find (input), player count | items/tc § D | [C] |
| G2 | item creation | the game seed at the drop (input) | base, quality, item level | the base tables | rng/seeds step 7a, items/uniques-sets § A | [C] |
| H | ItemCreateByQuality |
{start, 666} |
the creation record | the item tables | items/uniques-sets, items/affixes, items/properties | [C] |
Outputs
Section titled “Outputs”-
The levels built from the game seed, their rooms, presets, warps and waypoints. [C]
-
Per activated room, in the player’s order: its objects, its monster population with packs, minions and special monsters and their creation stats, and on each revisit its re-created units with their grid marks. [C]
-
Per death, from the dying unit’s seed: every item of its drop with its quality, affixes, unique or set pick and properties. [C]
-
The seeds left for what comes next: the game seed,
O, and each room’s seed. [C]
Worked example
Section titled “Worked example”All from kept logs, each reproduced by run 2’s with 0 sub-checks failed. Seeds are low:high, hex. They double as test vectors.
1. From -seed 4802 to level 57 (Normal, expansion)
Section titled “1. From -seed 4802 to level 57 (Normal, expansion)”the Halls of the Dead 2 session; prints the same values from N alone. [C]
| Step | Value | Log line |
|---|---|---|
| A1 game seed, map seed | 000012C2:0000029A, 000012C2 |
GAME, line 47 |
| A2 monster regions | Init → E0A791E4:0000029A |
(gen) |
A3 object-region seed O |
615B8C46:0000029A; game seed then 615B8C46:5DB3A30E |
OGC, line 49 |
| A4 store, quest | 4231F4EC:0000029A, 5959A58E:0000029A |
(gen) |
B1 levelSeedBase |
E0A791E4 |
LC0 base 3769078244 |
| B2 level 57 | E0A791E4 + 0x39 → E0A7921D:0000029A; DrlgType 1; region pool 374, 101, 101 |
LC0, line 2073 |
2. One room population, end to end (level 57)
Section titled “2. One room population, end to end (level 57)”The same log, the room activated at line 2271 and populated at lines 3944–4152. The room is one of the run’s 2 189 oracle-free populations. [C]
| Step | Seeds after | Notes |
|---|---|---|
| C3 activation | active room 4DAC63D4:0000029A (DRLG room 4DAC63D4:4D8861C4) |
AROOM |
D entry (RW0) |
room 4DAC63D4:0000029A, game F32620F0:18A533CC, O D702B3B7:15932444 |
|
| D1 wanderer tick | room BBC814BE:2065A097 |
low & 0x7FFF = 0x14BE ≠ 0: no wanderer |
| D2, D3 | unchanged | no preset unit, no record |
| D4 objects | O D5486017:59ADE417, room 4AAEC54A:14C4F38E, game unchanged |
the gate passes (pop 57); eight slots; no object created |
D5 pass entry (P0) |
room 4AAEC54A:14C4F38E, game F32620F0:18A533CC |
|
| D5 first placement | game F9D9D259:1F73FD2E |
after 27 game-seed steps |
| E1 leader, class 374, id 6, at (15184, 8106) | game 753AEBAB:6835FCDC; unit seed Init → 753AEBAB:0000029A |
|
E3 MonStatsInit |
unit seed 99308A27:2E5D6D76 |
two steps: the appearance pick and the HP draw |
| group size draw | leader’s unit seed 5E97AD79:3FE4EB60 |
monsters/spawn § F |
| member id 7 at (15186, 8103) | game D75F8773:30E55372; unit seed after MonStatsInit ADC8E500:5AC78601 |
|
| member id 8 at (15187, 8104) | game 0A8B3EF1:59D49BC4; unit seed E7B2DB43:612A2416 |
|
pass exit (PX) |
room D0F81837:1908F5BF, game 04994E9F:59583410 |
3. A gold drop
Section titled “3. A gold drop”The same log, lines 11896–11926: a class-101 monster dies with unit seed 3798A5AC:63BFE189, TC 475, item level 15;
the game seed at the drop is 8B0F9E11:1D78C39B (an input). [C]
| Step | Value |
|---|---|
| G1 NoDrop and pick | NDP 100, total 60; PICK range 160, roll 101 → item 523 (gld); quality 2; the dying unit’s seed at TCEND: 64701EE5:1730541A |
| G2 first game step | 348CF6B0:3A00542B → unit seed 348CF6B0:0000029A |
| G2 second game step | A15D299B:15EB20E3 → start A15D299B, item seed A15D299B:0000029A |
| G3 base stats | one unit-seed step → 675CD80A:15EB20E3; stat 14 (gold) = 31 |
| H | the normal builder, the staff mods, the ethereal and socket rolls: no draw on the item seed |
The next drop of the log (line 11928) starts from the game seed A15D299B:15EB20E3 the item left.
4. Two revisit re-creations and their marks
Section titled “4. Two revisit re-creations and their marks”CMRX) re-creates two class-5 records with request flags 0x62. [C]
| Record | Oracle 25’s input | Seeds | Logged marks, in order (pattern, mask) |
|---|---|---|---|
| id 276, alive | cell (5677, 5775), mode 1 | room DB237076:3AEDDC1B → 256AE4E2:12207A27 (three draws), game FC6719A9:52CF6906 → 5F4B3813:6946771A; unit seed 5F4B3813:0000029A → 5AC24825:5DE5631C |
mark (1, 0x100) twice; unmark (1, 0x100); mark (1, 0x100) |
id 277, dead (a10 12) |
cell (5678, 5766) | room → 52B82AA9:67398AA0, game → 4A654DB9:27BF0F49; unit seed 4A654DB9:0000029A → 992479AD:6540FD93 |
mark (1, 0x100); unmark (1, 0x100); 3×3 rectangle 0x8000; unmark (1, 0x100); unmark (5, 0x100); mark (5, 0x8000) |
Reimplementation notes
Section titled “Reimplementation notes”- The player’s walk is an input, not a detail. Two games from the same seed agree on every level seed and room
seed, but their game seed and
Odiverge as soon as rooms activate or populate in another order, or simulation creates a unit. [I] Ois one seed for the whole game, not one per room or per level. [C]- A room’s seed outlives its pass. A later request on that room’s tile (another room’s pass) draws from the seed the earlier pass left. [C]
- A re-created monster is a new unit for the seeds: a new game-seed step, a new unit seed and a new
MonsterInit, with only its id, class, cell, stats 13, 7 and 6 and its mods from the record. [C] - A re-created monster marks the grid like a pass creation, outside any window. Leaving its marks out fails later position tests: run 1’s two mismatches were exactly that. [C]
- The region append is chain state. A class that a creation outside the model appends to the level’s region rolls its sets then; a later creation of that class reads them. [C]