An editable, high-performance terrain system addon for the Godot 4 game engine, written as a C++ GDExtension.
Zylann/godot_voxel
A C++ module for Godot 4 that builds editable, chunked volumetric voxel terrains with blocky or smooth rendering.
- Stars
- 4,118
- Forks
- 383
- Open issues
- 252
- Last commit
- 6 hours ago
What is it?
Voxel Tools adds volumetric terrain to Godot Engine 4 as a C++ module or extension. Unlike heightmap-based terrain, voxel data can represent overhangs, tunnels, and caves, and players can dig or build at runtime.
The voxel data is converted into chunked meshes that are paged in and out, which makes infinite worlds possible. Terrain can be generated procedurally through custom generators or streamed from other sources. Storage uses 8-bit or 16-bit channels for general-purpose data.
Rendering offers two styles: Minecraft-like blocky terrain with multiple materials and baked ambient occlusion, and smooth terrain with level of detail via Transvoxel. An instancing system places foliage, rocks, and other decoration on surfaces, and the module integrates with Godot physics as well as a faster block-based collision option.
Key features
- 01Realtime terrain editing in-game, supporting overhangs, tunnels, and player-driven digging and building
- 02Chunked meshes with paging, enabling infinite terrains
- 03Blocky voxel rendering with multiple materials and baked ambient occlusion
- 04Smooth terrain with level of detail using Transvoxel
- 05Instancing system for foliage, rocks, and decoration
- 06Godot physics integration plus a fast Minecraft-style collision option
Use cases
- Building voxel-based survival or sandbox games with destructible terrain in Godot
- Creating large procedurally generated open worlds that stream chunks as the player moves
- Prototyping Minecraft-like block worlds or smooth organic terrain inside Godot 4
Quick start
- 1
Read the installation guide
- 2
Follow the quick start guide
Things to know
- GDExtension support is still on the roadmap, so the module build is the main supported path.
In collections
Topics
FAQ
- What is godot_voxel?
- A C++ module for Godot 4 that builds editable, chunked volumetric voxel terrains with blocky or smooth rendering. Voxel Tools adds volumetric terrain to Godot Engine 4 as a C++ module or extension. Unlike heightmap-based terrain, voxel data can represent overhangs, tunnels, and caves, and players can dig or build at runtime.
- Is godot_voxel free to use? What license does it have?
- godot_voxel is open source under the MIT license. Check the license terms before using it in commercial products.
- Is godot_voxel still maintained?
- Actively maintained. The last commit to godot_voxel was on Nov 7, 2026.
- What can I use godot_voxel for?
- Building voxel-based survival or sandbox games with destructible terrain in Godot Creating large procedurally generated open worlds that stream chunks as the player moves Prototyping Minecraft-like block worlds or smooth organic terrain inside Godot 4
- How do I install godot_voxel?
- Read the installation guide Follow the quick start guide
- Where can I get godot_voxel?
- The source code and installation instructions are on GitHub: https://github.com/Zylann/godot_voxel
Summary generated by AI from the project's README. GitHub stats refresh daily.
Related projects
A generator that has Claude Code or Codex autonomously build complete Godot, Bevy, Babylon.js or three.js games, including assets and proof recordings.
An open-source voxel action-adventure RPG set in a vast fantasy world, written in Rust and inspired by Cube World and Breath of the Wild.
A Minecraft-inspired 3D voxel sandbox game written in Zig, with far view distances, unlimited vertical chunks and procedural crafting.
A browser-based 3D voxel world editor for building, sculpting, flying through, and sharing small worlds.
Godot is a free, MIT-licensed, cross-platform game engine for building 2D and 3D games from one unified editor.