From 3e2b83abc4791fb6a641869ba0343333c2343a1c Mon Sep 17 00:00:00 2001
From: Wuzzy <Wuzzy@disroot.org>
Date: Wed, 18 May 2022 17:24:07 +0200
Subject: [PATCH] Document biome versions

---
 README.md                | 14 ++++++++++++++
 minetest.conf            |  2 ++
 mods/rp_default/init.lua |  3 ++-
 3 files changed, 18 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 76fbe8a..b56c9f9 100644
--- a/README.md
+++ b/README.md
@@ -37,6 +37,20 @@ The original gameplay of Pixture will be (mostly) preserved,
 the focus lies on bugfixes and usability features.
 There will be no major changes to gameplay.
 
+## Compability notes
+### Using old biomes from before version 3.0.0
+Since Repixture 3.0.0, the game uses a completely revamped biome
+system. If you have a world that was created in an earlier
+version and start it now, there will be biome discontinuities in
+newly generated parts of the map, e.g. a Wasteland biome might
+border in a straignt line to Grassland. This is not a bug, but
+might look a bit strange.
+
+If you want to prevent this, you can manually edit the world file
+BEFORE starting Repixture.
+Edit `map_meta.txt` in a text editor and add the line
+`rp_biome_version = 1`.
+
 ## Credits
 
 Repixture was started by Wuzzy. It's a fork of Pixture.
diff --git a/minetest.conf b/minetest.conf
index b168ab2..3cfae1a 100644
--- a/minetest.conf
+++ b/minetest.conf
@@ -83,6 +83,8 @@ vignette_enable = true
 
 # Mapgen
 
+rp_biome_version = 2
+
 # NP: offset, scale, (spread factors), seed offset, number of octaves, persistence, lacunarity
 
 # Generic
diff --git a/mods/rp_default/init.lua b/mods/rp_default/init.lua
index 7df8105..07a7efc 100644
--- a/mods/rp_default/init.lua
+++ b/mods/rp_default/init.lua
@@ -37,7 +37,7 @@ Version 2: Major biome update introducing tons of new biomes and
            Underground biome, and much more.
            Biome heat/humidity points of existing biomes had to be
            completely updated.
-           Introduced in game version 2.2.0.
+           Introduced in game version 3.0.0.
 ]]
 local LATEST_BIOME_VERSION = 2
 local bv = minetest.get_mapgen_setting("rp_biome_version")
@@ -47,6 +47,7 @@ end
 if default.biome_version ~= 1 and default.biome_version ~= 2 then
 	default.biome_version = LATEST_BIOME_VERSION
 end
+minetest.log("action", "[rp_default] Mapgen: Using biome version "..default.biome_version)
 
 dofile(minetest.get_modpath("rp_default").."/functions.lua")
 
-- 
2.11.4.GIT