Terrarium
Pixel-Perfect Earth Terrain for Minecraft
Generate pixel-perfect worlds from real elevation data, with dynamic tile loading and customizable terrain shaping.
- World type is
terrarium:terrariumfor servers, singleplayer, select earth when creating world and choose customize to change settings per world.
đ Terrain Data Pipeline
- Source: AWS S3 (
elevation-tiles-prod/terrarium/{zoom}/{x}/{y}.png) - 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 - Pixel-to-Block: 1 pixel = 1 Minecraft block.
- Tile System:
- Each tile =
256Ã256pixels (256Ã256blocks ingame). zoomlevel determines tile count per axis (2^zoomtiles).- Example:
zoom: 8=2⸠= 256tiles â256Ã256 = 65,536blocks wide.
- Example:
- Each tile =
đī¸ Downloads
- You can download indev test versions here
- Support is not guarunteed for those, only alphas, betas, and releases
- FabricAPI is required
đī¸ Technical Notes
- Scale Examples:
- zoom: 10 = 1,024 tiles â 262,144Ã262,144 blocks.
- zoom: 13 = 8,192 tiles â 2,097,152Ã2,097,152 blocks.
đŠī¸ Performance:
- Higher zoom = larger worlds but slower generation.
- Reduce zoom to 8â10 for survival-friendly sizes.
World Size Comparison
- zoom: 10 (small - ~1:48) vs. zoom: 13 (planetary-scale - ~1:6).
đŧī¸ Screenshots:
- Taken with v0.0.2-beta.2 + Bliss/Photon + WWOO
Zoom: 13 | Height 768
đ ī¸ How It Works
- Tile Fetching: Downloads 256Ã256 PNG tiles from AWS based on zoom and caches.
- Height Mapping: Converts RGB pixels to block heights, scaled by additionalAlt.
- Biome Placement: Vanilla biomes mapped using elevation (startingY + altitudeDropoff).
đ§ Configuration
/config/BlossomMods/Terrarium.json:
{
"ELEVATION_URL": "https://s3.amazonaws.com/elevation-tiles-prod/terrarium/", //elevation data source
"TEMPERATURE_URL": "https://raw.githubusercontent.com/ly-nxs/terrarium-data/refs/heads/main/tiles/climate-monthly/", //climate data source
"CACHE_DIR": "./tiles", //tile cache dir
}
| Version | Minecraft | Loader | Download |
|---|---|---|---|
|
Terrarium 0.0.6 0.0.6 |
1.21.7, 1.21.8
|
fabric
|
Download |
|
Terrarium 0.0.5 0.0.5 |
1.21.7, 1.21.8
|
neoforge
|
Download |
|
Terrarium 0.0.5 0.0.5 |
1.21.7, 1.21.8
|
fabric
|
Download |
|
Terrarium 0.0.4-alpha.2 0.0.4-alpha.2 |
1.21.6, 1.21.7, 1.21.8
|
fabric
|
Download |
|
Terrarium 0.0.4-alpha.1 0.0.4-alpha.1 |
1.21.6, 1.21.7, 1.21.8
|
fabric, neoforge
|
Download |
|
Terrarium 0.0.4-alpha.1 0.0.4-alpha.1 |
1.21, 1.21.1
|
fabric, neoforge
|
Download |
|
Terrarium 0.0.3-beta.3+1.20.1 0.0.3-beta.3+1.20.1 |
1.21, 1.21.1
|
fabric
|
Download |
|
Terrarium 0.0.3-beta.2+1.21.1 0.0.3-beta.2+1.21.1 |
1.21, 1.21.1
|
fabric
|
Download |
|
Terrarium 0.0.3-beta.1+1.21.5 0.0.3-beta.1+1.21.5 |
1.21.5
|
fabric
|
Download |
|
Terrarium 0.0.3-beta.1+1.21.4 0.0.3-beta.1+1.21.4 |
1.21.4
|
fabric
|
Download |
|
Terrarium 0.0.3-beta.1+1.21.2 0.0.3-beta.1+1.21.2 |
1.21.2, 1.21.3
|
fabric
|
Download |
|
Terrarium 0.0.3-beta.1+1.21.1 0.0.3-beta.1+1.21.1 |
1.21, 1.21.1
|
fabric
|
Download |
|
Terrarium 0.0.3-beta.1+1.20.1 0.0.3-beta.1+1.20.1 |
1.20, 1.20.1, 1.20.2
|
fabric
|
Download |
|
Terrarium 0.0.2-beta.3 0.0.2-beta.3 |
1.21.5
|
fabric
|
Download |
|
Terrarium 0.0.2-release.2 0.0.2-release.2 |
1.20.1
|
fabric
|
Download |
|
Terrarium 0.0.2-release.2 0.0.2-release.2 |
1.20.2, 1.20.3, 1.20.4
|
fabric
|
Download |
|
Terrarium 0.0.2-release.2 0.0.2-release.2 |
1.20.5, 1.20.6
|
fabric
|
Download |
|
Terrarium 0.0.2-release.2 0.0.2-release.2 |
1.21.5
|
fabric
|
Download |
|
Terrarium 0.0.2-release.2 0.0.2-release.2 |
1.21.2, 1.21.3, 1.21.4
|
fabric
|
Download |
|
Terrarium 0.0.2-release.2 0.0.2-release.2 |
1.21, 1.21.1
|
fabric
|
Download |
|
Terrarium 0.0.2-release.1 0.0.2-release.1 |
1.21, 1.21.1
|
fabric
|
Download |
|
Terrarium 0.0.2-beta.2 0.0.2-beta.2 |
1.21, 1.21.1
|
fabric
|
Download |
|
Terrarium 0.0.2-beta.1 0.0.2-beta.1 |
1.21, 1.21.1
|
fabric
|
Download |
|
Terrarium 0.0.2-alpha.4 0.0.2-alpha.4 |
1.21, 1.21.1
|
fabric
|
Download |
|
Terrarium 0.0.2-alpha.3-hotfix 0.0.2-alpha.3-hotfix |
1.21, 1.21.1
|
fabric
|
Download |
|
Terrarium 0.0.2-alpha.3 0.0.2-alpha.3 |
1.21, 1.21.1
|
fabric
|
Download |
|
Terrarium 0.0.2-alpha.2 0.0.2-alpha.2 |
1.21, 1.21.1
|
fabric
|
Download |
|
Terrarium 0.0.2-alpha.1 0.0.2-alpha.1 |
1.21, 1.21.1
|
fabric
|
Download |