Tectonicus
github.com
- Free plan
- Windows
- macOS
- Linux
What Tectonicus is
Tectonicus generates a 3D model of a Minecraft Java world and uses it to create detailed, zoomable maps intended to resemble the view players see in the game. It supports Linux, macOS and Windows, and can produce maps for different dimensions with markers and waypoints. To run it, download a release, prepare an XML configuration file and launch it from the command line with Java. After the first render, later runs with the same options are significantly quicker because only changed tiles are rendered. Players can configure which signs appear; by default, every placed sign is shown. Signs marked with #view can add first-person map views with configurable height, angle, field of view and nighttime rendering. Maps can be viewed offline or served from a web server. Image output can consume gigabytes of disk space depending on world size; the README suggests WebP or JPG and closestZoomSize to reduce storage use. Release 2.31 lists Minecraft 1.21 through 1.21.11 as compatible, but not Minecraft 26.1. Copper golem statues currently do not work, and shelves render only partially.
Who it suits
Tectonicus suits Minecraft Java players who want detailed maps of their worlds, including configurable sign-based viewpoints. It may also suit people comfortable running a command-line application with Java and preparing XML configuration.
Good to know, and what to watch
- Generates zoomable maps from Minecraft Java worlds.
- Later renders update only changed tiles.
- Can add first-person views from marked signs.
- Maps support offline viewing and web serving.
- BSD 3-Clause licensed.
- Minecraft 26.1 is not yet supported.
- World images may use gigabytes of disk space.
- Copper golem statues currently do not work.
- Shelves render only partially.
Plans
Every plan and priceTectonicus
Free plan
Getting started
- Download a Tectonicus release
- Create an XML configuration file
- Install or use Java to run the program
- Launch Tectonicus from the command line
- Choose output and map options such as WebP or JPG, closestZoomSize, and sign filtering
- Serve the generated map from a web server or view it offline
Limits to check
Generated map images can require gigabytes of disk space depending on world size. Minecraft 26.1 is unsupported, copper golem statues do not work, and shelves render only partially.
The verdict
Tectonicus offers detailed world maps and configurable views, with quicker repeat renders after the initial build. Check its Minecraft compatibility and potential storage needs before generating a large map.
Questions people ask
What does Tectonicus cost?
Tectonicus has a free plan listed as free.
Which operating systems are supported?
It supports Linux, macOS, and Windows.
Which Minecraft versions are supported?
Release 2.31 lists compatibility with Minecraft 1.21 through 1.21.11. Minecraft 26.1 is not yet supported.
How do I run it?
Download a release, create an XML configuration file, and run Tectonicus from the command line with Java.
Can maps be viewed offline or served online?
Yes. Maps support offline viewing and can be served from a web server.
How much storage can output require?
Generated images may use gigabytes of disk space depending on world size. WebP or JPG output and closestZoomSize can reduce storage use.
What the maker publishes
- Architecture support
- Release 2.31 adds arm64 LWJGL natives for M-series Macs and possibly other ARM platforms. source
- First-person views
- Signs marked with #view can create first-person views in the map, with configurable height, angle, field of view, and nighttime rendering. source
- How to run
- The README instructs users to download a release, create an XML configuration file, and run Tectonicus from the command line with Java. source
- Incremental rendering
- After the first run, subsequent runs with the same options are significantly quicker because only changed tiles are rendered. source
- License
- The repository provides Tectonicus under the BSD 3-Clause license. source
- Mac support
- Release 2.31 added arm64 LWJGL native libraries for M-series Macs and possibly other ARM platforms. source
- Maker
- The repository copyright notice names John Campbell and Tectonicus contributors. source
- Map appearance
- The project describes its focus as maps that look very close to what players see in Minecraft. source
- Map subsets
- Release 2.31 adds rectangular world subsets alongside circular subsets. source
- Map views
- It can generate first-person views from sign locations and insert them into the map, with configurable height, angle, field of view, and nighttime rendering. source
- Minecraft compatibility
- The 2.31 release states compatibility with Minecraft 1.21 through 1.21.11 and says Minecraft 26.1 is not yet supported. source
- Minecraft support
- The latest release notes list compatibility with Minecraft 1.21 through 1.21.11 and say Minecraft 26.1 is not supported yet. source
- Purpose
- Tectonicus generates a 3D model of a Minecraft Java world and uses it to create detailed, zoomable maps. source
- Rendering limits
- Release notes say copper golem statues are currently not working and shelves only partially render. source
- Sign filtering
- By default, Tectonicus displays every sign players place, and a special filter can restrict which signs appear. source
- Storage requirements
- Generated images can use gigabytes of disk space depending on world size; the README says WebP or JPG and closestZoomSize can reduce this. source
- Storage use
- Map image output can use gigabytes of disk space depending on world size; the README suggests WebP or JPG and closestZoomSize to reduce it. source
- Web map behavior
- Release 2.30 says chest inventory tooltips work when the map is served from a web server or when browser CORS is disabled. source
Checked against the maker's pages on 7 Oct 2026.