Experimental map generator for Minetest, implementing river networks, lakes, and erosion.
Go to file
Gael-de-Sailly 6af6795d90 Comment and clarify 2020-04-26 17:13:38 +02:00
.gitignore Re-added river flow data because needed for map preview 2020-04-13 15:01:44 +02:00
README.md Comment and clarify 2020-04-26 17:13:38 +02:00
bounds.py Comment and clarify 2020-04-26 17:13:38 +02:00
erosion.py Comment and clarify 2020-04-26 17:13:38 +02:00
geometry.lua Comment and clarify 2020-04-26 17:13:38 +02:00
init.lua Comment and clarify 2020-04-26 17:13:38 +02:00
load.lua Re-organized the code. All polygon-related calculations go to polygons.lua. 2020-04-14 21:11:54 +02:00
polygons.lua Comment and clarify 2020-04-26 17:13:38 +02:00
rivermapper.py Comment and clarify 2020-04-26 17:13:38 +02:00
save.py Compress data files (reduces size by a factor 3-4) 2020-04-13 15:59:34 +02:00
settings.lua Re-organized the code. All polygon-related calculations go to polygons.lua. 2020-04-14 21:11:54 +02:00
terrain_rivers.py Comment and clarify 2020-04-26 17:13:38 +02:00
view_map.py Comment and clarify 2020-04-26 17:13:38 +02:00

README.md

mapgen_rivers

Procedural map generator for Minetest 5.x. Focused on river networks, and features valley erosion and lakes.

Contains two distinct programs: Python scripts for pre-processing, and Lua scripts to generate the map on Minetest.

Screenshot

Installation

This mod should be placed in the /mods directory like any other Minetest mod.

The Python part relies on external libraries that you need to install:

  • numpy and scipy, widely used libraries for numerical calculations
  • noise, doing Perlin/Simplex noises
  • optionally, matplotlib (for map preview)

They are commonly found on pip or conda Python distributions.

Usage

Pre-processing

Run the script terrain_rivers.py via command line. You can optionally append the map size (by default 400). Example for a 1000x1000 map:

./terrain_rivers.py 1000

For a default 401x401 map, it should take between 1 and 2 minutes. It will generate 5 files directly in the mod folder, containing the map data.

Map generation

Just create a Minetest world with singlenode mapgen, enable this mod and start the world. The data files are immediately copied in the world folder so you can re-generate them afterwards, it won't affect the old worlds.