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

Does it need any packages?

No. Python 3.9 or later is enough. numpy, shapely, pyproj, GDAL, geographiclib, Pillow and tesseract are used when present and reported by doctor. PNG and PDF output (render and print export) need Chrome or Edge; without one, render to .svg. aistyle needs your own ComfyUI server.

Why does measure distance take latitude first?

It follows the order people write coordinates in. GeoJSON and KML store longitude first, and Leaflet takes latitude first. Test with a point whose swap lands in the sea.

Can I measure area in Web Mercator?

No. Web Mercator inflates area toward the poles and stops at about 85.0511 degrees. measure area works on the ellipsoid.

The file has no CRS. What does inspect assume?

Nothing. It prints not stated. A world file never carries a CRS.

Why were some labels dropped?

A label with no free spot is dropped and listed by label, never squeezed in or allowed to overlap. Fewer settlements per area, a bigger render or a narrower font (--font) leave more room.

The OCR bar says SKIP. Did it pass?

No. SKIP means tesseract is not installed, so the read-back did not run.

Can islands share a road network?

Not yet. There are no ferries, so each landmass gets its own roads, and path on a world cannot cross the sea.

Is serve safe to run?

It binds to 127.0.0.1 only and serves the rendered page of one folder.

Can it fetch real data, like OpenStreetMap?

Since 0.4.0, yes: find names open sources with their licence and credit line, and fetch downloads one file politely and writes sources.json and CREDITS.txt beside it. It refuses the never-scrape list and whole-planet sets. See Commands.

Can it map my codebase or draw a choropleth?

No. Code maps are evergreen-map's job and data-driven maps such as choropleths are chartwright's; mapwright can supply the boundaries as GeoJSON.

--version prints 0.10.0 but I checked out v0.10.2. Which is it?

v0.10.2. The version constant was not bumped for 0.10.1 or 0.10.2; plugin.json has the right number. Fixed in 0.10.3: v0.10.3 and later print their own version. See Versions and upgrading.

Which engine heightmap orientation does Unity expect?

Not verified. mapwright writes the north row first; --flip writes south first. Try one and look at a known feature.

Can I put a hex battle map on Foundry?

Not as Universal VTT: the format has no hex walls, so hex maps export as PNG only. Square battle maps and dungeons export as .dd2vtt and .tmj.

Why is my world path from A to B cheaper than from B to A?

World and region routes reuse the road router's cost, which charges slope and terrain on the cell entered, so uphill and downhill cost differently.

Does aistyle send my map anywhere?

Only to the ComfyUI server you name with --host or MAPWRIGHT_COMFYUI; there is no default address. --dry-run contacts nothing.

inspect says my traced GeoJSON is WGS84. Is it?

Not unless you georeferenced it. inspect reports GeoJSON's RFC 7946 default for every GeoJSON file; trace without --gcp or --world writes pixel coordinates and says "coordinates": "pixel".

Clone this wiki locally