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.19.jar worldDir=C:/MinecraftMultiplayer/world
See the Tutorials for specific and additional instructions.
Command Line Arguments
| Name | Settings | Usage |
|---|---|---|
| alphaBits |
|
alphaBits specifies how many bits are assigned to designate the alpha on the tiles of the map. It is recommended to use 0 (off) or 8 (full). However, Tectonicus passes the value directly to your graphics card, so you can theoretically pass any value your graphics card supports. More information regarding color depth can be found on Wikipedia. |
| 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.
|
| cameraElevation |
|
This specifies the angle of elevation for the camera, in degrees. 0 is looking horizontally, 90 is looking directly down. Defaults to 45. Choose 30 for a more traditional isometric view. |
| 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, like alpha bits, specifies how many bits are assigned to the colors in the tiles of the map. It is also passed directly to you graphics card, so you can pass any supported value. However, 24 ("millions of colors" or "truecolor"), or 16 ("thousands of colors"), is recommended. Again, read the Wikipedia article for more information regarding color depth. |
| eraseOutputDir |
|
Specify 'true' to erase the entire output directory and render from scratch. |
| imageCompressionLevel |
|
For jpeg renders only, specify a number between 1.0 and 0.1 to change the compression level. Defaults to 0.95. |
| 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. |
| lighting |
|
Choose the lighting style to render with. Possible values are 'day' 'night' or 'none'. Defaults to 'day' |
| minecraftJar |
|
The path to your client minecraft jar, for terrain texture. If not specified, will attempt to find it in your AppData dir. |
| maxTiles |
|
This specialized argument is used only for troubleshooting. 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 |
|
Setting mode=cmd does not appear to change how Tectonicus runs. Setting mode=gui opens up a simple gui with basic features. In version 1.18, the gui allows input for the world directory, output directory, and minecraft.jar location. Selecting "Show Advanced Options" merely displays the text "advanced". 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). |
| outputDir |
|
Required. This specifies the directory you want the rendered map files to placed in. |
| 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 |
|
Specifies the map drawing style, 'regular' for normal, or 'cave' for cave style. Defaults to 'regular' |
| showSpawn |
|
Specifies whether or not to show an icon for the spawn position. Choose 'true' or 'false', default 'true'. |
| 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 |
|
Specify the location of a custom texturepack to use. Uses the standard textures by default. The texture pack can be located anywhere on your system.
Example: texturePack="C:\Users\Bob\Desktop\FrendenTPV5_1.zip" Note the double quotation marks. |
| tileSize |
|
Specifies the size of the output image tiles, in pixels. Default 512 |
| useBiomeColours |
|
Set to use biome colours for grass and leaves. Choose 'true' or 'false', default 'true' |
| useCache |
|
Enable or disable the use of the cache to speed up repeated map rendering. (see also cacheDir above) |
| verbose |
|
Set to true to print additional debug output during render. |
| worldDir |
|
Required. Path to your minecraft world directory (containing level.dat), or numbers 1 to 5 for your singleplayer worlds. |
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.
"It doesn't work!" / Reporting Bugs
Please read the Reporting Tectonicus Bugs 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
- 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)
- HrpDrp's map
- rknova's map
- griffen8280's map
- Greys0's map
- Linecraft's RP map
- The VaultWorks map
- ridankulous map
- Craig's Map (Currently looking into a real name)
- NimmoG and SvenJJ's crazy adventures
- WoF-JE (we like pixelart)
Got a cool map? Feel free to add a link to the list above.