M1-25: the DebugWorld village

Issue #120. Decisions 2026-11-08 "Every M1 site moves onto one street now" and "The playtest town is a 1989 Everon village with a test annex" (decisions). The maintainer gave M1-25 authority to rebuild DebugWorld, not shuffle it.

What DebugWorld is today

Forty layers on a flat 512 m square (every heightmap sample is 0) covered in the white grid texture. Sites are tables with an NPC, a kerosene lamp, and a blue EL_DebugAreaBoundary box that spawns survey poles at its corners. They sit in two clusters: feature stations at x 94..182, z 120..151, and the roadmap row at z = 120, x 186..243, with entities 3 m apart and no buildings except one garage shell. Nothing tells a stranger where they are.

Inventory and classification (every layer):

The village

One main street runs east-west at z = 250 from the square (x 95) to the edge of the village (x 400), then a dirt track runs on to a barn. North-side buildings face south, south-side buildings face north; every front sits 8 m from the centre line, which leaves a 4.5 m verge for counters and desks between the asphalt and the facade. Interactables stand in front of their building (a counter on the porch, an ATM on the bank wall), not inside: floor heights and interior walls of vanilla buildings cannot be checked without the renderer, and a counter on the porch is reachable from the street.

Arrival order, west to east (numbers match the map):

Outskirts: the farm north of the square (farmhouse, barn with the apple juicer, orchard with AppleGatherTree and PlumGatherTree, tomato field and greenhouse), the quarry and builders' yard south of the street (mining area, furnace, cement, gravel, sand), and the forest edge east (lumberjack, cuttable trees, sawmill). Each chain layer moves as a block, so its internal layout, already validated, does not change.

Test annex: a net-fenced yard at x 20..112, z 20..112, reached by a dirt track from the square. It holds Tests.layer, PRFeatures.layer, and the legacy debug stations with their boundaries, and it covers the open ground where the world tests spawn their fixtures (60 0 60 to 90 0 91, 48 0 64). Nothing else stands there.

Ground and light: the terrain material (Assets/World/GridSurface.emat, ours) becomes the vanilla lawn surface (GrassLawn_01, grass sound) without clutter, so grass does not grow through roads and floors. Roads are vanilla road generators saved as RoadEntity splines (asphalt street, cobbled square and alley, dirt lanes, asphalt lot), the format Overthrow's test island uses. Street lamps stand on the verges between sites.

New layers: Village_Roads, Village_Buildings, Village_Dressing, Annex.

What moves with it

• EL_SpawnLocation positions (town, mine, station, outpost) follow the spawn points.
• QuestGiver_Start intro area objective centre follows the clerk.
• Tests that pin positions: EL_Test_ExploitGuardsWorld (clerk "near" point, depot workplace point).
• agent-box/harness.mjs selftest pins the old garage, escort car, and z = 120 row; it checks the new layout instead. The roadmap report's 30 m street rule exempts the contraband pickup, which is out of town by design.
• validate-debugworld-layout only asks a table to sit inside a boundary when its layer has one.
• docs/features.md and docs/playtest.md site locations.

Nothing is renamed. The vehicle lot's pad offset changes from 0 0 8 to -5 0 -5 so bought cars land on the lot, and the convoy markers stop being EL_DebugAreaBoundary entities (no corner poles) and become crates with the same components.

Proof

Server side: tools\cli validate, tools\cli test --no-build --tier all, node agent-box/harness.mjs selftest. Rendering side: agent-box screenshots and a filmed walk from the square to the barn, checked by eye for floating or sunken props, white meshes, buildings facing the wrong way, and roads.

What the rendering pass found (2026-11-08)

Checked from a dedicated-server client on the hidden desktop (agent-box/session.mjs up, harness.mjs --client 1 shot world):

• Building fronts: a vanilla building's door side is its local +Z. Every street building shows its entrance to the street.
• Roads: asphalt, cobblestone, and dirt RoadEntity splines render. The concrete-panel and gravel-trail generators did not (the apron drew a stray X), so the lot and fuel apron are asphalt and the market ground is dirt.
• HayBale_01 rendered as a white sphere; it is not used.
• The vault, breach, jail, and hideout doors read as a back door, a yard gate, a cell door, and a yard gate.
• NPCs at the stalls and desks stand in underwear on the dedicated client. In Workbench play the same NPCs wear uniforms. Not investigated here; filed as #150.

Evidence: the film-evidence release assets pr137-m1-25-*.png.