VoxelEngine Documentation

What is VoxelEngine?

A voxel-based engine and editor built using Java and OpenGL.

This project is designed to provide a flexible and efficient platform for creating and manipulating voxel-based worlds, with a focus on performance and ease of use.

• Status: Early Development (v0.1.4 as of 09/03/2026)
• Package: org.bitwave.cubed
• Author(s): Lloyd, Kai

Features (v0.1.4)

• Added Phong shading.
  • Includes specular highlighting for improved visual quality.
  • Implemented normal mapping to enhance surface details without increasing geometry complexity.
• Improved performance by optimizing the rendering pipeline and reducing draw calls.
• Updated documentation to reflect new features and changes in the codebase.
• Fixed minor bugs related to lighting calculations and texture mapping.

Some of the modules in the engine include:

Getting Started

Pre-requisites

If you are a developer looking to contribute, you will need the following tools:

• Java Development Kit (JDK) 21 or higher
• An IDE of your choice (e.g., IntelliJ IDEA, Eclipse)
  • We recommend IntelliJ IDEA as that is what we’ve been using
• Git

We also recommend getting a Codeberg account and starring the repository to stay updated with the latest changes and releases!

git clone https://codeberg.org/BitWave/voxel-experiment.git

cd voxel-experiment

There should be a pre-made launch config with the name “Launch”

If not, you can manually make it with the following settings:

• Name: Launch
• Type: Application
• Main class: org.bitwave.cubed.Main
• Classpath: -cp voxel-experiment.main

Play the Demo