Terrarium: World

Terrarium

Pixel-Perfect Earth Terrain for Minecraft

Generate pixel-perfect worlds from real elevation data, with dynamic tile loading and customizable terrain shaping.

🌐 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×256 pixels (256×256 blocks ingame).
  • zoom level determines tile count per axis (2^zoom tiles).
  • Example: zoom: 8 = 2⁸ = 256 tiles → 256×256 = 65,536 blocks wide.

🗃️ Downloads

• While it is still at Alpha quality, you can download indev test versions here
• Support is not guarunteed

– BlossomLib is required, and FabricAPI

🏔️ 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.1 + Conquest Reforged + Photon/UShader

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:
“`json
{
“zoom”: 13, // 2¹³ tiles = 8,192 tiles wide (≈2M blocks at 256px/tile).
“worldHeight”: 768, // Max Y height.
“startingY”: 0, // Base height offset (negative for deeper oceans).
“adjustXoffset”: 400000, // Where on the map the world should generate: spawn location essentially!
“adjustZoffset”: 800000,
“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
“month”: 0, //month for climate data, currently only january – 0, and february – 1
“noise_biome_scale”: 0.01 //scale for biome noise factor
}