Tutorials/Programs and editors/Tectonicus



Tectonicus is a 'deep' minecraft map renderer written in java. It has fewer dependencies than similar programs such as Overviewer. Instead of plotting blocks as pixels it generates a 3D model of your map and uses that to draw zoomable maps with a high level of detail. Instead of producing a single image it creates lots of map tiles as well as a HTML file to let you view it using the Google maps interface.

Features

 * Runs on Windows, OSX and Linux if X or Xvfb is installed
 * Can map single and multiplayer worlds
 * Can use custom texture packs
 * An icon is used to mark the spawn point. Clicking it shows statistics about how many blocks of each type exist in your world
 * Shows sign positions on map, and shows sign text when clicked (blank signs are not rendered as they are usually used for decorations such as chairs)
 * Creates player markers by using player's custom skins. Shows their health and other stats
 * Caches results so that drawing the same map again only updates the changed areas
 * Lots of options to control zoom level, camera angle and output format
 * Can output in either png, jpg or gif image formats
 * Day, night, and cave drawing modes
 * Antialiasing for high quality output

If you have a feature request, then please submit it at the Tectonicus feedback page.

Example map
View the example map

Usage
Download the jar file and save it to your computer. If your computer tries to open it as a zip file then right click and use 'save target as...'.

Then run this at the command line:

java -jar Tectonicus_v1.0.jar

(Remember to change the version number to match the file you downloaded). This will print out all the available options.

If 'java' is not set as the environment variable, then you probably need to execute Tectonicus with the full path to java.exe:

"C:\Program Files\Java\jre6\bin\java.exe" -jar Tectonicus_v1.0.jar

When running on 64 bit OS, use force64BitNatives=true to avoid 'out of memory' errors:

"C:\Program Files\Java\jre6\bin\java.exe" -jar Tectonicus_v1.0.jar force64BitNatives=true

To map a single player world, all you need to do is:

java -jar Tectonicus_v1.0.jar worldDir=1 outputDir=C:/MyMap

This will map your singleplayer world 1 and output it to C:/MyMap. Change the number to map different single player worlds.

To map a multiplayer world then make worldDir point to your 'world' directory (the one containing level.dat). Something like:

java -jar Tectonicus_v1.19.jar worldDir=C:/MinecraftMultiplayer/world

See the Tutorials for specific and additional instructions.

Cron jobs
In order to run Tectonicus at a specified time on a Linux/Unix machine you will need to add DISPLAY=:0 or DISPLAY=:0.0 for multiple monitor setups to your cron job.

Command Line Arguments
As of version 2.00 command line arguments have been deprecated in favor of an XML configuration file.

Please Donate!
If you like Tectonicus, why not donate to charity? If you do then you'll get a 'supporter' badge on your player's info popup in all Tectonicus maps. It'll even appear in maps that other people make.

Tectonicus donations page

Tools

 * TectonicusGUI — guided user interface which is easy to use; written in Java.
 * teclp — dynamically updates players' location (direct download).
 * TectonicusPlayers, a hMod/Canary plugin that outputs positions of logged-on players in real-time (direct download).
 * Tectonicus Simplifier, a linux shell script that helps in setting some options (direct download).
 * NOTE: This is outdated and doesn't have all the current options coded in.
 * Minetographer, a multiplatform frontend for Tectonicus.

Tutorials

 * Integrated Video Cards (such as Intel GMA3100)
 * Setup and run Tectonicus on a headless/VPS linux machine
 * Running Tectonicus on windows command line (by mmillss)
 * German tutorial (by kleineMax)

Your maps

 * World map for 'The Shaft' (main map direct link) (alt map direct link)
 * Creeperton Public Server (Creeperton Forum Post)
 * rknova's map
 * Greys0's map
 * The VaultWorks map
 * Craig's Map (Currently looking into a real name)
 * THC Server map
 * TRTSNBN (Terra, Nether and night map)
 * Minecognix.de map
 * Yoo.dk's map
 * Coestar LP map, EP 144.
 * Sclerosis Server map
 * ridankulous map
 * aprsn.info Server Map
 * Choggoria

Got a cool map? Feel free to add a link to the list above.

Reporting Bugs
If you think you've found a bug, then please follow the instructions on the Reporting Tectonicus Bugs page.

Config File Format
Tectonicus config file format

External resources

 * Tectonicus homepage: http://triangularpixels.net/games/tectonicus
 * Bugreports and suggestions: http://tectonicus.betaeasy.com
 * Initial MinecraftForum.net topic: http://www.minecraftforum.net/viewtopic.php?f=25&t=95739