# Terrarium
\n**Pixel-Perfect Earth Terrain for Minecraft** <\/p>\n
Generate pixel-perfect worlds from real elevation data, with dynamic tile loading and customizable terrain shaping.
\n– World type is `terrarium:terrarium` for servers, singleplayer, select earth when creating world and choose customize to change settings per world.<\/p>\n
—<\/p>\n
## \ud83c\udf10 Terrain Data Pipeline
\n– **Source**: AWS S3 (`elevation-tiles-prod\/terrarium\/{zoom}\/{x}\/{y}.png`)
\n– **Temperature and Precipitation** Personal Source Hosted on GitHub, I compiled this using QGIS. (`clim-monthly\/{month}\/{zoom}\/{x}\/{y}`) **This is a temporary hosting solution**
\n– **Pixel-to-Block**: 1 pixel = 1 Minecraft block.
\n– **Tile System**:
\n – Each tile = `256\u00d7256` pixels (`256\u00d7256` blocks ingame).
\n – `zoom` level determines tile count per axis (`2^zoom` tiles).
\n – Example: `zoom: 8` = `2\u2078 = 256` tiles \u2192 `256\u00d7256 = 65,536` blocks wide. <\/p>\n
—<\/p>\n
## \ud83d\uddc3\ufe0f Downloads
\n– You can download indev test versions here
\n– Support is not guarunteed for those, only alphas, betas, and releases
\n– FabricAPI is required
\n—<\/p>\n
## \ud83c\udfd4\ufe0f Technical Notes
\n– **Scale Examples**:
\n – zoom: 10 = 1,024 tiles \u2192 262,144\u00d7262,144 blocks.
\n – zoom: 13 = 8,192 tiles \u2192 2,097,152\u00d72,097,152 blocks.<\/p>\n
### \ud83c\udf29\ufe0f Performance:
\n– Higher zoom = larger worlds but slower generation.
\n– Reduce zoom to 8\u201310 for survival-friendly sizes.
\n### World Size Comparison
\n– zoom: 10 (small – ~1:48) vs. zoom: 13 (planetary-scale – ~1:6).
\n### \ud83d\uddbc\ufe0f Screenshots:<\/p>\n
– Taken with v0.0.2-beta.2 + Bliss\/Photon + WWOO<\/p>\n
**Zoom: 13 | Height 768**<\/p>\n
—
\n
\n
\n<\/p>\n
—
\n## \ud83d\udee0\ufe0f How It Works
\n– Tile Fetching: Downloads 256\u00d7256 PNG tiles from AWS based on zoom and caches.
\n– Height Mapping: Converts RGB pixels to block heights, scaled by additionalAlt.
\n– Biome Placement: Vanilla biomes mapped using elevation (startingY + altitudeDropoff).<\/p>\n
## \ud83d\udd27 **Configuration**
\n<\/p>\n
`\/config\/BlossomMods\/Terrarium.json`:
\n“`json
\n{
\n “ELEVATION_URL”: “https:\/\/s3.amazonaws.com\/elevation-tiles-prod\/terrarium\/”, \/\/elevation data source
\n “TEMPERATURE_URL”: “https:\/\/raw.githubusercontent.com\/ly-nxs\/terrarium-data\/refs\/heads\/main\/tiles\/climate-monthly\/”, \/\/climate data source
\n “CACHE_DIR”: “.\/tiles”, \/\/tile cache dir
\n}<\/p>\n","protected":false},"excerpt":{"rendered":"
Earth in Minecraft – Configurable! Spiritual successor to Terra 1:1<\/p>\n","protected":false},"featured_media":153352,"template":"","meta":{"_minecraft_slug":"terrarium-earth","_minecraft_project_id":"4CLlfD1y","_minecraft_author":"lynxs","_minecraft_license":"CC-BY-NC-SA-4.0","_minecraft_downloads":20411,"_minecraft_follows":193,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"terrarium-earth.zip","_minecraft_size_bytes":2101898,"_minecraft_version_count":26,"_minecraft_updated_at":"2026-05-16T20:36:37.869327Z","_minecraft_date_created":"2025-04-04T00:07:23.524704Z","_minecraft_date_modified":"2025-10-26T20:42:34.535282Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/terrarium-earth","_minecraft_icon_attachment_id":153352,"_minecraft_imported_at":"2026-06-09T06:59:03+00:00","_minecraft_import_hash":"c44f34fc87719253427d4c92549ae077","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,43,156,97,158,90,867,91,123,869,92,159],"mod_loader":[99,160],"minecraft_version":[59,36,60,93,94,101,102,62,37,73,74,38,78,79,80,81],"class_list":["post-153351","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-cursed","mod_category-decoration","mod_category-fabric","mod_category-neoforge","mod_category-optimization","mod_category-social","mod_category-storage","mod_category-technology","mod_category-transportation","mod_category-utility","mod_category-worldgen","mod_loader-fabric","mod_loader-neoforge","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8"],"yoast_head":"\n