Difference between revisions of "Minetestmapper"

Latest revision as of 19:58, 27 October 2024

Sample output

The minetestmapper creates 2D maps of your world, where one node corresponds to one pixel.

Usage

This describes the usage of the C++ minetestmapper. The usage of minetestmapper.py is similar.

Make sure there is a colors.txt in the same folder as the mapper. The default one does not support any mods. You can download VanessaE’s more complete colors.txt, containing support for hundreds of mods.

On GNU/Linux, open a terminal in the folder the mapper is. Create a map using this command:

./minetest_mapper -i /home/user/.minetest/worlds/my_world/ -o /home/user/map.png

Having Luanti running in place, you might have to modify the world path.

On Windows, Shift + Right click in the folder the mapper is in, then select Open a command window here. To create a map, type this command:

minetest_mapper.exe -i "C:\your_path_to_luanti\worlds\example\" -o map.png

The geometry option allows you to define an area to map. Use it between “./minetestmapper” and the input “-i”.

--geometry -10000:-10000+20000+20000

Result: A 20.2 MiB file covering a 20,000 × 20,000 area starting in the lower left corner at X=-10,000; Y=-10,000

Versions

Currently, there are three mappers. It is recommended to use the C++ version.

minetestmapper.py

A mapper written in Python. It's very slow.

minetestmapper in C++

The minetestmapper rewritten with C++. It is much faster. The code can be found on GitHub.

minetestmapper-numpy.py

An improved version of the Python mapper with many additional features, like side view, scaling and fog. It is 8 to 10 times faster than the original minetestmapper.py, but still slower than the C++ version. Information about installation and usage can be found in the forum.

@@ Line 1: / Line 1: @@
-The '''Minetestmapper''' creates 2D maps of your [[Maps|world]], where one [[Nodes|node]] corresponds one pixel.
+[[File:Screenshot minetestmapper.png|frame|Sample output]]
+The '''minetestmapper''' creates 2D maps of your [[Maps|world]], where one [[Nodes|node]] corresponds to one pixel.
 === Usage ===
-This describes the usage of the C++ minetestmapper. The usage of minetestmapper.py is similar.
-Make sure there is a colours.txt in the same folder as the mapper. You might want to download VanessaE’s more complete [http://digitalaudioconcepts.com/vanessa/hobbies/minetest/colors.txt colours.txt]
+''This describes the usage of the C++ minetestmapper. The usage of minetestmapper.py is similar.''
+Make sure there is a <code>colors.txt</code> in the same folder as the mapper. The default one does not support any mods.
+You can download VanessaE’s more complete [http://daconcepts.com/vanessa/hobbies/minetest/colors.txt colors.txt], containing support for hundreds of mods.
-On Linux open a terminal in the folder the mapper is. Create a map using this command.
+On GNU/Linux, open a terminal in the folder the mapper is. Create a map using this command:
   ./minetest_mapper -i /home/user/.minetest/worlds/my_world/ -o /home/user/map.png
-Having minetest running in place you might have to modify the world path.
+Having Luanti running in place, you might have to modify the world path.
-On Windows press shift and right click in the folder the mapper is in, select the command prompt. To create a map type this command.
-  minetest_mapper.exe -i "C:\your_path_to_minetest\Minetest\worlds\example\" -o map.png
+On Windows, '''Shift + Right click''' in the folder the mapper is in, then select '''Open a command window here'''. To create a map, type this command:
+  minetest_mapper.exe -i "C:\your_path_to_luanti\worlds\example\" -o map.png
 The geometry option allows you to define an area to map. Use it between “./minetestmapper” and the input “-i”.
   --geometry -10000:-10000+20000+20000
 Result: A 20.2 MiB file covering a 20,000 × 20,000 area starting in the lower left corner at X=-10,000; Y=-10,000
 === Versions ===
-Currently there are two mappers. It is recommended to use the C++ version.
+Currently, there are three mappers. '''It is recommended to use the C++ version.'''
 ==== minetestmapper.py ====
-A mapper written in Python. It comes with Minetest and can be found in ./minetest/util/
+A mapper written in Python. It's very slow.
 ==== minetestmapper in C++ ====
-The minetestmapper written into C++ by mireq. It is much faster. The code can be found on [https://github.com/mireq/minetest-mapper-cpp github] as well as an [https://github.com/mireq/minetest-mapper-cpp/downloads .exe] for Windows. Also see the [https://forum.minetest.net/viewtopic.php?id=2896 forum].
+The minetestmapper rewritten with C++. It is much faster. The code can be found on [https://github.com/minetest/minetestmapper GitHub].
 ==== minetestmapper-numpy.py ====
-An improved version of the python mapper with many additional features, as sideview, scaling and fog. It is 8 to 10 times faster than the original minetestmapper.py, but still slower than the c++ code. Information about installation and usage can be found in the [https://forum.minetest.net/viewtopic.php?f=14&t=8730 forum].
+An improved version of the Python mapper with many additional features, like side view, scaling and fog. It is 8 to 10 times faster than the original minetestmapper.py, but still slower than the C++ version. Information about installation and usage can be found in the [https://forum.minetest.net/viewtopic.php?f=14&t=8730 forum].
 [[Category:Related software]]
 [[Category:Map]]