Actual size output
Tectonicus is a 'deep' minecraft map renderer, instead of plotting blocks as pixels it generates a 3d model of your map and uses that to draw maps with a high zoom and 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 in google maps.
Features
- Runs on Windows, OSX and Linux if X or Xvfb is installed.
- Can map single and multiplayer worlds
- Can use your texture pack so the map looks exactly like your world
- Shows spawn position on map
- Shows sign positions on map, and shows sign text when clicked
- Creates player markers by using player's custom skins, and 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, jpeg or gif image formats
- Day and night drawing modes
- Antialiasing for high quality output
Example map
Downloads
Please view the forum topic for the latest download version
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.
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.0.jar worldDir=C:/MinecraftMultiplayer/world
If you are using an integrated videocard (such as Intel GMA3100), probably you need to follow next instructions.
If you are using a headless/VPS linux machine look here for a tutorial Tectonicus/VPS
Additional Command Line Arguments
| Name | Settings | Usage |
|---|---|---|
| alphaBits |
|
Specifies the number of alpha bits for output. alphaBits=0 is off. [additional info needed] |
| cacheDir |
|
Specifies the directory to be used for caching (see also useCache below). Caching is enabled by default, and the default directory location is a subdirectory within the output directory. |
| cameraAngle |
|
Use this command to change the orientation of north. The default setting of 45 produces an oblique view with north at the upper left of the map. 0 will give you north at the top; 90 will give you east at the top; and so on. As you increase this number imagine the map's cardinal directions rotating in a counter-clockwise direction. |
| closestZoomSize |
|
When zoomed-in all the way this value determines the area that will be visible in one of the rendered picture files. Increase [x] to "widen" the camera lens of this closest view. Sometimes used in conjunction with numZoomLevels (see below).
For example, closestZoomSize=24 will create tiles that show 100% more terrain than at the default 12 (i.e. you will be "further back"). It is from these closest tiles (zoom8) that the other, wider tiles are rendered (zoom7 - zoom0). Increasing this number requires more memory, so making it too large may result in out-of-memory errors. |
| colourDepth |
|
Color depth for rendering [additional info needed] |
| imageFormat |
|
You can reduce file sizes (at the expense of a small degradation in image quality) by changing the output to jpg or gif files. If you're using a texture pack keep in mind that gifs are limited to 256 colors and the map may not accurately reflect the pack's detail.
Example: imageFormat=jpg |
| lighting |
|
Example: lighting=night |
| maxTiles |
|
This specialized argument is used only for trouble shooting. For example maxTiles=100 will create a kind of "preview" map render consisting of only 100 base tiles (i.e. not the entire map). |
| mode |
|
[info needed for cmd and gui]. Setting mode=players will update the positions of players only (i.e. it will not re-render the map). This is for use on multiplayer maps.
See also players below. |
| numSamples |
|
Specifies the number of samples for antialiasing. Defaults to 4 (high quality). Setting numSamples=0 can sometimes eliminate problems with graphics cards that do not support anti-aliasing. |
| numZoomLevels |
|
This defines how many zoom levels the resulting map will have. The map loads at zoom0 (zoom level zero); replace [x] with the desired number of zoom levels beyond zoom0.
For example numZoomLevels=6 will give you starting zoom0 plus 6 more zoom levels (zoom1 through zoom6). How close to the terrain the closest zoom will be is determined by argument closestZoomSize (see above). |
| playerFilterFile |
|
Specifies the whitelist or blacklist file for use with the players=blacklist and players=whitelist arguments (see below). The file should list one player per line (as with the ops file format). |
| players |
|
By default, player locations in a multiplayer world will be indicated on the map with an icon that uses that particular player's current skin.
Set players=none to omit player location markers altogether. Setting players=ops will show the users listed in the server's ops configuration file. Setting players=whitelist displays only players in the whitelist filter file (see also playerFilterFile above). Setting players=blacklist excludes players in the filter file. When clicked, the player marker will pop up a tooltip bubble that shows the current skin, health, and air of the player. It also flags players who have made a charitable donation in Tectonicus' name. The final map will have a toggle box in the lower right to allow users to hide or reveal player markers at will. To update player markers without having to re-render the map use the mode argument (see above). |
| playersInitiallyVisible |
|
Determines if the players will be visible on initial loading of the map. |
| renderStyle |
|
Example: renderStyle=cave will render the map in a caves-only mode. |
| showSpawn |
|
Example: showSpawn=false will remove the spawn marker from the map. |
| signs |
|
Signs that use special characters !, -, = or ~ will be visible on the map as location markers. The text on these signs must begin and end with any of the listed special characters. For example a sign reading "-- Lookout point --" will appear as a location marker at all zoom levels. When clicked, the marker will pop up a tooltip bubble showing the full text of the sign.
Setting signs=all will make all signs into map markers regardless of the writing on the signs. Whether set to all or none, the final map will have a toggle box in the lower right to allow users to hide or reveal signs at will. |
| signsInitiallyVisible |
|
Determines if the signs will be visible on initial loading of the map. |
| texturePack |
|
The texture pack can be anywhere on your system.
Example: texturePack="C:\Users\Bob\Desktop\FrendenTPV5_1.zip" Note the double quotation marks. |
| useBiomeColours |
|
Supports biome colors by default. Set useBiomeColours=false to troubleshoot problems with this feature. |
| useCache |
|
Enable or disable the use of the cache to speed up repeated map rendering. (see also cacheDir above) |
Please Donate!
Donation badge
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.
Click to go to the donations page
Tools
- teclp — dynamically updates players' location (direct download).
- TectonicusPlayers, a hMod 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.
Tutorials
Your maps
- World map for 'The Shaft' (direct link)
- HrpDrp's map
- rknova's map
- griffen8280's map
- Greys0's map
- Linecraft's RP map
- The VaultWorks map
- CJ-NET - Minecraft World 1
- ridankulous map
Got a cool map? Feel free to add a link to the list above.