Repolode
Zylann

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. 1

    Read the installation guide

  2. 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