git404hub

what is primitive-voxels-godot fr?

tsokasgit/primitive-voxels-godot — explained in plain English

Analysis updated 2026-05-18

1GDScriptAudience · developerComplexity · 3/5Setup · easy

tl;dr

A Godot 4 prototype that generates smooth, diggable voxel terrain with caves, mountains, and biomes using the Marching Cubes technique.

vibe map

mindmap
  root((TerraForge))
    What it does
      Smooth voxel terrain
      Caves and mountains
      Runtime digging
    Tech stack
      GDScript
      Godot 4
      Marching Cubes
    Use cases
      Explore generated world
      Study voxel meshing
      Prototype open worlds
    Audience
      Godot developers
      Game dev learners

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Explore a procedurally generated 3D voxel world with mountains, caves, and biomes in Godot.

VIBE 2

Dig into terrain in real time and watch the mesh and collision rebuild instantly.

VIBE 3

Study a working Marching Cubes implementation in GDScript as a reference for your own voxel game.

VIBE 4

Use the threaded chunk streaming system as a starting point for an open-world game project.

what's the stack?

GDScriptGodot

how it stacks up fr

tsokasgit/primitive-voxels-godothughdunc/fakenoodlecharlesbalcony/vibe-code-games-companion
Stars110
LanguageGDScriptGDScriptGDScript
Setup difficultyeasyeasyeasy
Complexity3/51/52/5
Audiencedevelopergeneralvibe coder

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 5min

Requires the Godot 4 editor installed to open and run the project.

in plain english

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.

prompts (copy fr)

prompt 1
Help me clone this repo and get the TerraForge demo scene running in Godot 4.
prompt 2
Explain how the Marching Cubes algorithm in voxel_mesher.gd turns density values into a smooth mesh.
prompt 3
Show me how the chunk streaming system in voxel_world.gd decides which chunks to load or unload.
prompt 4
Walk me through how runtime digging modifies voxel density and rebuilds chunk collision.

Frequently asked questions

what is primitive-voxels-godot fr?

A Godot 4 prototype that generates smooth, diggable voxel terrain with caves, mountains, and biomes using the Marching Cubes technique.

What language is primitive-voxels-godot written in?

Mainly GDScript. The stack also includes GDScript, Godot.

How hard is primitive-voxels-godot to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is primitive-voxels-godot for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.