Mods & tools

Tellus

A world generation mod that streams real-world elevation, climate biomes, roads, and buildings from geographic and OpenStreetMap datasets.

Tellus

Overview

Tellus is a Java Edition mod by yucareux that builds real-world terrain, roads, and buildings in real-time using open-source geographic datasets. The mod generates elevation using 30m global data (with finer detail in supported regions), places biomes based on actual climate zones, and creates cities and structures to form a voxelized version of Earth. It draws inspiration from Gegy's Terrarium. Because several biomes and survival features are still in development and future updates may break saves, the project is currently best used for exploration and testing rather than long-term survival.

An active internet connection is strictly required because the mod continuously streams land cover, climate, and elevation data as you explore. Downloaded information—including OpenStreetMap tiles, ESA WorldCover 2021 data, Koppen-Geiger climate maps, and AWS Terrain Tiles—is stored locally and can be cleared through the cache settings to free up disk space. For multiplayer use, the mod only needs to be installed on the server rather than on client machines. Since official server support is not yet finished, players should generate their world in singleplayer first and then transfer the save folder to a server running the mod.

World Scale and Generation Settings

Players can adjust the World Scale between 1:1m and 1:500m per block in the world creation menu, with future support planned for scales up to 1:40km. At a 1:1m scale, a single block represents one real-world meter (so a thousand blocks equal one kilometre), whereas a 1:500m scale compresses half a kilometre into each block (meaning two blocks equal one kilometre). A built-in preview screen lets you check these adjustments before generating the map. You can also configure terrestrial and oceanic height multipliers, vertical height offsets, sea level, altitude limits, and shoreline blending distances for rivers, lakes, and cliffs.

Geological and structure menus allow players to toggle underground caves, vanilla ore distribution, lava pools, and standard Minecraft structures. While villages, temples, monuments, and amethyst geodes can be enabled, certain elements like the Deep Dark and some ocean structures are still being developed and may not spawn reliably. Ecological options for land vegetation, tree density, aquatic plants, and village crops are visible in the menu but remain locked for a future update.

Real-Time Features, Navigation, and LOD Support

Optional real-time systems can synchronize your in-game daylight cycle and weather with live conditions at your current geographic coordinates. Using the `/tellus map` command opens a GeoTP interface that allows you to select and teleport to specific locations on Earth. Players and server operators with permission can also run `/tellus weather` to check local time and weather data, or use `/tellus config` commands to override the server's real-time clock and weather settings.

To view planet-scale landscapes beyond standard render distances, the mod integrates with Voxy and Distant Horizons. When using Distant Horizons, players can choose between an Approximate (Fast) mode that samples elevation, water, and climate data directly for rapid rendering without structures or accurate foliage, and a Detailed mode that uses slower full-chunk generation. An optional LOD Water Resolver can also be toggled to sample water depth for more accurate distant coastlines and ocean floors.

How to install

  1. Install the loader shown in the table (Fabric, Forge or NeoForge) for the same Minecraft version.
  2. Put the .jar file into .minecraft/mods.
  3. Start Minecraft with that loader profile.

Similar