
Terrarium
Adds an Earth-replica world type based on real-world data.
About this Mod

Terrarium adds a new customizable world type that generates a replica of the Earth within Minecraft.

Creating a World
An Earth world can be simply created by cycling the 'World Type' option. From here, the world can either be created right away with default settings or customized through the 'Customize' button.
This will open a new customization GUI, displaying all available properties on the left and a preview of the world on the right.

Whenever a setting is changed, the preview will be rebuilt around the selected spawnpoint. This allows you to judge how your world will look.
Note that the default preset is not survival ready -- no ores or resources will be spawned. These can be enabled through the 'Survival Properties' section.
Navigation
To navigate to any real-world location, you can make use of the geotp command:
It can be used with latitude & longitude coordinates:
/geotp 27.987746 86.924812
Or it can be used with a place name:
/geotp Mount Everest
Additionally, you can make use of the /geotool command, which provides various utilities for navigating the world. It provides a UI to display where you currently are, and a UI to teleport to a new location with a map.
World Height
The vanilla world is limited to a 256 block height range, which usually can not fit the entire height range of the Earth! Depending on your world scale settings, you might end up with the top of the world being chopped off at the height limit. Luckily, Terrarium supports Cubic Chunks which is an amazing mod that enables infinite height ranges. As long as you create a world while Cubic Chunks is installed, terrain should no longer get cut off!
Mod Support
Terrarium generally tries to support other mod's world generators, but in some cases this support is limited. Custom modded biomes have to be explicitly supported by Terrarium, and currently only Biomes O' Plenty is supported.
Most modded generators should work, as long as you have the "Compatibility Mode" enabled in your world customization settings. It is important to note however that due to most mods expecting a normal height range between 0-255 with the terrain centering around Y=63, Terrarium shifts modded generators to generate correctly around the surface level. The result of this is that Y-ranges for features such as ores will not be absolute, but rather relative to the surface, and will be stop generating over 64 blocks below the surface. Vanilla features will still generate correctly throughout the height range.
Server Setup
While Terrarium has a few clientside features, it functions completely as a serverside-only mod. This means a player connecting to a server with the mod does not need to have it installed to join (this includes Vanilla clients!)
However, if a client does have the mod, they will have access to more features such as the /geotool map, which would not be possible without the mod installed.
Warning
As the Earth is quite big, all relevant data cannot be stored within the mod files (this would take up 100s of gigabytes!). Data is instead downloaded as needed and later cached for later use. This does unfortunately mean that the mod will need an internet connection when visiting new places. Depending on internet speed, you may unfortunately experience lag while this data downloads. The mod does its best to counteract this lag, however. Once a part of the dataset is downloaded, it is cached locally so that it can be loaded again quickly in the future. You can also preload world data through the /geotool command.
Data Attribution
Terrarium makes use of a large range of data sources which have been reprocessed for the purpose of this mod:
Available Versions
How to Install Terrarium on Your Server
Order Server
Order a Minecraft Java server with at least 4 GB RAM (6 GB recommended).
Set forge Loader
In the panel under "Egg", select the forge loader and matching Minecraft version (1.12.2).
Install Mod
Open the mod browser in the dashboard and search for "Terrarium". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.12.2
Server-side
✓ RequiredRecommended RAM
6 GB(min. 4 GB)Frequently Asked Questions
Terrarium server crashes on startup – what to do?
Most common cause: wrong forge version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 4 GB RAM is allocated and the loader matches the mod version (1.12.2). You can switch loaders with one click in the panel.
Is Terrarium compatible with forge?
Terrarium officially supports forge for Minecraft 1.12.2. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with Terrarium – how to optimize performance?
Recommended RAM: 6 GB (per 5 players). Use /spark profiler to check if Terrarium consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Similar Mods
Rent Modded Server
Install Terrarium with just one click on your server.