Mods & tools

Voxel Earth

A server plugin and pipeline that converts and streams Google Photorealistic 3D Tiles into voxelized Minecraft worlds.

Voxel Earth

Overview

Voxel Earth is a complete pipeline and Minecraft plugin ecosystem designed to convert real-world photogrammetry and 3D Tiles into block-based environments. By pulling data from sources like Google Photorealistic 3D Tiles, the tool normalizes real-world geometry and translates it into standard Minecraft block palettes. This process allows players to explore actual cities, mountain ranges, and landmarks in the game.

The system features on-demand streaming that generates the environment dynamically as players move through the world. Instead of requiring a pre-loaded static map, tiles are fetched and converted into voxelized chunks in real time as you walk around. In addition to the in-game implementation, the project includes a web client for browser-based previews and testing.

Pipeline Architecture and Performance

The conversion process relies entirely on CPU voxelization, meaning the host server does not need a dedicated GPU to generate terrain. The plugin is packaged as a single shaded JAR file that handles the heavy lifting on the processor. It is built to integrate asynchronously with FastAsyncWorldEdit (FAWE) to achieve high-throughput block placement as chunks load.

Each stage of the workflow is available both as embedded code within the plugin and as an independent command-line interface (CLI) tool. The three distinct phases cover tile downloading, Draco decoding, and CPU voxelization. Separating these components allows developers to test and verify individual stages locally before running the unified system on a live server.

Server Requirements and Compatibility

Running the VoxelEarth 1.0 plugin requires a Paper or Spigot server running version 1.20.4 or newer, alongside Java 21 or higher. Because the plugin is compiled specifically against the 1.20.4 API, its block placement behavior depends on the exact server version you choose to host.

On Paper or Spigot 1.20.4, the plugin can operate standalone or alongside FastAsyncWorldEdit. If FAWE is detected on a 1.20.4 server, Voxel Earth utilizes it for rapid bulk edits, but it will automatically revert to an internal BlockPlacer method if FAWE is absent. For any other 1.20+ server version, installing a compatible build of FAWE (such as version 2.12.3) is strongly recommended to bridge API differences and maintain asynchronous world editing.

How to install

  1. Stop your Paper/Spigot server.
  2. Put the .jar file into the plugins folder.
  3. Start the server and edit the config it creates.

Similar