LuxEngine

A 3D game engine and editor you can read, build, and change.

LuxEngine is written in C++20 and renders with Vulkan through NVIDIA’s NRI. It has a deferred, clustered PBR renderer, Jolt physics, C# scripting and a docking editor. One person builds it, partly to learn how engines fit together. It isn’t production-ready, and it doesn’t pretend to be.

Language
C++20
Graphics
Vulkan, through NVIDIA NRI
Platforms
Windows, Linux
License
Apache-2.0
Status
In development

What works today.

The engine is early, so the list is specific. Everything here is in the code. The built-in audio and .NET 10 are in pull request 36, which is on its way into the dev branch.

Rendering
Deferred PBR with a G-buffer, and point and spot lights culled per froxel cluster before shading. Transparents draw in their own forward pass, with glass refraction. A render graph skips any pass whose feature is off.
Lights and shadows
Rect, disk, sphere and tube area lights, shaded with Linearly Transformed Cosines. Cascaded shadow maps for the sun, shadow maps for spot lights, and a Preetham sky or an HDR environment map for ambient light.
Image
GTAO, screen-space reflections, FFT convolution bloom and depth of field. Exposure is manual, EV100, a physical camera (aperture, shutter, ISO) or histogram auto-exposure, tonemapped with ACES or AgX.
Audio
A built-in engine on miniaudio. You author Sounds in the editor from clips and containers (random, sequence, layer, switch), group them into Sound Banks that load together, and mix them with buses, effects, snapshots and a reverb return. Soundwave, the engine’s own acoustics, muffles sound through walls by material, carries it around corners and through doorways, and measures each room’s reverb on the GPU.
Editor
A docking ImGui editor with gizmos, snapshot undo and redo with a History panel, a command palette, a content browser, a material editor, Beam for editing text files, a profiler and an audio debugger.
Scenes and prefabs
EnTT scenes with entity hierarchies and folders. Prefabs have variants that keep per-component overrides. Scenes save as YAML, and the editor can Play, Simulate and Stop them.
Physics
Jolt for 3D: rigid bodies, box, sphere, capsule, mesh and compound colliders, physics layers and a character controller. Box2D for 2D, with box and circle colliders only.
Scripting
C# on .NET 10 through Coral, with hot reload and inspectors driven by attributes like [Range] and [Tooltip]. Scripts can reach entities, transforms, input, assets and audio. Physics and renderer bindings don’t exist yet.
Assets and runtime
Assets are addressed by UUID. Meshes come in through Assimp. A project packs into binary asset and shader packs, and Lux-Runtime plays the packed project without the editor.

Not here yet: skeletal animation, game UI, particles, terrain, navigation and networking. No macOS, consoles or mobile, and no DirectX backend.

Read the full status

The road to 2027.1.

2027.1 is done when someone new to the engine can download one zip, install only the .NET SDK, and make and export a small 3D game and a small 2D game on Windows and on Linux: an animated character in a lit level, a menu and a HUD, sound, saved progress, and rebindable controls.

121 issues in the 2027.1 milestone: 13 must-haves, 27 wanted, 4 removals. Synced from the project board on .

Open the project board

Wanted27

If time allows in 2027.1

Wanted for the release, and the first things dropped if the must-haves run late.

Must-haves11

Not started yet

2027.1 does not ship without these. Expand the board to see each one's sub-issues.

In progress4

Being worked on now

Someone is working on these right now. Each card links to where it stands.

Shipped23

Merged, newest first

Pull requests and finished items from the board.

Showing 12 of 120.

Also on the board: 4 things to remove or hide before 2027.1: the empty PathTracing and Meshlets shader folders, the NRD denoiser (temporal by design), the unused simulation-thread scaffolding, and Discord integration in release builds. Open the full board on GitHub

Build it from source.

There’s no packaged build yet, so you build it yourself. You need a C++ toolchain, Python, the Vulkan SDK and .NET 10. Audio is built into the engine, so there’s nothing else to install.

The dev branch still asks for FMOD until pull request 36 merges. To build the version described here today, clone feature/lucky-merge instead.

  • Visual Studio 2022 or 2026
  • Python 3.9+
  • Vulkan SDK 1.4.335
  • .NET SDK 10

Clone the source

Clone the dev branch with its submodules. Install Visual Studio, Python 3.9+, the Vulkan SDK 1.4.335 and the .NET 10 SDK first.

git clone --branch dev --recursive https://github.com/starbounded-dev/LuxEngine.git
Step 1 of 3 on Windows. LuxEngine builds from source.

Found a rough edge? Tell us.

Questions, bug reports and pull requests are all welcome. A small scene that shows the problem helps more than anything else.