
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
Sponza in the release build of the editor, with the scene hierarchy, renderer settings, and content browser beside the viewport.
1 of 15What 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 statusThe 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 .
Wanted27
If time allows in 2027.1
Wanted for the release, and the first things dropped if the must-haves run late.
- R4Foliage plan (alpha coverage, transmission, double-sided)
- R6Anti-aliasing
- R7Fog
- R9Reflection probes
- R11Decals
- R24HazelPBR_* shader names
- R25Depth-only pipelines declare unused vertex attributes
- P4Joints
- AS4Find references, safe rename, move and delete
- SC5Timers and coroutines
- SC10Dead slot per script instance per Play in m_ManagedObjects
- I2Input actions
- G2Save-game API
- G3String localisation tables
- G5Quality and settings API for games (ties to RT5)
- E10Particle editor
- E11Prefab edit mode (open a prefab alone)
- E15Autosave and recovery after a crash
- E16Undo by full snapshot
- E19Keybinding editor
- E21Long tasks show progress and can be cancelled (import, export, script build, bake)
- E23Probe placement and Bake
- RT5Player settings
- RT7No hitches on first use
- RT8Crash in a shipped game
- RT10Size and start-up budget
- L3"A newer version exists" notice
Must-haves11
Not started yet
2027.1 does not ship without these. Expand the board to see each one's sub-issues.
- 0 of 7 sub-issues done
- M2
- Size XL
physics queries, scene loading, time, maths types, entity active
0 of 8 sub-issues done- M4
- Size L
never lose work, C# build errors inline, click an error to open the line
0 of 2 sub-issues done- M5
- Size L
works from the release zip with no source tree, lean layout, no .NET install for players, game name and icon
0 of 8 sub-issues done- M6
- Size L
- 0 of 2 sub-issues done
- M9
- Size M
2D template, sprite animation, tilemaps, sorting, complete 2D physics
0 of 5 sub-issues done- M11
- Size XL
render thread on, watchdog, every release gate run on Linux too
0 of 2 sub-issues done- M12
- Size L
In progress4
Being worked on now
Someone is working on these right now. Each card links to where it stands.
- 0 of 9 sub-issues done
- M1
- Size L
- R2 Shadows
- R3 Materials
- R4 Foliage plan (alpha coverage, transmission, double-sided)
- P1 Jolt
- S1 Entities, hierarchy, folders, prefabs, variants, structural sync
- AS5 Async loading
- SC1 Hot reload, inspector attributes, OnFixedUpdate, collision and trigger callbacks, Gizmos, prefab spawn, generated API reference
- E1 Shell
- E5 Material Editor and node canvas
- M7
- Size M
Shipped23
Merged, newest first
Pull requests and finished items from the board.
Rendering features (area lights, etc)
- PR 35
- Oct 25, 2026
Export Runtime to Distribution
- PR 27
- May 27, 2026
- PR 26
- Apr 21, 2026
- Dec 5, 2025
Full implementation of Audio Engine
- PR 17
- May 25, 2025
- PR 16
- May 24, 2025
- PR 15
- May 5, 2025
- PR 14
- May 3, 2025
- PR 12
- Size L
- Apr 26, 2025
Physics implementation using box2d
- PR 11
- Mar 19, 2025
- PR 6
- Feb 4, 2025
Make a runtime
Multithreaded
Discord Activity Status SDK
Compile a project and make it a game
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.gitFound 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.