Skip to content
SPECIFICTION
Get listed

Tectonicus

github.com

Free plan WindowsmacOSLinux
Visit github.com
Spec score 7.7 #10 of 22 in Minecraft World Map Viewers

What it is

Tectonicus generates a detailed, zoomable map from a Minecraft Java world by building a 3D model and rendering map images. Its stated aim is to make maps resemble what players see in Minecraft. It runs on Linux, macOS, and Windows; maps can be viewed offline or served from a web server. Setup involves downloading a release, preparing an XML configuration file, and running the program from the command line with Java. Later runs using the same options are quicker after the initial render because only changed tiles are rendered. Players can filter which signs appear, and signs marked with #view can create first-person views with configurable height, angle, field of view, and nighttime rendering. Release 2.31 supports Minecraft 1.21 through 1.21.11, but not Minecraft 26.1. It also adds rectangular world subsets and arm64 LWJGL libraries for M-series Macs and possibly other ARM systems. Generated images can consume gigabytes of disk space depending on world size; WebP or JPG output and closestZoomSize can reduce storage use. Copper golem statues do not work, and shelves render only partially.

Spec sheet

Purpose
Tectonicus generates a 3D model of a Minecraft Java world and uses it to create detailed, zoomable maps.Read 7 Oct 2026 · github.com
License
The repository provides Tectonicus under the BSD 3-Clause license.Read 7 Oct 2026 · github.com
Maker
The repository copyright notice names John Campbell and Tectonicus contributors.Read 7 Oct 2026 · github.com
Architecture support
Release 2.31 adds arm64 LWJGL natives for M-series Macs and possibly other ARM platforms.Read 7 Oct 2026 · github.com
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.Read 7 Oct 2026 · github.com
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.Read 7 Oct 2026 · github.com
Incremental rendering
After the first run, subsequent runs with the same options are significantly quicker because only changed tiles are rendered.Read 7 Oct 2026 · github.com
Mac support
Release 2.31 added arm64 LWJGL native libraries for M-series Macs and possibly other ARM platforms.Read 7 Oct 2026 · github.com
Map appearance
The project describes its focus as maps that look very close to what players see in Minecraft.Read 7 Oct 2026 · github.com
Map subsets
Release 2.31 adds rectangular world subsets alongside circular subsets.Read 7 Oct 2026 · github.com
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.Read 7 Oct 2026 · github.com
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.Read 7 Oct 2026 · github.com
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.Read 7 Oct 2026 · github.com
Rendering limits
Release notes say copper golem statues are currently not working and shelves only partially render.Read 7 Oct 2026 · github.com
Sign filtering
By default, Tectonicus displays every sign players place, and a special filter can restrict which signs appear.Read 7 Oct 2026 · github.com
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.Read 7 Oct 2026 · github.com
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.Read 7 Oct 2026 · github.com
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.Read 7 Oct 2026 · github.com

Plans and prices

Tectonicus Free No price stated · generates large amounts of image data that may use gigabytes of disk space Read 7 Oct 2026 · github.com

Every Tectonicus plan and price →

Strong points and limits

Strong points

  • Renders zoomable maps from Minecraft Java worlds.
  • Later runs render only changed tiles.
  • Sign filters can restrict displayed signs.
  • Supports offline viewing and web serving.

Limits

  • Minecraft 26.1 is not supported yet.
  • Output can use gigabytes of disk space.
  • Copper golem statues do not work.
  • Shelves render only partially.

Who it suits

Tectonicus suits Minecraft Java players who want detailed world maps, including sign-based first-person views or maps served from a web server. It is also a fit for users comfortable with command-line setup and Java.

Verdict

Tectonicus offers configurable rendered maps, with faster follow-up runs and multiple viewing options. Check Minecraft compatibility and potential storage use for your world before running it.

Where Specifiction places it

Alternatives to TectonicusAll alternatives →