The Frame Highway
Each frame flows deterministically from OS events through fixed-timestep physics, cell-based streaming, ECS simulation, and dual 3D/2D WGPU passes into the Iris SDF UI overlay.
A memory-safe, data-driven 2D and 3D game engine written in Rust. Deterministic ECS, WGPU forward PBR, Rapier physics, LZ4 binary world streaming, and a standalone GPU-SDF UI framework—engineered without compromise.
unsafe_code = "forbid"
O(M) Retained SDF UI
16-byte Aligned .aepak
2D / 3D Isolated Pipelines
Every subsystem is strictly layered with unidirectional dependencies—zero circular graphs, zero hidden runtime magic.
Each frame flows deterministically from OS events through fixed-timestep physics, cell-based streaming, ECS simulation, and dual 3D/2D WGPU passes into the Iris SDF UI overlay.
Workspace crates enforce unsafe_code = "forbid". Dynamic FFI (libloading) is
isolated solely inside ae_plugin_host, while release builds link game_logic statically.
Zero dependencies on ae_core. Features Taffy O(M) partial subtree invalidation,
Glyphon typography, VirtualList (1M+ rows in ≤33 nodes), and 5-way docking.
4-cascade PCF shadow mapping, 5-mode procedural sky with Beer-Lambert volumetric clouds, glTF 2.0 PBR,
4x MSAA, and C² infinite viewport grid. Switching to Mode2D activates the 5-crate
ae_2d pipeline with zero 3D memory allocation.
Six strictly ordered architectural layers. Select any crate to inspect its boundary, symbols, and invariants.
crates/irisui)irisui-core & irisui-layoutFlat arena UiTree, invalidation boundaries for O(M) Taffy subtree layout, FocusManager, safe hex parsing, and autonomous NumericUndoStack.
irisui-text & irisui-wgpuGlyphon hardware-accelerated glyph atlas with O(log N) binary-search hit-testing, analytic GPU SDF shaders, ScissorStack AABB culling, and BoundaryLayerCache.
irisui-widgetsDeclarative UiScope two-way bindings, VirtualList (1M+ rows in ≤33 nodes), multiline code editor, non-linear DragCurve, and zero-boolean scoped popups.
irisui-dock & irisui-workbenchDynamic DockTree with 5-way DockNavigator, floating window manager, DualLayoutEliminator, stacked DialogHost focus traps, and ActionBus.
Deterministic 64-bit FNV-1a type hashes, 128-bit persistent GUIDs, and crash-safe disk layouts.
.aeworld
AEWLD001
Lightweight manifest holding header, string/asset pools, global entities, and spatial cell index.
.aechunk
AECHK001
Independent spatial cells with IEEE CRC32 validation, postcard payloads, and parallel lz4_flex compression.
.aepak
AEPAK001
64 KiB block-compressed archive with 16-byte alignment and AlignedBuffer for zero-copy bytemuck uploads.
.aesave
AESAV001
Cell-indexed runtime delta snapshots with O(log C) streaming and .tmp → sync_all → .bak → rename safety.
.aemeta
AEMET001
Persistent 128-bit AssetGuid identity tracking across disk moves, paired with platform-cooked blobs.
.aeprefab
AEPRB001
Hierarchical multi-entity templates compressed with LZ4 + CRC32, assigning fresh EntityGuids on drop.
ae_world
<ProjectRoot>/
├── aeon_project.json # Metadata, entry world, 2D/3D mode
├── Config/ # Render, physics & input profiles
├── Content/ # .glb, .png, .wav, .wgsl, .aeprefab + .aemeta
├── Worlds/
│ └── MainWorld/
│ ├── world.aeworld
│ └── cells/ # 0_0_0.aechunk, -1_0_2.aechunk
├── Intermediate/ # <desktop|android>/<hash>.<ext>
└── Saved/
├── Autosaves/ # Rotating *_autosave_{0..2}.aeworld
├── Logs/
└── SaveGames/ # slot_<id>.aesave + .bak
Strict memory safety inside the engine, paired with defense-in-depth across this web portal.
unsafe_code = "forbid" enforced across workspace crates via [workspace.lints.rust].libloading) strictly isolated inside ae_plugin_host.--features static-game-logic.todo!, unimplemented!, dbg!, and redundant clones.default-src 'self', object-src 'none', frame-ancestors 'none').createElement and textContent only.rel="noopener noreferrer"; ReDoS-safe bounded search.
Hierarchy, WGPU Forward PBR Viewport, Inspector with color palette & transforms, Asset Browser with WGSL shaders, and retained Iris UI docking.