Skip to content

Versions and Upgrading

m4bwav edited this page Nov 16, 2026 · 13 revisions

mapwright is not on a package registry. Releases are tags and GitHub releases on m4bwav/mapwright; to upgrade, pull the repository (or reinstall the plugin) and check out the tag. Details per release are in the CHANGELOG.

Releases

Version Tagged Adds
0.24.0 2026-11-16 `aistyle --control canny
0.23.0 2026-11-16 gen dungeon --method blocks --corridor N (Generate places)
0.22.0 2026-11-16 gen dungeon --method cyclic --corridor N (Generate places)
0.21.0 2026-11-16 gen dungeon --corridor N: corridors N squares wide for wide bodies (Generate places)
0.20.0 2026-11-16 path --agent N: routes for a body N squares wide (Paths and travel)
0.19.0 2026-11-16 export --nav --agent N: walkable squares eroded for a body N squares wide (Export)
0.18.0 2026-11-16 gen region --chunk COL,ROW [--chunk-km 250]: one chunk of a world with its own stable seed (Generate worlds)
0.17.0 2026-11-16 Per-place seeds: gen sector --systems writes systems/<hex>/ per world; gen system --sector-seed S --hex H makes one alone, byte-identical (Generate space)
0.16.0 2026-11-16 The ink-and-parchment style carries period=1600, so check --style ink-and-parchment runs the period lint unasked (Proof bars)
0.15.0 2026-11-16 check --period YEAR with --period-kind and --uses: a period lint that fails conventions younger than the year (Proof bars)
0.14.0 2026-11-16 ports ranked by harbour quality (shelter, depth, river mouth, size); at most a quarter of settlements become ports, and check bar 14 also fails over that cap (Proof bars)
0.13.0 2026-11-16 gen dungeon --method blocks (exit-matched block grid, two new check bars); a settlement is a port only when it touches open sea, with a new check bar 14 (Generate places, Proof bars)
0.12.0 2026-11-16 battle maps put the title above the grid and the legend below it, so no square is hidden; legend works on battle maps; --branches treasure always inside its room; all-land zoom windows get rivers (Generate places, Generate worlds)
0.11.0 2026-11-16 path honours locks and keys (--ignore-locks), path --jps, export --nav, gen battle --density and a legend of what is on the map, gen dungeon --branches (Paths and travel, Generate places)
0.10.3 2026-11-16 --version, doctor and tool_version print the real version again
0.10.2 2026-11-16 skill description and evals only; no script changes
0.10.1 2026-11-15 render --title on city, dungeon and battle maps; the space byte-identical bar ignores extra files in the folder
0.10.0 2026-11-15 path, path --field, travel, check --chokepoints, check --fair (Paths and travel)
0.9.0 2026-11-15 dungeon entrance and goal, cave flags, --method cyclic, check --range; geoBoundaries licences per file
0.8.0 2026-11-15 aistyle (Commands)
0.7.0 2026-11-15 export to engines, Tiled, mesh and print (Export)
0.6.0 2026-11-15 gen sector, gen system, gen planet, gen deck (Generate space)
0.5.0 2026-11-15 gen city, gen dungeon, gen battle, Universal VTT (Generate places)
0.4.0 2026-11-15 find, fetch
0.3.0 not tagged read, trace
0.2.0 not tagged gen world, gen region, zoom, check, names, render, label, legend, style, serve, sheet
0.1.0 not tagged doctor, explain, inspect, convert, measure, project

--version says 0.10.0

Fixed in 0.10.3. The v0.10.1 and v0.10.2 tags print 0.10.0 from --version and doctor, and write 0.10.0 as tool_version in new recipes: the VERSION constant in scripts/mpw.py was not bumped. plugin.json says 0.10.2. Use the tag, not --version, to tell those three apart.

From 0.23.0 to 0.24.0

Nothing changes unless you pass aistyle --control.

From 0.22.0 to 0.23.0

Nothing changes unless you pass --corridor above 1 with --method blocks.

From 0.21.0 to 0.22.0

Nothing changes unless you pass --corridor above 1 with --method cyclic.

From 0.20.0 to 0.21.0

Nothing changes unless you pass gen dungeon --corridor N with N above 1; such maps have no doors.

From 0.19.0 to 0.20.0

Nothing changes unless you pass path --agent N with N above 1.

From 0.18.0 to 0.19.0

Nothing changes unless you pass --agent; --agent 0 is refused.

From 0.17.0 to 0.18.0

Nothing changes unless you pass --chunk: --window regions give the same files.

From 0.16.0 to 0.17.0

Nothing changes unless you pass --systems or --sector-seed: old sector and system seeds give the same files. --seed and --sector-seed on gen system are alternatives; --hex is a four-digit hex such as 0118.

From 0.15.0 to 0.16.0

check --style ink-and-parchment now adds the period bar. A recipe in that style that uses a convention younger than 1600 (Mollweide, Robinson, elevation tints) fails where it passed on 0.15.0; check it with another style or change the projection. Other styles are unaffected.

From 0.14.0 to 0.15.0

Nothing changes unless you pass --period: every example in this wiki printed the same on v0.15.0 apart from the version lines and timings.

From 0.13.0 to 0.14.0

Every example in this wiki printed the same on v0.14.0 apart from the version lines, timings and bar 14 of the world check output:

  • Fewer ports: open-coast settlements are ranked by harbour quality and only the best quarter (rounded up) become ports. Over 24 test worlds the port share fell from 0.889 to 0.261. The isles-south.map example now has 6 ports, not 16.
  • check bar 14 also fails when ports exceed the cap; its text adds "at most 25% of settlements". Bar numbers are unchanged.

From 0.12.0 to 0.13.0

Every example in this wiki printed the same on v0.13.0 apart from the version lines, timings and the world check output:

  • check on a world or region has a new bar 14, every port touches open sea, so the label bars move from 14, 15, 16 to 15, 16, 17 and check prints 17 bars. Scripts that read bars by number need the new numbers.
  • Ports: open sea is now the sea flooded in from the map border (a zoom window takes it from its parent). A town on a lake or an enclosed sea pocket is no longer a port. On seed 7 every other file is byte-identical to 0.12.0.
  • gen dungeon --method blocks is new; bsp, cave and cyclic output is unchanged.

From 0.11.0 to 0.12.0

Every example in this wiki printed the same on v0.12.0 apart from the version lines and timings. Two outputs change on purpose:

  • A zoom window with no sea in it (an all-land grandchild) now drains to the border cells where the parent's rivers leave, so it gets rivers and passes bar 1. Worlds and windows that hold sea are byte-identical to 0.11.0 (seeds 1 to 8 checked).
  • Battle map pictures are taller: the title and legend moved out of the grid into bands above and below it. The recipe and the grid are unchanged.

From 0.10.x to 0.11.0

Two defaults changed; everything else in the wiki's examples printed the same on v0.11.0 (only the version lines, three new explain terms and timings differ):

  • path on a cyclic dungeon now fetches each key before its lock, so the route can be much longer. On keep.map (seed 3) from the entrance 10,32 to the goal 17,17 it is 123 steps where 0.10 gave 21; --ignore-locks gives the old route.
  • gen battle defaults to --density normal, more features than before, so a seed's battle map differs from 0.10. --density sparse is the old map: gen battle --seed 2 --grid square --density sparse prints the same 48 wall runs as 0.10's default, where the new default prints 52.

gen dungeon --method cyclic without --branches is byte-identical to 0.10.

From 0.2.0 to 0.10.2

Nothing a 0.2.0 user ran has changed its output. The wiki's 0.2.0 examples, run again on v0.10.2 on 2026-11-16 and compared with the output saved on 2026-11-14, differ only in:

  • the version line of --version and doctor;
  • four new doctor lines (pillow, tesseract, export, aistyle);
  • five new explain terms (bleed, crop-marks, heightmap, tmj, uvtt);
  • timings.

gen world --seed 7 still gives 15876 cells, 48 rivers, 22 lakes, 81 settlements, 94 roads and 162 names, and check on its zoomed child still prints the same 16 bars.

Dungeons made before 0.9.0

0.9.0 gave every new dungeon an entrance-to-goal layout. Recipes without params.goal (0.7.0 and older) are rebuilt the old way, so they still regenerate byte for byte. The repository keeps two such recipes as fixtures; on v0.10.2 both pass check, including the byte-identical bar, and skip the goal bars:

python scripts/mpw.py check tests/fixtures/dungeon-070-bsp
bar 1 PASS: dungeon: every floor square reachable from the entrance (163 of 163 passable squares reached)
bar 2 PASS: dungeon: every room reached, none overlap (2 rooms, 0 unreached, 0 overlapping pairs)
bar 3 PASS: dungeon: every door reached and joins two floors (2 doors, 0 bad)
bar 4 PASS: dungeon: walls closed (every wall end meets another) (12 wall runs, 0 loose ends)
bar 5 PASS: dungeon: grid on whole pixels (map.png 192x128 = 24x16 squares x 8 px)
bar 6 PASS: uvtt: loads, pixels_per_grid a whole number (ppg 8, 12 walls, 2 portals, 2 lights)
bar 7 PASS: uvtt: walls inside the image (12 walls, 0 points outside 24x16)
bar 8 PASS: uvtt: every door ends on a wall (0 door ends off a wall)
bar 9 PASS: uvtt: image matches the grid (192x128 px for 24x16 squares at 8)
bar 10 PASS: uvtt: colours alpha first, doors closed, no wall over a door (0 colours not ffRRGGBB, 0 portals not closed, 0 doors under a wall)
bar 11 PASS: same seed gives byte-identical files (7 files identical)
bar 12 PASS: labels: none overlap (2 labels, 0 overlapping pairs)
bar 13 PASS: labels: none cut by the edge (0 cut)
bar 14 SKIP: labels: read back by OCR (skipped: tesseract not found (install it to run this bar))

Space folders with renders in them

Before 0.10.1 a render saved inside a sector, system, planet or deck folder failed that folder's byte-identical bar. Since 0.10.1 the bar compares only the files gen writes.

Child regions made before 0.2.0's relative paths

A child stores its parent's path relative to itself. Absolute paths written by older versions still read.

Clone this wiki locally