Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

Tectonicus

github.com

  • Free plan
  • Windows
  • macOS
  • Linux
7.5 Club score Visit github.com

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.

Tectonicus

Free

Free plan

Getting started

  1. Download a Tectonicus release
  2. Create an XML configuration file
  3. Install or use Java to run the program
  4. Launch Tectonicus from the command line
  5. Choose output and map options such as WebP or JPG, closestZoomSize, and sign filtering
  6. 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.