# Terrarium Expanded<\/p>\n
Bring the Earth into Minecraft with real-world terrain, biome-driven landcover, and configurable world scale.<\/p>\n
Terrarium Expanded includes integrations for:<\/p>\n
– Biomes O’ Plenty
\n– Regions Unexplored
\n– Nature’s Spirit
\n– Datapacks that increase the world’s minimum or maximum Y level<\/p>\n
> **Requirements**
\n> – Minecraft `1.21.1`
\n> – Java `21+`
\n> – A live internet connection during world generation and exploration
\n>
\n> **Terrarium Expanded fetches three live remote data sources:**
\n> – Terrain tiles
\n> – Surface-water tiles
\n> – Ecoregion tiles
\n>
\n> If those services are unavailable or blocked, world generation quality and completeness will degrade.<\/p>\n
## What The Mod Does<\/p>\n
Terrarium Expanded generates an Earth-shaped overworld from real map data instead of vanilla noise alone.<\/p>\n
– Terrain comes from AWS Terrarium elevation tiles.
\n– Land biomes come from reduced WWF ecoregion tiles.
\n– Inland water uses global surface-water seasonality data.
\n– Ocean biome temperature is tiered using bundled WOA23 sea-surface temperature data.<\/p>\n
You can also choose different zoom levels, which change the playable world’s total size and the approximate real-world distance represented by each block.<\/p>\n
## Screenshot Gallery<\/p>\n
Primary gallery below uses the vanilla biome integration at `z=10`.<\/p>\n
### San Francisco<\/p>\n
<\/p>\n
### Mt. Fuji<\/p>\n
<\/p>\n
### Strait of Gibraltar<\/p>\n
<\/p>\n
### Montreal<\/p>\n
<\/p>\n
### Grand Canyon<\/p>\n
<\/p>\n
More screenshots and alternate biome-integration galleries are indexed in documentation\/readme.md.<\/p>\n
## World Size \/ Zoom Levels<\/p>\n
Higher zoom means a much larger playable world with finer real-world detail, but also heavier generation cost and more remote tile fetches.<\/p>\n
| Zoom | World Size (blocks) | Approx. Scale | Guidance |
\n| — | — | — | — |
\n| `8` | `65,536 x 65,536` | `~611.50 m\/block` | Broad regional scale, fastest option |
\n| `9` | `131,072 x 131,072` | `~305.75 m\/block` | Large world, lighter runtime cost |
\n| `10` | `262,144 x 262,144` | `~152.87 m\/block` | Good default balance for exploration |
\n| `11` | `524,288 x 524,288` | `~76.44 m\/block` | Finer terrain detail, heavier generation |
\n| `12` | `1,048,576 x 1,048,576` | `~38.22 m\/block` | Maximum scale and detail, slowest uncached exploration |<\/p>\n
## Requirements<\/p>\n
– Minecraft `1.21.1`
\n– Java `21+`
\n– Internet access while generating or exploring Earth worlds<\/p>\n
The mod depends on live requests for:<\/p>\n
– terrain tiles
\n– surface-water tiles
\n– ecoregion tiles<\/p>\n
These datasets are configurable in the Earth preset editor, but the default experience assumes the public tile services are reachable.<\/p>\n
## Performance Expectations<\/p>\n
Performance can be poor when the game has to generate many chunks quickly or enter uncached regions for the first time.<\/p>\n
– Generating many new chunks in a short period may be slow.
\n– Entering uncached regions may stutter while remote data is fetched and stored in the local cache.
\n– Higher zoom levels are the most expensive.
\n– First-time exploration is usually the worst-case path.<\/p>\n
As the world generates, downloaded terrain, surface-water, and ecoregion files are written into a local cache. You can delete this cache at any time without breaking the world, but future generation will be slower until the files are downloaded again.<\/p>\n
Once tiles are cached locally, revisiting the same regions should be smoother.<\/p>\n
## Data Sources<\/p>\n
Terrarium Expanded currently uses:<\/p>\n
– Terrarium elevation tiles for terrain height
\n– Global surface-water seasonality tiles for inland water detection
\n– Reduced WWF ecoregion tiles for land biome selection
\n– WOA23 mean annual sea-surface temperature as a bundled runtime data layer for ocean biome tiering<\/p>\n
Default remote endpoints are currently configured as:<\/p>\n
– Terrain: `https:\/\/elevation-tiles-prod.s3.amazonaws.com\/terrarium`
\n– Ecoregions: `https:\/\/d127t6piqu53ls.cloudfront.net\/tiles-reduced`
\n– Surface water: `https:\/\/storage.googleapis.com\/global-surface-water\/tiles2021\/seasonality`<\/p>\n
## Current Caveats<\/p>\n
– AWS Terrarium source data can contain spikes or odd terrain artifacts.
\n– Those artifacts can become more noticeable at higher zoom levels.
\n– Remote-data availability directly affects first-time world generation quality and responsiveness.<\/p>\n
For implementation details, see documentation\/WORLDGEN.md.<\/p>\n
## Development \/ Local Build<\/p>\n
Build from the repo root with:<\/p>\n
“`powershell
\n.gradlew build
\n“`<\/p>\n
The project targets Architectury with both Fabric and NeoForge enabled.<\/p>\n","protected":false},"excerpt":{"rendered":"
Bring the Earth into Minecraft!<\/p>\n","protected":false},"featured_media":153354,"template":"","meta":{"_minecraft_slug":"terrarium-expanded","_minecraft_project_id":"xE01rhaj","_minecraft_author":"intplex","_minecraft_license":"MIT","_minecraft_downloads":230,"_minecraft_follows":5,"_minecraft_client_side":"optional","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"terrarium-expanded.zip","_minecraft_size_bytes":7716220,"_minecraft_version_count":22,"_minecraft_updated_at":"2026-05-16T14:43:56.397830Z","_minecraft_date_created":"2026-04-30T03:56:42.010349Z","_minecraft_date_modified":"2026-05-05T02:00:18.466243Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/terrarium-expanded","_minecraft_icon_attachment_id":153354,"_minecraft_imported_at":"2026-06-09T06:59:21+00:00","_minecraft_import_hash":"052a54c6f19bb26c9c6457df748eec30","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[97,158,159],"mod_loader":[99],"minecraft_version":[37,41],"class_list":["post-153353","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-fabric","mod_category-neoforge","mod_category-worldgen","mod_loader-fabric","minecraft_version-1-21-1","minecraft_version-1-21-11"],"yoast_head":"\n