Mods & tools

Terrarium

A configurable real-Earth world generator using AWS elevation tiles and climate data to create Earth terrain at adjustable zoom scales.

Terrarium

Overview

Terrarium is a Minecraft Java Edition mod by lynxs that generates Earth landscapes from real-world elevation data. It is compatible with game versions 1.21.4 through 1.21.8 and requires FabricAPI to function. The tool uses dynamic tile loading and offers options to customize the shape of the terrain.

In singleplayer mode, players can select the Earth world type during creation and use the customize menu to adjust world settings. For server configurations, the required world type identifier is terrarium:terrarium. The mod also uses a configuration file located at /config/BlossomMods/Terrarium.json to define data URLs and a local directory for caching tiles.

Data Pipeline and Generation

The mod constructs worlds by fetching 256x256 pixel PNG elevation tiles from AWS S3 and caching them locally. It translates each individual pixel directly into one in-game block, meaning a single tile covers a 256x256 block area. The RGB pixel values from the downloaded images are converted into block heights and adjusted using an additionalAlt parameter.

Climate and biome placement rely on both elevation calculations and external weather datasets. Temperature and precipitation figures are pulled from a monthly climate dataset compiled by the creator with QGIS and temporarily hosted on GitHub. Vanilla Minecraft biomes are assigned across the terrain according to elevation parameters, specifically using startingY and altitudeDropoff values.

World Scale and Performance

The overall dimensions and scale of the generated planet depend on the selected zoom level, which sets the tile count per axis to 2 to the power of the zoom value. A zoom setting of 8 produces 256 tiles per axis, resulting in a map 65,536 blocks wide. Raising the zoom to 10 creates 1,024 tiles per axis (262,144x262,144 blocks), representing a ~1:48 scale where 1 block corresponds to roughly 48 metres of real-world distance across each kilometre.

At zoom level 13, the world reaches a planetary scale of ~1:6, meaning 1 in-game block represents about 6 real-world metres along every kilometre. This setting uses 8,192 tiles per axis to build a 2,097,152x2,097,152 block map and supports terrain heights such as 768 blocks. Because higher zoom levels increase world size and slow down terrain generation, choosing a zoom between 8 and 10 is recommended for standard survival gameplay.

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