worldbuilding

Use when

You picked a theme and need to turn it into a world that holds together — enough lore to justify the mechanics, no more.

Worldbuilding Scaffold — the minimum viable world

What it is. A world is not a wiki. For a small deterministic game it’s a tight bundle: a premise, the rules that premise implies, the stakes that make a loss sting, and the fantasy the player is buying. Build the load-bearing minimum, then stop. Every sentence of lore should either justify a mechanic or raise the stakes; if it does neither, it’s decoration.

Player fantasy / why it’s fun. A coherent world makes the player fill in the rest. Give them a rule and a stake and they’ll imagine the history for free. Your job is the skeleton, not the encyclopedia.

The five load-bearing pieces

A world holds together when these five agree. Write one line each — that’s the whole doc for a small game.

PieceThe question it answersKept small by
PremiseWhat is the world and what just went wrong?One sentence. “The tide is rising and the lantern network is failing.”
Rules of the worldWhat’s true here that isn’t true elsewhere?2–3 rules max, each mapping to a mechanic
StakesWhat’s lost if you fail?Something concrete and small enough to feel
The player’s roleWho are you, and why is it your problem?A verb: keeper, mender, surveyor, forager
The fantasyWhat does the player get to feel?One clause; this is the sales pitch

The discipline: every rule of the world is a mechanic in disguise. If a lore rule has no mechanical echo, it’s flavour — fine in small doses, but it isn’t scaffolding. If a mechanic has no lore rule, the player will invent one; make sure it’s the one you want.

Vectors / options — how much world does the scope need?

Match lore weight to session shape (system-session-structure):

Game shapeWorld weightWhat you actually write
Single-screen puzzle / arcadeA premise lineOne evocative sentence; the mechanic is the story
Run-based (roguelite)Premise + 2 rules + a roleEnough for the loop to mean something across runs
Campaign / metroidvaniaFull five + a place-geographyRegions with identity; a why-here for each gate
Systemic / emergentPremise + rules that interactLean lore; the systems author the stories (system-emergent-systems)

More world is not better world. A good one-word title says almost nothing explicitly — the premise is in the name and the mechanics carry the rest.

Method

  1. Write the premise line. The world plus the disturbance — the thing that makes it a game and not a diorama. Inherit the register from world-theme-vectors.
  2. Derive 2–3 rules of the world from your mechanics, phrased as fiction. Mechanic “resources decay” → rule “nothing keeps in the salt air.” Mechanic “you can’t be everywhere” → rule “one keeper, many lamps.” Each rule is a promise the systems must keep.
  3. Set the stake. Name what failure costs in the fiction — and make it concrete and scaled to the loop, not “the world ends.” A drowned village reads; a fallen empire is abstract in a 5-minute run.
  4. Name the role with a verb. Keeper, mender, surveyor. The verb is the player’s fantasy and often the core mechanic’s name.
  5. State the fantasy in one clause. “The quiet competence of keeping the light on.” This is what the world-aesthetic-direction and pattern-juice-choreography must deliver on.
  6. Cut everything else. If a fact doesn’t back a rule, a stake, or the fantasy, it’s out of the scaffold. Let players imagine the rest.

Worked example

Premise: “A coastal shrine-network is drowning; the last keeper walks the path relighting lanterns before the dark and the tide close it.”

Three sentences of lore; three mechanics justified; one feeling to deliver. Anything more is a wiki.

Aesthetic hook

The Regalia register (REGALIA_DAY/REGALIA_NIGHT; see world-aesthetic-direction) is warm, weathered, and elegiac by construction — it rewards small, human stakes over cosmic ones. A world of one keeper and a drowning coast reads instantly in the ink line and a paper ground; a galactic-empire premise fights the intimacy the palette wants. Let the scaffold’s scale match the look: the house lean is small worlds with big feelings. The premise line doubles as the title/first-screen invitation the JUDGE scores for “invites” (chrome & finish).

Traps

Composes with

See also

This module rendersthe repo's markdowndirectly — edit it there, it changes here.