Introduction¶
What Apogee is¶
Apogee is an engine for games that crunch numbers: simulations with big worlds, many entities and a lot of arithmetic per frame. Its choices follow from that.
- Numbers first. Positions are
doubleso a world can be thousands of kilometers wide without jitter; everything the GPU sees isfloat. The ECS is Flecs. Hot paths use unmanaged memory,unsafecode and SIMD, and do not allocate. - The best library for each job. SDL3 for windows and input, Vulkan 1.3 with VMA and the Slang shader compiler for graphics, Jolt for physics, Luau for scripting, OpenAL Soft for audio, GameNetworkingSockets for networking, Dear ImGui for tools, RmlUi for game UI. Our work is the thin, fast layer between them and the game.
- Small libraries. One
Apogee.*project per concern, each with its own interop. Take what you need; nothing forces the rest on you. - Our own bindings. The raw bindings (
Apogee.Native.*) come from our own generator, checked by tests that every entry point resolves and every struct has clang's size. They are committed; nothing is hand-edited. - AOT by default. Shipped games are NativeAOT. No runtime reflection, no
Reflection.Emit, no loading managed code: a source generator writes the registry that gives scripts, serialization and the editor's inspectors their view of the engine's classes. - Luau for games and mods. The engine core is C#. Game developers and modders both write Luau and data, so scripts can be sandboxed, limited per owner and hot-reloaded.
- Everything redistributable. The repository ships only libraries whose headers and binaries we may redistribute, so a clone builds and runs with nothing to download.
- You own your stack. Apache-2.0, no royalties, no logo screen. If the project goes somewhere you do not want to follow, fork it.
What Apogee is not¶
- It is not a general-purpose engine for every kind of game, and it is not a drop-in replacement for Unity, Unreal or Godot. Pull requests that drift from the purpose above are declined, because adding everything is how engines end up doing nothing well.
- It targets desktop platforms: Windows, Linux and macOS. No consoles, no mobile, no web.
- Games and mods are written in Luau, not C#. There is no visual scripting.
- It has no feature toggles: everything is always compiled. Options are build modes and dev tools only.
Status¶
Pre-alpha. The libraries below are all there and tested, but APIs will change and some corners are thin. The maintainers develop on Linux with Vulkan. Windows is built and tested by CI; Metal (macOS) is written, its shaders pass Apple's compiler, but it has never run on a GPU. Direct3D 12 is not planned. The editor is very bare-bones for now: it cannot import 3D models or other assets (it only places and re-imports files already in the game folder), and it has no materials, no animations and no game export. Help wanted lists what we need.
What is in the box¶
| Library | What it is for |
|---|---|
Apogee.Core |
logging, arenas, native collections, the job system, double-precision numerics, debug drawing |
Apogee.Interop |
loading native libraries, UTF-8, function pointers: what the bindings stand on |
Apogee.Reflection |
the registry of classes, properties, methods, signals, enums and components, written by a source generator |
Apogee.Ecs |
a Flecs world with reflected components, systems, hierarchy, scenes |
Apogee.Scripting |
Luau: the VM, modules, sandboxing and limits, generated type definitions |
Apogee.Platform, Apogee.Input |
SDL3 windows and events; input actions with rebinding and gamepads |
Apogee.Graphics |
the portable GPU API, with Vulkan (complete) and Metal (untested), Slang shaders, bindless resources |
Apogee.Rendering |
a render graph, Forward+ lighting, glTF models, culling |
Apogee.Content |
the virtual file system, XML definitions with schemas, packages and mods, packs, asset import, hot reload |
Apogee.Export |
exporting a game: the runtime of a platform, the game's packs and manifest, the pack key in the executable |
Apogee.Physics |
Jolt in double precision, vehicles, hitches, character controller |
Apogee.Audio, Apogee.Network, Apogee.Steam |
OpenAL Soft audio, GameNetworkingSockets transport, Steamworks |
Apogee.UI, Apogee.DevTools |
RmlUi game UI with Luau in its documents; Dear ImGui dev tools |
Apogee.Host, Apogee.Runtime, Apogee.Editor |
what runs a game (session, world view, undo), the game executable, the ImGui editor |