Skip to content
m4bwav edited this page Nov 16, 2026 · 15 revisions

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.

What it does

  • 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.

Pages

Version

The wiki describes the v0.24.0 release (2026-11-16). See Versions and upgrading.

Clone this wiki locally