godot-voxel
A C++ module for creating real-time editable volumetric terrains in the Godot Engine 4.
What is godot-voxel?
Zylann/godot_voxel, also known as Voxel Tools for Godot, is a C++ module/extension for Godot Engine 4 that enables the creation of volumetric, editable 3D terrains. It solves the limitations of traditional heightmap-based terrains by allowing developers to build dynamic worlds with features like overhangs, tunnels, and real-time user modification. The toolkit provides efficient rendering, physics integration, and support for both blocky and smooth voxel terrains.
Godot Engine 4 developers and game creators who need to implement complex, interactive 3D environments such as sandbox games, exploration titles, or simulations requiring destructible or modifiable terrain. It is suited for those comfortable with C++ modules or GDExtension in Godot.
Developers choose this module for its deep integration with Godot 4, offering real-time editable volumetric terrain beyond basic heightmaps, with features like infinite chunk-based worlds, flexible data streaming, and support for both Minecraft-style blocky and smooth LOD terrains. Its community-driven, non-profit nature ensures a focus on extensibility and practical game development needs.
Overview
Voxel module for Godot Engine
Use Cases
Best For
- Building sandbox or crafting games with destructible and constructible environments, similar to Minecraft.
- Creating exploration or adventure games with vast, seamless infinite terrains that require chunk paging.
- Developing simulations or educational tools that need real-time terrain editing, such as tunnels or overhangs.
- Implementing performance-optimized voxel worlds with level of detail (LOD) for smooth terrain using Transvoxel.
- Adding detailed environmental decoration through an instancing system for foliage, rocks, and other assets.
- Streaming voxel data from custom generators or external sources for dynamic world generation.
Not Ideal For
- Projects needing simple, static terrain without real-time editing—Godot's built-in heightmap systems are more straightforward.
- Teams seeking a drag-and-drop voxel solution with no compilation—this requires building from source or managing GDExtension.
- Games requiring built-in multiplayer synchronization for voxel edits—the roadmap lists this as work-in-progress.
- Developers prioritizing out-of-the-box textured voxel rendering—smooth voxel texturing is noted as an area of interest, not fully implemented.
Pros & Cons
Pros
Enables in-game terrain creation and destruction with overhangs and tunnels, going beyond heightmap limitations as highlighted in the features list.
Uses polygon-based chunked meshes and Transvoxel for LOD on smooth terrain, optimizing performance for infinite worlds through paging.
Seamlessly integrates with Godot's physics and offers fast Minecraft-like collisions, making it practical for game development without extra middleware.
Supports custom generators and various data sources, allowing dynamic world generation tailored to specific needs, as mentioned in the flexible data sources feature.
As a non-profit, community-driven project with regular updates and a list of supporters, it ensures ongoing improvements and reliable support.
Cons
Requires compiling a C++ module or using GDExtension builds, which is more involved than plug-and-play assets and can be daunting for beginners.
Key features like multiplayer synchronization and smooth voxel texturing are still in development, as per the roadmap, limiting out-of-the-box functionality.
Real-time voxel processing and mesh generation can be resource-heavy, potentially impacting frame rates on lower-end hardware or in dense scenes.
Customizing generators or advanced setups demands understanding both voxel concepts and Godot's extension system, with documentation that may have gaps.
Frequently Asked Questions
Related Projects
PixeloramaUnleash your creativity with Pixelorama, a powerful and accessible open-source pixel art multitool. Whether you want to create sprites, tiles, animations, or just express yourself in the language of pixel art, this software will realize your pixel-perfect dreams with a vast toolbox of features. Available on Windows, Linux, macOS and the Web!
Godot Demo ProjectsDemonstration and Template Projects
LorienInfinite canvas drawing/whiteboarding app for Windows, Linux and macOS. Made with Godot.
Dialogic💬 Create Dialogs, Visual Novels, RPGs, and manage Characters with Godot to create your Game!
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.