Configuration

plugins/TileMapper/config.yml

Key	Value Type	Required? [Default]	Description
enabled	boolean	N [true]	Master toggle. Set to false to disable all tile processing without unloading the plugin.
active_blockset	String	N [Default]	Active colour-palette blockset. (See Blockset wiki)
active_source	String	N [osm]	Key of the default tile source (must match one of the keys under tile_sources:).
tile_sources	map	N [osm, bing, yandex, tw]	Map of named tile source definitions. Each key is the source name; value is a table below.
max_concurrent_requests	int	N [2]	Max simultaneous HTTP requests to tile servers.
cache_size	int	N [1000]	In-memory tile cache size (number of tiles).
surface_block_mask	boolean	N [false]	When true, only replace the configured surface block type — preserves road/building markers.
config_version	String	N [1.0]	Internal version marker. Do not change.

The target block type for surface_block_mask is read from T+-'s surface_material config (default: GRASS_BLOCK).

---

Tile source

Each entry under tile_sources: is a named map with the following keys:

Tile source settings

Key	Value Type	Required? [Default]	Description
url	String	Y	Tile server URL template. Supports placeholders for dynamic values.
zoom	int	N [14]	Default zoom level for tile fetches.
offset	map	N [x:0, z:0]	Fine-tune tile alignment in block coordinates.
invert_zoom	boolean	N [false]	Zoom system is inverted when true. Useful when lower zoom value means higher resolution.
flip_vert	boolean	N [false]	*Flip tiles vertically when true.
invert_lat	boolean	N [false]	*Latitude is inverted when true. It will also flip tiles vertically.

* Tiles won't be "flipped" when both flip_vert and invert_lat are set to true (For nerds, think of it as an XOR gate)

URL placeholders

The url field supports the following placeholders, replaced at runtime per-tile:

Placeholder	Description
{z}	Tile zoom level (respects invert_zoom if enabled).
{x}	Tile X coordinate (column).
{y}	Tile Y coordinate (row).
{quadkey}	Bing Maps quadkey (derived from x/y/zoom).
{u}	Bing Maps URL-encoded quadkey (used by VirtualEarth /comp/ch endpoint).
{random:v1,v2,...}	Randomly picks one value from the comma-separated list on each request. Useful for subdomain rotation (e.g. {random:a,b,c}.tile.com).