Skip to content

Recipe Format

m4bwav edited this page Nov 16, 2026 · 3 revisions

Every gen command and zoom write a folder, the recipe. This page details worlds and regions; the other kinds are listed at the end. Every other command reads only these files, so a folder can be zipped, moved and rendered elsewhere. The same recipe gives byte-identical files on every run (Proof bars, bar 4).

World and region files

File Holds
recipe.json kind (world or region), seed, generator and tool version, parameters, projection, height encoding, extent, parent path, the naming language
features.geojson coast, rivers, lakes, settlements, roads and named places, each with a kind property
heights.png + heights.pgw a 16-bit greyscale heightmap and its world file
mesh.json the cell mesh: positions, heights, flow, rivers, lakes, temperature, rain, biome
names.json the seed, the language and every name
sources.json data used and credit lines; a generated world says nothing was fetched
map.svg a quick drawing written by gen

recipe.json

From gen world --seed 7 --style nordic (first keys):

{"kind":"world","seed":7,"generator":"gen-1","tool":"mapwright","tool_version":"0.11.0","params":{"cells":16000,"cells_actual":15876,"spacing_km":7.936507936507937,"plates":12,"erosion_steps":15,"lat_top":60.0,"lat_bottom":0.0}}
  • Coordinates are local metres, x east and y north, over a 1000 km square (extent_m 0 to 1000000). Latitude is linear in y: 60 at the north edge, 0 at the south edge by default.
  • Heights in heights.png are metres plus 10000.
  • A child's parent is a path relative to the child folder, so move parent and child together. Absolute paths written by older versions still read.
  • language holds the sound pattern (C, V, F, S, N) used for the names; see names on Commands.

features.geojson kinds

kind geometry properties besides kind
coast LineString none
river LineString id, acc (flow), stem, name, cells
lake MultiPolygon id, name, cells, outlets, level_m
settlement Point id, rank (city, town, village), name, cell, score
road LineString id, rank (major, minor), cells, from, to
ocean, sea, land, range Point (label anchor) id, name, cells, anchor

Seed 7 at 16000 cells has 94 roads, 81 settlements, 48 rivers, 22 lakes, 6 coast lines, 5 ranges, 3 seas, 2 landmasses and 1 ocean.

world file

heights.pgw for that world:

1953.125000
0.0
0.0
-1953.125000
976.560000
999023.440000

The last two lines are the centre of the top-left pixel, half a pixel in from the corner.

Other kinds

From the runs on Generate places and Generate space (ls of each folder right after gen):

Kind Files
city features.geojson, map.svg, names.json, recipe.json, sources.json
dungeon, battle features.geojson, grid.json, map.png, map.svg, names.json, recipe.json, sources.json
sector map.svg, names.json, recipe.json, sector.json, sector.tab, sources.json
system map.svg, names.json, orbits.svg, recipe.json, sources.json, system.json
planet map.svg, planet.json, recipe.json, sources.json, texture.png
deck deck.json, map.svg, names.json, recipe.json, sources.json

grid.json holds the grid and, since 0.9.0, the entrance and goal; deck.json holds each deck as rows of characters (# wall, . floor, + door, L lift, A airlock, blank for outside). path, travel, check --chokepoints and check --fair add their own files to the folder (path.json, path.geojson, path.svg, field.json, travel.json, chokepoints.json, fair.json); check --range writes to a new folder such as range-bsp.

tool_version in recipe.json is 0.10.0 for recipes made by v0.10.1 and v0.10.2; from v0.10.3 it matches the tag (Versions and upgrading).

Clone this wiki locally