mtcontrib/mapgen_rivers
1
0
Fork 0
mirror of https://gitlab.com/gaelysam/mapgen_rivers.git synced 2024-12-28 03:40:39 +01:00
Code Issues Projects Releases Wiki Activity
Experimental map generator for Minetest, implementing river networks, lakes, and erosion.
34 Commits 16 Branches 3 Tags 1.5 MiB
Lua 92.2%
Python 7.8%
horznoise
Go to file
Gael-de-Sailly 6f43430574 Added glaciers, and re-organized noise definitions
2020-05-24 12:09:21 +02:00
demo_data Change folder structure: data files are now in a directory. 2020-04-26 23:29:36 +02:00
.gitignore Change folder structure: data files are now in a directory. 2020-04-26 23:29:36 +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
heightmap.lua Horizontal shifting according to 3D noises: 2020-05-23 15:52:16 +02:00
init.lua Added glaciers, and re-organized noise definitions 2020-05-24 12:09:21 +02:00
load.lua Change folder structure: data files are now in a directory. 2020-04-26 23:29:36 +02:00
noises.lua Added glaciers, and re-organized noise definitions 2020-05-24 12:09:21 +02:00
polygons.lua Added glaciers, and re-organized noise definitions 2020-05-24 12:09:21 +02:00
README.md Change folder structure: data files are now in a directory. 2020-04-26 23:29:36 +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 Added glaciers, and re-organized noise definitions 2020-05-24 12:09:21 +02:00
terrain_rivers.py Change folder structure: data files are now in a directory. 2020-04-26 23:29:36 +02:00
view_map.py Change folder structure: data files are now in a directory. 2020-04-26 23:29:36 +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

By default, the mod contains a demo 400x400 map (so you can start the game directly), but it is recommended that you run the pre-processing script to generate a new map before world creation, if you can.

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 400x400 map, it should take between 1 and 2 minutes. It will generate 5 files directly in the mod folder, containing the map data.

If you have matplotlib installed, the script view_map.py can be used to get a map preview. Example:

./view_map.py 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.