Tutorials/Programs and editors/Tectonicus/TectonicusConfigFormat

When running from the command line the preferred way to configure Tectonicus is to use a config file. For the most up-to-date information, see the example config file here: http://www.triangularpixels.com/Tectonicus/layerConfig.xml

Tectonicus config files are stored as XML. If you are unfamiliar with XML, then see this basic tutorial: http://www.w3schools.com/xml/xml_syntax.asp

When starting Tectonicus, to get it to parse the config file, pass a "config=" option. For example:

java -jar Tectonicus.jar config=layerConfig.xml

If you're new then it's easiest to just take the example config file and modify the file paths so they point to your world folder and output folder.

Remember that config options are case sensitive!

= Overview =

The basic structure of the config file looks like:

These can be in any order. Only 'map' and 'layer' may be present more than once, these will be covered later.

= Example configuration file =

Here’s a minimal config file for creating a single map:

 

  k

= Configuration file defined =

Config node
Here's an example config node: <config mode = "cmd" outputDir = "/Users/xxxx/TectonicusTests/LayerTest" outputHtmlName = "map.html" minecraftJar = "/Users/xxxx/Library/Application Support/minecraft/bin/minecraft.jar" texturePack = "/Users/xxxx/Library/Application Support/minecraft/bin/minecraft.jar"

numZoomLevels = "8" singlePlayerName = "OrangyTang" spawnInitiallyVisible = "true" playersInitiallyVisible = "true" bedsInitiallyVisible = "true" signsInitiallyVisible = "true" portalsInitiallyVisible = "true" viewsInitiallyVisible = "false" numDownsampleThreads = "2" eraseOutputDir = "false" useCache = "true" logFile = "/Users/xxxx/TectonicusLog.txt" />

This controls the basic setup you need to change for your computer.

Link node
As of Tectonicus 2.02 this node appears to be inoperative.

Here's an example link node: 

Rasteriser node
Here's an example rasteriser node:  These values are used to configure your graphics card when drawing the map.

Tweeks Node
Here's an example tweeks node: 

These are options you shouldn't need to change, but can workaround quirks on some machines.

Debug node
Here's an example debug node:



These are debugging options not intended for general use

Map and Layer nodes
Every config needs at least one map and one layer, but may have as many maps and as many layers as needed.

Here's an example with one map and one layer:

		  

Marker options
The following may be optionally added to each map:

 

These control what markers are created for that map.

World subset
Optionally you can limit world rendering to a smaller section, so you don't have to draw the huge explored sections that no-one's actually built on. Also useful when testing Tectonicus options to drastically reduce rendering time.

This can be done by adding a subset node under each map:

