Terrarium

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:terrarium` for servers, singleplayer, select earth when creating world and choose customize to change settings per world.

---

🌐 Terrain Data Pipeline

- Tile System: AWS S3 (`elevation-tiles-prod/terrarium/{zoom}/{x}/{y}.png`) - Tile System Personal Source Hosted on GitHub, I compiled this using QGIS. (`clim-monthly/{month}/{zoom}/{x}/{y}`) Tile System - Tile System: 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

- 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`: ```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 }