1MINETESTMAPPER(6)                Games Manual                MINETESTMAPPER(6)
2
3
4

NAME

6       minetestmapper - generate an overview image of a Minetest map
7

SYNOPSIS

9       minetestmapper -i world_path -o output_image
10
11       See additional optional parameters below.
12

DESCRIPTION

14       minetestmapper generates an overview image of a minetest map. This is a
15       port of the original minetestmapper.py to C++, that is both faster  and
16       provides more functionality than the deprecated Python script.
17

MANDATORY PARAMETERS

19       -i world_path
20              Input world path.
21
22       -o output_image
23              Path to output image. (only PNG supported currently)
24

OPTIONAL PARAMETERS

26       --bgcolor color
27              Background color of image, e.g. "--bgcolor #ffffff"
28
29
30       --scalecolor color
31              Color of scale, e.g. "--scalecolor #000000"
32
33
34       --playercolor color
35              Color of player indicators, e.g. "--playercolor #ff0000"
36
37
38       --origincolor color
39              Color of origin indicator, e.g. "--origincolor #ff0000"
40
41
42       --drawscale
43              Draw tick marks
44
45
46       --drawplayers
47              Draw player indicators
48
49
50       --draworigin
51              Draw origin indicator
52
53
54       --drawalpha
55              Allow nodes to be drawn with transparency
56
57
58       --noshading
59              Don't draw shading on nodes
60
61
62       --noemptyimage
63              Don't output anything when the image would be empty.
64
65
66       --min-y number
67              Don't draw nodes below this y value, e.g. "--min-y -25"
68
69
70       --max-y number
71              Don't draw nodes above this y value, e.g. "--max-y 75"
72
73
74       --backend backend
75              Use  specific  map  backend; supported: sqlite3, leveldb, redis,
76              postgresql, e.g. "--backend leveldb"
77
78
79       --geometry geometry
80              Limit area to specific geometry (x:y+w+h where x and  y  specify
81              the lower left corner), e.g. "--geometry -800:-800+1600+1600"
82
83
84       --extent extent
85              Don't  render  the  image, just print the extent of the map that
86              would be generated, in the same format as the geometry above.
87
88
89       --zoom factor
90              Zoom the image by using more  than  one  pixel  per  node,  e.g.
91              "--zoom 4"
92
93
94       --colors path
95              Forcefully set path to colors.txt file (it's autodetected other‐
96              wise), e.g. "--colors ../minetest/mycolors.txt"
97
98
99       --scales edges
100              Draw scales on specified image edges (letters t b  l  r  meaning
101              top, bottom, left and right), e.g. "--scales tbr"
102
103
104       --exhaustive mode
105              Select  if  database  should  be traversed exhaustively or using
106              range queries, available: never, y, full, auto
107
108              Defaults to auto. You shouldn't need to change this,  but  doing
109              so  can  improve rendering times on large maps.  For these opti‐
110              mizations to work it is important that you set min-y  and  max-y
111              when  you  don't  care  about the world below e.g. -60 and above
112              1000 nodes.
113
114

MORE INFORMATION

116       Website: https://github.com/minetest/minetestmapper
117
118

MAN PAGE AUTHOR

120       Daniel Moerner
121
122
123
124                                                             MINETESTMAPPER(6)
Impressum