Open the books

RAW FILE: LEVEL-CONTRACT.md, as written during the jam

Source prep/LEVEL-CONTRACT.md in the jam repo. Last git commit of this file: 2026-11-11. About 1,090 words. Scrubbed only for private details and one line about another entrant. Mistakes left in on purpose.

Level design contract (template)

Agents load this file first, every time they build or change a level. Fill in the metrics once the game exists and keep the file in step with the game. Generic on purpose: no theme, no game design. The purpose and relationships of each space come from the task, not from here.

All values are centimeters and Unreal units unless noted. Rows marked DEFAULT come from the UE5 Third Person template (Manny capsule) and are placeholders until the game's own value replaces them.

1. Metrics

MetricValueStatus
Player capsule radius34DEFAULT (Third Person, Manny)
Player capsule half height88 (full height 176)DEFAULT
Eye height above floorabout 160 (camera at capsule top minus a little)DEFAULT, set the real camera height
Walk speed500DEFAULT (template CharacterMovement max walk speed)
Run speednone in the template; set oneTO FILL
Jump heightabout 120 (JumpZVelocity 700, gravity 980)DEFAULT, measure in game
Jump distance (flat, at full speed)about 400 to 500DEFAULT, measure in game
Max step height45DEFAULT (CharacterMovement)
Walkable floor angle44.765 degreesDEFAULT
Door widthcapsule diameter 68 plus margin; use 120RULE, confirm
Door height230RULE, confirm
Corridor width200 for two-way, 120 minimum one-wayRULE, confirm
Stair rise (per step)17RULE, must be under max step height
Stair run (per step)28RULE
Railing height100RULE
Minimum clearance (overhead)capsule height plus 30, so 206RULE
Minimum clearance (sideways)capsule radius plus 20 each side, so 54RULE
Cover height (crouch)100RULE, set with the game's crouch height
Cover height (standing)190RULE
Third person camera distance300 (spring arm)DEFAULT
Third person camera collision probe12DEFAULT
Grid snap50 for blockout, 10 for detailRULE

Rows marked RULE are common practice values for a human-scale character, not engine defaults. Replace any that the game's design contradicts, and record the change and the date at the bottom.

2. Working rules

  1. Describe the space by its purpose and its relationships (what connects to what, what the player must see from where). Leave the rest open; propose and then verify.
  2. Block out from primitives (cubes, planes, cylinders from the engine) at the real metrics above. Do not place final assets until the blockout passes the checklist.
  3. After each step, capture and inspect with prep/scripts/scene_capture.py (top-down, four corners, eye height). Do not use the user's editor viewport.
  4. Name actors for what they are (Door_Hall_To_Cellar, Wall_North_01) so gaps and clearances can be queried by name.
  5. Use whole numbers on the grid. Place doors and stairs by their metric, not by eye.
  6. Save the level after each passing step, one file, small commits.

3. Checklist (run it after every step; record pass or fail with the number)

Clearances

Reachable routes

Sightlines

First 60 seconds of the player path

Player-scale review (several angles)

4. After the level is built

Write what worked and what failed into the jam lessons (see the Level building section of prep/agent-rules/UNREAL-AGENT.md), so it can become a skill.

Change log

Source

The workflow (blockout through MCP, inspect and correct, furnish, own-camera captures, a reusable contract, learnings kept as skills) follows Epic's "Exploring AI-assisted level design in Unreal Engine" (Chris Cook, Nov 11, 2026).