voxel/README.md

Voxel Engine Reference

C# / OpenTK 4 Voxel Engine (Minecraft clone).

Core Systems

• Rendering: SSBO-based (Shader Storage Buffer Objects) for packed face data and GPU meshing.
• Data: 1D Flat arrays for blocks, bitwise indexing for speed.
• Updates: Dirty-flagging for chunk and neighbor mesh rebuilding.

Key Links

• Collision & AABB - Voxel-specific physics resolution.
• Minecraft Jump Physics - Movement constants and logic.
• OpenTK Learn - OpenGL bindings and setup.

Performance Notes

• Use UpdateNeighborsAtBoundary to mark adjacent chunks dirty.
• Call RebuildDirtyChunks at the end of the update loop.
• Avoid per-block GL.BufferSubData calls, batch into one SSBO update.