NAME

       minetestmapper - generate an overview image of a Minetest map

SYNOPSIS

       minetestmapper -i world_path -o output_image

       See additional optional parameters below.

DESCRIPTION

       minetestmapper  generates  an  overview  image  of  a  minetest map. This is a port of the
       original minetestmapper.py to C++, that is both faster  and  provides  more  functionality
       than the deprecated 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  (it's  autodetected  otherwise),  e.g.
              "--colors ../minetest/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

                                                                                MINETESTMAPPER(6)