Repository navigation
Recipe Format
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).
| 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
|
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_m0 to 1000000). Latitude is linear in y: 60 at the north edge, 0 at the south edge by default. - Heights in
heights.pngare metres plus 10000. - A child's
parentis a path relative to the child folder, so move parent and child together. Absolute paths written by older versions still read. -
languageholds the sound pattern (C, V, F, S, N) used for the names; seenameson Commands.
| 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.
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.
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).
This wiki describes mapwright 0.24.0 (released 2026-11-16) and was last updated on 2026-11-16. mapwright is MIT licensed. Report problems in the issues.