Mods & tools

Terrarium Expanded

A world generator mod that creates a real-Earth overworld at configurable zoom scales using live elevation, surface-water, and ecoregion data.

Terrarium Expanded

Overview

Terrarium Expanded is a Minecraft Java Edition mod by intplex that generates an Earth-based overworld using real geographic data rather than standard procedural noise. Designed for versions 1.21.1 and 1.21.11, the project builds real-world topography, water bodies, and biome-based landcover directly into the game. Players can explore recognizable global locations such as Mount Fuji, the Grand Canyon, Montreal, San Francisco, and the Strait of Gibraltar. The mod is built on Architectury to support both Fabric and NeoForge environments.

The mod includes built-in compatibility for several world generation expansions and custom height datapacks. Players can pair the real-world terrain with biome mods including Biomes O' Plenty, Regions Unexplored, and Nature's Spirit. Additionally, it works alongside datapacks that alter the minimum or maximum vertical Y levels of the overworld.

World Scale and Zoom Levels

Players can adjust the total dimensions and detail of the planet by selecting a zoom level between 8 and 12, which determines how many real-world meters are represented by a single Minecraft block. At zoom level 8, the map measures 65,536 by 65,536 blocks with a scale where one block equals roughly 611.50 meters of real-world distance, offering the fastest generation. Zoom level 9 expands the world to 131,072 by 131,072 blocks, meaning each block spans approximately 305.75 meters for a lighter runtime demand. For a balanced exploration experience, zoom level 10 produces a 262,144 by 262,144 block map where every block represents about 152.87 meters.

Selecting the highest zoom settings provides finer geographic detail and more blocks per kilometer at the cost of heavier computational demand. Zoom level 11 generates a 524,288 by 524,288 block world at a density of roughly 76.44 meters per block. The largest option, zoom level 12, creates a 1,048,576 by 1,048,576 block map where a single block covers approximately 38.22 meters, which requires the most time to explore when uncached.

Data Sources and System Requirements

To construct the planet accurately, the mod combines three streamed remote datasets with one local data layer. Elevation and terrain relief are pulled from AWS Terrarium tiles, while inland rivers and lakes are placed using global surface-water seasonality data. Terrestrial biomes are assigned using reduced WWF ecoregion data, and ocean temperature tiers rely on a bundled WOA23 sea-surface temperature dataset. While default public servers are preconfigured for these requests, users can modify the data endpoints through the Earth preset editor.

Running Terrarium Expanded requires Java 21 or newer and an active internet connection while generating new terrain. Because the mod actively downloads terrain, surface-water, and ecoregion tiles as you explore, blocked or offline remote services will reduce the accuracy and completeness of the landscape. Furthermore, the underlying AWS elevation data occasionally contains anomalies or terrain spikes, which become more visible when playing on higher zoom settings.

Performance and Local Caching

Initial exploration of unvisited areas can cause temporary stuttering while the game fetches remote map files and builds chunks. This performance drop is most noticeable when traveling rapidly into new territories or playing on high zoom levels that require more tile downloads. As data is retrieved from the internet, the mod saves the files into a local cache on your machine. Subsequent visits to cached regions run more smoothly, and deleting the local cache folder will not corrupt the saved world, though future generation in those areas will require re-downloading the tiles.

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