Repository navigation
Home
mapwright is an agent plugin for maps of real places, fantasy worlds and science fiction settings. It reads, writes, finds and generates maps, exports them to game engines, tabletops and print, and checks its own numbers against published values.
It is one skill for AI coding agents plus one script, scripts/mpw.py, that needs nothing but Python 3.9 or later. numpy, shapely, pyproj, GDAL, geographiclib, Pillow and tesseract are optional; Chrome or Edge is needed only for PNG and PDF output; aistyle needs your own ComfyUI server.
- Read: what a GeoJSON, GPX, KML, KMZ, shapefile, dBASE, PNG heightmap, GeoPackage or MBTiles file holds; what a map picture shows, and its georeference from control points; a picture traced back to GeoJSON.
- Write: convert between GeoJSON, GPX and KML; measure geodesic distance, area and scale; project points in six projections.
- Find: open maps and data for a place, time or subject, each with its licence and credit line, and one polite download at a time.
- Generate: worlds and child regions; cities, dungeons and battle maps; star sectors, systems, planet textures and ship decks. Each is a recipe folder that regenerates byte for byte from its seed.
- Route: cheapest paths, Dijkstra fields, travel times by Tobler's hiking function, chokepoints and fairness of starts.
- Export: Unity, Unreal, Godot and Roblox heightmaps, Tiled maps, Universal VTT, a terrain mesh, print PDF and PNG with bleed, a planet sphere texture, a T5 sector file.
- Render: a recipe to SVG, PNG or PDF in six looks, with labels that never overlap; optionally repainted by an AI model that keeps the coast.
- Getting started: install, the first world, the first render.
-
Commands: every
mpw.pyverb, with real output for the ones not covered below. -
Generate worlds, Generate places, Generate space: the
genkinds. - Export: every export target with its read-back bars.
-
Paths and travel:
path,travel,check --chokepoints,check --fair. - Recipe format: the files in a recipe folder.
- Styles: the six looks and the AI looks.
-
Proof bars: what
checkand the exports prove, and the numeric bars the tests hold. - Versions and upgrading: every release and what changed for you.
- FAQ
The wiki describes the v0.24.0 release (2026-11-16). See 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.