Skip to content
Generates a overview image of a minetest map.
Branch: master
Clone or download
Pull request Compare This branch is 83 commits ahead of sfan5:master.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
include
util
.gitignore
.travis.yml
AUTHORS Add license (BSD license) Mar 5, 2014
BlockDecoder.cpp
CMakeLists.txt
COPYING Clarify license situation (closes #26) Aug 9, 2016
Image.cpp
PixelAttributes.cpp Small refactoring. Sep 1, 2012
PlayerAttributes.cpp Finish refactor Mar 25, 2018
README.rst Add a flag to never output empty images. Nov 1, 2018
TileGenerator.cpp Add a flag to never output empty images. Nov 1, 2018
ZlibDecompressor.cpp
autogenerating-colors.txt Improve color averaging and update colors.txt again Mar 9, 2019
colors.txt
db-leveldb.cpp
db-postgresql.cpp
db-redis.cpp
db-sqlite3.cpp
mapper.cpp
minetestmapper.6 Fix typo in manpage Nov 11, 2018
util.cpp

README.rst

Minetest Mapper C++

https://travis-ci.org/minetest/minetestmapper.svg?branch=master

A port of minetestmapper.py to C++ from https://github.com/minetest/minetest/tree/master/util. This version is both faster and provides more features than the now deprecated Python script.

Requirements

  • libgd
  • sqlite3
  • LevelDB (optional, set ENABLE_LEVELDB=1 in CMake to enable)
  • hiredis library (optional, set ENABLE_REDIS=1 in CMake to enable)
  • Postgres libraries (optional, set ENABLE_POSTGRES=1 in CMake to enable)

e.g. on Debian:

sudo apt-get install libgd-dev libsqlite3-dev libleveldb-dev libhiredis-dev libpq-dev

Windows

Minetestmapper for Windows can be downloaded here: https://github.com/minetest/minetestmapper/releases

After extracting the archive, minetestmapper can be invoked from cmd.exe:

cd C:\Users\yourname\Desktop\example\path
minetestmapper.exe --help

Compilation

cmake . -DENABLE_LEVELDB=1
make -j2

Usage

minetestmapper has two mandatory paremeters, -i (input world path) and -o (output image path).

./minetestmapper -i ~/.minetest/worlds/my_world/ -o map.png

Parameters

bgcolor:
Background color of image, e.g. --bgcolor '#ffffff'
scalecolor:
Color of scale marks and text, e.g. --scalecolor '#000000'
playercolor:
Color of player indicators, e.g. --playercolor '#ff0000'
origincolor:
Color of origin indicator, e.g. --origincolor '#ff0000'
drawscale:
Draw scale(s) with tick marks and numbers, --drawscale
drawplayers:
Draw player indicators with name, --drawplayers
draworigin:
Draw origin indicator, --draworigin
drawalpha:
Allow nodes to be drawn with transparency (e.g. water), --drawalpha
extent:
Don't output any imagery, just print the extent of the full map, --extent
noshading:
Don't draw shading on nodes, --noshading
noemptyimage:
Don't output anything when the image would be empty, --noemptyimage
min-y:
Don't draw nodes below this y value, e.g. --min-y -25
max-y:
Don't draw nodes above this y value, e.g. --max-y 75
backend:
Override auto-detected map backend; supported: sqlite3, leveldb, redis, postgresql, e.g. --backend leveldb
geometry:
Limit area to specific geometry (x:z+w+h where x and z specify the lower left corner), e.g. --geometry -800:-800+1600+1600
zoom:
Apply zoom to drawn nodes by enlarging them to n*n squares, e.g. --zoom 4
colors:
Override auto-detected path to colors.txt, e.g. --colors ../minetest/mycolors.txt
scales:
Draw scales on specified image edges (letters t b l r meaning top, bottom, left and right), e.g. --scales tbr
You can’t perform that action at this time.