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

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
- Install the loader shown in the table (Fabric, Forge or NeoForge) for the same Minecraft version.
- Put the .jar file into
.minecraft/mods. - Start Minecraft with that loader profile.
Similar

A customizable world generation platform and API for Fabric, Forge, and Bukkit servers used to create custom and Earth-like terrain.
1:40mA world generation mod that creates a customizable, scale-adjustable replica of planet Earth using streamed geographic data.

A world generation mod that streams real-world elevation, climate biomes, roads, and buildings from geographic and OpenStreetMap datasets.

A world generation mod that adds a real Earth world type to Minecraft.

A real-Earth world generator for TerraFirmaCraft featuring real continents, rivers, lakes, mountains, climate zones, and coordinate spawning.

A China-optimized fork of the Tellus mod that generates real-world Earth terrain, elevation, biomes, and climate from geographic data.
1 to 1A performance-focused fork of the Terra 1 to 1 mod that generates the real Earth at a 1:1 scale using online datasets and OpenStreetMap.

An addon mod recreating Medieval Western Europe in 1237 with a map of the British Isles, France, northern Iberia, and the western Holy Roman Empire.