How fluidtag/voxel-engine works
This is a Java voxel game: the player moves through a procedurally generated world, interacts with blocks and inventory, and sees the result rendered in a window. The visible runtime path starts in App, which creates the world, camera, engine, and player and advances ticks; World coordinates chunk work, while Engine and its render/UI helpers present the scene. The map retains distinct terrain, decoration, lighting, meshing, gameplay, and graphics responsibilities. Some subsystem links rely on SOURCE INDEX references or are omitted where the excerpts do not establish who invokes whom.
Main entry points: App.java Game application · World.java World and chunk scheduling · Engine.java Game engine · PlayerCharacter.java Player character
Components 26
Player gameplay
- Player character
src/main/java/com/szymc/voxel_engine/PlayerCharacter.java - Dropped items
src/main/java/com/szymc/voxel_engine/EntityItem.java - Block definitions
src/main/java/com/szymc/voxel_engine/Blocks.java - Inventory and crafting
src/main/java/com/szymc/voxel_engine/Engine.java
World generation
- Biome registry
src/main/java/com/szymc/voxel_engine/BiomeRegistry.java - Noise functions
src/main/java/com/szymc/voxel_engine/FastNoiseLite.java - Terrain generation
src/main/java/com/szymc/voxel_engine/TerrainTask.java - Terrain decoration
src/main/java/com/szymc/voxel_engine/DecorationTask.java
Chunk processing
- Chunk columns
src/main/java/com/szymc/voxel_engine/ChunkColumn.java - Chunk sections and palette
src/main/java/com/szymc/voxel_engine/ChunkSection.java - Chunk lighting
src/main/java/com/szymc/voxel_engine/LightingTask.java - Greedy meshing
src/main/java/com/szymc/voxel_engine/GreedyMesher.java - Mesh task
src/main/java/com/szymc/voxel_engine/MeshTask.java
Rendering and UI
- GPU mesh
src/main/java/com/szymc/voxel_engine/Mesh.java - Textures and game data
src/main/java/com/szymc/voxel_engine/Texture.java - Shader programs
src/main/java/com/szymc/localShaders/Shader.java - World shader
src/main/java/com/szymc/localShaders/WorldShader.java - Entity shader
src/main/java/com/szymc/localShaders/EntityShader.java - UI renderer
src/main/java/com/szymc/voxel_engine/UIRenderer.java - Debug display
src/main/java/com/szymc/voxel_engine/DebugManager.java
Runtime coordination
- World and chunk scheduling
src/main/java/com/szymc/voxel_engine/World.java - Camera
src/main/java/com/szymc/voxel_engine/Camera.java - Game engine
src/main/java/com/szymc/voxel_engine/Engine.java - Window
src/main/java/com/szymc/voxel_engine/Window.java - Game application
src/main/java/com/szymc/voxel_engine/App.java
Other components
- Player
Connections 40
- Player → Game application: starts
src/main/java/com/szymc/voxel_engine/App.java - Game application → World and chunk scheduling: creates
src/main/java/com/szymc/voxel_engine/App.java - Game application → Camera: creates
src/main/java/com/szymc/voxel_engine/App.java - Game application → Window: creates
src/main/java/com/szymc/voxel_engine/App.java - Game application → Game engine: creates
src/main/java/com/szymc/voxel_engine/App.java - Game application → Player character: creates
src/main/java/com/szymc/voxel_engine/App.java - Game application → World and chunk scheduling: ticks
src/main/java/com/szymc/voxel_engine/App.java - Game application → Dropped items: updates
src/main/java/com/szymc/voxel_engine/App.java - Game application → Biome registry: initializes
src/main/java/com/szymc/voxel_engine/App.java - World and chunk scheduling → Terrain generation: schedules
src/main/java/com/szymc/voxel_engine/World.java - World and chunk scheduling → Terrain decoration: schedules
src/main/java/com/szymc/voxel_engine/World.java - World and chunk scheduling → Chunk lighting: schedules
src/main/java/com/szymc/voxel_engine/World.java - World and chunk scheduling → Mesh task: schedules
src/main/java/com/szymc/voxel_engine/World.java - Terrain generation → Noise functions: samples
src/main/java/com/szymc/voxel_engine/TerrainTask.java - Terrain generation → Biome registry: selects
src/main/java/com/szymc/voxel_engine/TerrainTask.java - Terrain generation → Chunk columns: generates
src/main/java/com/szymc/voxel_engine/TerrainTask.java - Terrain decoration → Chunk columns: decorates
src/main/java/com/szymc/voxel_engine/DecorationTask.java - World and chunk scheduling → Chunk columns: manages
src/main/java/com/szymc/voxel_engine/World.java - Chunk columns → Chunk sections and palette: contains data
src/main/java/com/szymc/voxel_engine/ChunkColumn.java - Mesh task → Greedy meshing: requests mesh data
src/main/java/com/szymc/voxel_engine/MeshTask.java - Greedy meshing → Chunk sections and palette: reads blocks
src/main/java/com/szymc/voxel_engine/GreedyMesher.java - Chunk sections and palette → Greedy meshing: generates mesh data
src/main/java/com/szymc/voxel_engine/ChunkSection.java - World and chunk scheduling → Player character: serves world queries
src/main/java/com/szymc/voxel_engine/PlayerCharacter.java - Player character → Camera: reads view
src/main/java/com/szymc/voxel_engine/PlayerCharacter.java - Player character → Game engine: requests interactions
src/main/java/com/szymc/voxel_engine/PlayerCharacter.java - Player character → Chunk columns: edits blocks
src/main/java/com/szymc/voxel_engine/PlayerCharacter.java - Game engine → Inventory and crafting: manages
src/main/java/com/szymc/voxel_engine/Engine.java - Game engine → World shader: renders world
src/main/java/com/szymc/voxel_engine/Engine.java - Game engine → Entity shader: renders entities
src/main/java/com/szymc/voxel_engine/Engine.java - Game engine → Debug display: updates display
src/main/java/com/szymc/voxel_engine/Engine.java - Game engine → UI renderer: renders interface
src/main/java/com/szymc/voxel_engine/Engine.java - World shader → Shader programs: extends
src/main/java/com/szymc/localShaders/WorldShader.java - Entity shader → Shader programs: extends
src/main/java/com/szymc/localShaders/EntityShader.java - World shader → Textures and game data: uses
src/main/java/com/szymc/localShaders/WorldShader.java - Entity shader → Textures and game data: uses
src/main/java/com/szymc/localShaders/EntityShader.java - UI renderer → Textures and game data: uses
src/main/java/com/szymc/voxel_engine/UIRenderer.java - UI renderer → Shader programs: uses
src/main/java/com/szymc/voxel_engine/UIRenderer.java - Textures and game data → Block definitions: loads definitions
src/main/java/com/szymc/voxel_engine/Engine.java - Mesh task → GPU mesh: creates GPU mesh
- Game engine → GPU mesh: draws meshes