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.
- 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 =
- You can download indev test versions here
- Support is not guarunteed for those, only alphas, betas, and releases
- FabricAPI is required
- Scale Examples:
- zoom: 10 = 1,024 tiles → 262,144×262,144 blocks.
- zoom: 13 = 8,192 tiles → 2,097,152×2,097,152 blocks.
- Higher zoom = larger worlds but slower generation.
- Reduce zoom to 8–10 for survival-friendly sizes.
- zoom: 10 (small - ~1:48) vs. zoom: 13 (planetary-scale - ~1:6).
- Taken with v0.0.2-beta.2 + Bliss/Photon + WWOO
Zoom: 13 | Height 768
- 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).
/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
}