Mods & tools

TifWorldGen

A Forge world generation mod that builds 1:1 real-world Minecraft terrain, rivers, and forests from local GIS GeoTIFF heightmaps.

TifWorldGen

Overview

TifWorldGen is a mod by Modulak for Minecraft Java Edition 1.20.1 that replaces standard terrain generation with custom local GIS map files. By reading user-selected heightmaps of cities, regions, or countries, it constructs real-world landscapes at a 1:1 scale, meaning one thousand blocks in the game equal one real-world kilometre. One pixel on the input heightmap ideally represents a single block, and vertical heights can be mapped at a ratio of one meter per block.

The mod operates using an internal pure-Java GeoTIFF reader that functions across Windows, Linux, and macOS without requiring native code or external libraries. Starting from version 0.1.0-beta1, it no longer requires external GDAL libraries and supports BigTIFF files exceeding 100 GB in size. The system was developed and tested using a 14 GB GeoTIFF dataset from the Slovakia DMR terrain model, covering an area of 73,000 by 48,000 blocks. The tool works completely offline without collecting analytics or connecting to the network, accessing only the local map files chosen by the user.

Terrain and Underground Features

Surface landscapes are shaped by combining Float32 GeoTIFF heightmaps with separate masks for water bodies and forest coverage. For elevation, the generator either detects minimum and maximum heights automatically or applies manual height remapping rules. Water masks in Byte GeoTIFF format identify values of 128 or higher as water, carving adaptive riverbeds with organic blocks that are shallow along the banks and deeper toward the middle. Forest and biome maps use RGB values or 0/1/2 classes to assign specific biomes across different altitude bands, such as placing regular forests in broadleaf zones, old growth taiga in coniferous areas, and snowy slopes on mountain peaks.

Beneath the custom topography, the generator places vanilla-style cave systems and underground biomes that follow the surface terrain. Players exploring underground will encounter cheese, spaghetti, and noodle caves alongside aquifers and lava lakes. The subterranean layers also include Deep Dark, Lush, and Dripstone biomes. Back on the surface, a structure whitelist ensures that villages and other generated structures only spawn in locations permitted by the imported map data.

Configuration and Mod Integrations

Players set up their custom worlds by selecting the Tif World Map world type and pressing the O key to open the in-game configuration menu. This interface provides a native file browser for importing local map files, tools for tuning slope and water settings, and a biome rule editor with presets using Bit or HEX rules. Any imported forest or biome map is automatically scaled to match the resolution of the primary heightmap.

TifWorldGen runs on Forge 47.x and integrates directly with Serene Seasons and Distant Horizons. Serene Seasons and GlitchCore are required dependencies that manage a moving altitude freeze line, producing rain below the threshold and snow above it, which can be checked using the /tifworldgen sereneseason status command. Distant Horizons is an optional addition that allows players to pregenerate LOD terrain, rivers, and trees without generating actual Minecraft chunks by running the /tifworldgen dhpregen commands with radius, height level, prepare, start, or stop parameters.

How to install

  1. Install the loader shown in the table (Fabric, Forge or NeoForge) for the same Minecraft version.
  2. Put the .jar file into .minecraft/mods.
  3. Start Minecraft with that loader profile.

Similar