Compatibility
Minecraft: Java Edition
Platforms
Supported environments
Tags
Creators
Details
TifWorldGen replaces vanilla world generation with your own GIS data. Feed it a heightmap of your country, region or city and it builds a 1:1 Minecraft world β hills, valleys, rivers, lakes and real forest coverage β powered by a built-in pure-Java GeoTIFF engine (no external libraries, no native code, works on Windows, Linux and macOS).
Built and tested on a full real-world dataset: parts of the Slovakia DMR terrain model (73,000 Γ 48,000 blocks, 14 GB GeoTIFF).
π Privacy
TifWorldGen collects nothing β no telemetry, no analytics, no network access of any kind. It only reads the map files (GeoTIFF heightmaps/water/forest masks) that you select yourself in the in-game config screen, and it works fully offline. "GIS" in this description refers only to those local input map files.
β¨ Features
- ποΈ Real terrain from heightmaps β Float32 GeoTIFF, automatic min/max detection or manual height remapping (e.g. 1 m = 1 block)
- π Rivers & lakes from water masks β adaptive riverbed carving (shallow banks, deeper mid-river), organic riverbed blocks
- π² Real forests & biomes β map forest classes to any biome per altitude band (broadleaf β forest, coniferous β old growth taiga, peaks β snowy slopes)
- π° Structure whitelist β allow villages & structures only where your map says
- π³οΈ Vanilla-style caves β cheese/spaghetti/noodle caves that follow your terrain, aquifers, lava lakes, Deep Dark / Lush / Dripstone underground biomes
- βοΈ Seasonal snow line β Serene Seasons integration: rain below, snow above a moving altitude freeze line
- π Distant Horizons LOD pregeneration β
/tifworldgen dhpregenfills DH with terrain, rivers and trees without generating real chunks - βοΈ In-game config GUI (press O) β map import with native file browser, biome rule editor with presets, slope & water tuning
π¦ Installation
βΉοΈ This guide applies to the latest version (0.1.0-beta1 and newer). Older alpha builds required external GDAL libraries β the current version needs nothing extra.
1. Install Forge 47.x for Minecraft 1.20.1 and drop the downloaded jar into mods/:
tifworldgen-<version>-all.jar(all-in-one β the library is bundled inside, no second jar needed)
2. Install dependencies:
| Mod | Required | Why |
|---|---|---|
| Serene Seasons (+ GlitchCore) | β Yes | seasonal snow line integration |
| Distant Horizons | π΅ Optional | LOD pregeneration |
3. That's it β no native libraries, no system packages, nothing else to install. The GeoTIFF reader is built into the mod (pure Java, BigTIFF files over 100 GB supported).
4. Create a new world β world type βTif World Mapβ β press O to import your maps
πΊοΈ Map formats
| Map | Format | Notes |
|---|---|---|
| Heightmap | Float32 GeoTIFF | 1 px = 1 block ideal; min/max auto-detected |
| Water mask | Byte GeoTIFF | white (β₯128) = water |
| Forest/biome map | classes 0/1/2 or RGB | auto-scaled to heightmap resolution; Bit or HEX rules |
β¨οΈ Commands
| Command | Description |
|---|---|
/tifworldgen dhpregen radius <1β4000> |
set LOD pregeneration radius |
/tifworldgen dhpregen genaboveylevel <Y> |
pregenerate only above a height |
/tifworldgen dhpregen prepare / start / stop |
run LOD pregeneration |
/tifworldgen sereneseason status |
current season & freeze line |
β€οΈ Credits & Support
Distant Horizons LOD integration Β· Serene Seasons compatibility Β· terrain test data: Slovakia DMR.
If you enjoy the mod, please consider supporting development as I am a single developer:
π License
All Rights Reserved.



