tsokasgit/primitive-voxels-godot

TerraForge is a technical prototype for the Godot 4 game engine that generates smooth, diggable 3D terrain out of voxels, which are like tiny 3D building blocks. Unlike blocky Minecraft style voxel worlds, it uses a technique called Marching Cubes to turn those blocks into smooth rolling hills, mountains, and cave systems instead of visibly square shapes. The world is built from chunks, sections of terrain that load in and unload automatically as a player or camera moves around, so the whole world does not need to be generated at once. Generating each chunk's shape happens on background threads rather than the main game thread, which keeps the game running smoothly while new terrain streams in around the player. Everything is generated from a seed number, so the same seed reproduces the same terrain layout, cave networks, mountains, deserts, and paths every time, while a different seed produces a different world. The terrain includes procedurally placed cave tunnels, connected underground rooms, and cave entrances, along with above ground biomes like grass, sand, clay, stone, and volcanic rock, each with its own texture. Players, or a debug camera included for testing, can dig into the terrain in real time using a spherical digging tool, which updates the affected area's shape and rebuilds its collision so the game world reacts immediately. The project ships as a Godot project you open directly in the Godot 4 editor, using the GDScript language that Godot projects are typically written in. To try it, you clone the repository, open it in Godot 4, open the included demo scene, and press play to fly around the generated world with a free-moving debug camera using WASD keys and the mouse. The README describes this as a technical prototype rather than a finished game, and does not state what license the project is released under.