---
name: "minetestmapper"
section: "6"
platform: "linux"
package: "minetestmapper"
version: "20241111-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/minetestmapper"
---

# minetestmapper(6)

generate an overview image of a Luanti map

## NAME

minetestmapper - generate an overview image of a Luanti map

## SYNOPSIS

**minetestmapper** **-i** *world\_path* **-o** *output\_image*

See additional optional parameters below.

## DESCRIPTION

**minetestmapper** generates an overview image of a Luanti map. This is a port of the original minetestmapper.py to C++, that is both faster and provides more functionality than the obsolete Python script.

## MANDATORY PARAMETERS

- **-i** ***world\_path***

  Input world path.

- **-o** ***output\_image***

  Path to output image. (only PNG supported currently)

## OPTIONAL PARAMETERS

- **--bgcolor** ***color***

  Background color of image, e.g. "--bgcolor #ffffff"

- **--scalecolor** ***color***

  Color of scale, e.g. "--scalecolor #000000"

- **--playercolor** ***color***

  Color of player indicators, e.g. "--playercolor #ff0000"

- **--origincolor** ***color***

  Color of origin indicator, e.g. "--origincolor #ff0000"

- **--drawscale**

  Draw tick marks

- **--drawplayers**

  Draw player indicators

- **--draworigin**

  Draw origin indicator

- **--drawalpha**

  Allow nodes to be drawn with transparency

- **--noshading**

  Don't draw shading on nodes

- **--noemptyimage**

  Don't output anything when the image would be empty.

- **--min-y** ***number***

  Don't draw nodes below this y value, e.g. "--min-y -25"

- **--max-y** ***number***

  Don't draw nodes above this y value, e.g. "--max-y 75"

- **--backend** ***backend***

  Use specific map backend; supported: *sqlite3*, *leveldb*, *redis*, *postgresql*, e.g. "--backend leveldb"

- **--geometry** ***geometry***

  Limit area to specific geometry (*x:y+w+h* where x and y specify the lower left corner), e.g. "--geometry -800:-800+1600+1600"

- **--extent**

  Don't render the image, just print the extent of the map that would be generated, in the same format as the geometry above.

- **--zoom** ***factor***

  Zoom the image by using more than one pixel per node, e.g. "--zoom 4"

- **--colors** ***path***

  Forcefully set path to colors.txt file (autodetected otherwise), e.g. "--colors ../world/mycolors.txt"

- **--scales** ***edges***

  Draw scales on specified image edges (letters *t b l r* meaning top, bottom, left and right), e.g. "--scales tbr"

- **--exhaustive** ***mode***

  Select if database should be traversed exhaustively or using range queries, available: *never*, *y*, *full*, *auto*

  Defaults to *auto*. You shouldn't need to change this, but doing so can improve rendering times on large maps. For these optimizations to work it is important that you set **min-y** and **max-y** when you don't care about the world below e.g. -60 and above 1000 nodes.

- **--dumpblock** ***pos***

  Instead of rendering anything try to load the block at the given position (*x,y,z*) and print its raw data as hexadecimal.

## MORE INFORMATION

Website: https://github.com/minetest/minetestmapper

## MAN PAGE AUTHOR

Daniel Moerner