A multi-threaded mapper for Minetest with node transparency support.
It generates a view of the world from above, rendering one pixel per voxel.
First, compile the project with cargo:
bash
cargo build --release
Then, call the executable target/release/minetest-worldmapper
with the three required arguments:
| Option | Description | | -------- | ----------------------------------------- | | --world | The directory of the world to render. | | --config | The config file. The format should follow the example config file]. | | --output | The image file which the map should be rendered to. |
bash
minetest-worldmapper --world TestWorld/ --config config.example.toml --output map.png
If a voxel is rendered and its color is entirely determined by config file. Its main purpose is to map content IDs to colors.
| Config option | Type | Description |
| ------------------ | ------------ | ------------------- |
| version
| Integer | Currently always 1. |
| background_color
| String | Hex color string in the format "rrggbb" or "rrggbbaa". Serves as a fallback color if all voxels for a given pixel are exhausted and there is transparency left. |
| target_alpha
| Integer | When determining a pixel's color, stop going through transparent nodes when reaching this opacity value. Between 0 and 255. |
| node_colors
| Table | A mapping from content names to color strings in the same format as background_color
. |