AEON ENGINE v0.8 • RUST + WGPU + IRIS UI

They chase the illusion.
You build for eternity.

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
SYSTEMS ARCHITECTURE

Engineered from the Metal Up

Every subsystem is strictly layered with unidirectional dependencies—zero circular graphs, zero hidden runtime magic.

EXECUTION LIFECYCLE

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.

01 Winit & Input Frameless drag, HighDPI scroll
02 Fixed Physics Rapier3D / Rapier2D step
03 Stream & ECS Cells, Behaviors, Audio
04 WGPU + Iris CSM/PBR → SDF Overlay
SAFETY BOUNDARY

Zero-Unsafe Core

Workspace crates enforce unsafe_code = "forbid". Dynamic FFI (libloading) is isolated solely inside ae_plugin_host, while release builds link game_logic statically.

ae_runtime --features static-game-logic
STANDALONE UI

Iris UI Framework

Zero dependencies on ae_core. Features Taffy O(M) partial subtree invalidation, Glyphon typography, VirtualList (1M+ rows in ≤33 nodes), and 5-way docking.

crates/irisui
RENDERING & DIMENSION ISOLATION

AeonGPU Forward PBR & Isolated 2D Suite

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.

ae_renderer ae_animation ae_2d (Rapier2D + SpriteBatcher)
DEPENDENCY GRAPH

Workspace Crate Topology

Six strictly ordered architectural layers. Select any crate to inspect its boundary, symbols, and invariants.

CAPABILITIES

Engine Subsystems

RETAINED GUI

Iris UI Framework (crates/irisui)

Independent Distribution

irisui-core & irisui-layout

Flat arena UiTree, invalidation boundaries for O(M) Taffy subtree layout, FocusManager, safe hex parsing, and autonomous NumericUndoStack.

irisui-text & irisui-wgpu

Glyphon hardware-accelerated glyph atlas with O(log N) binary-search hit-testing, analytic GPU SDF shaders, ScissorStack AABB culling, and BoundaryLayerCache.

irisui-widgets

Declarative UiScope two-way bindings, VirtualList (1M+ rows in ≤33 nodes), multiline code editor, non-linear DragCurve, and zero-boolean scoped popups.

irisui-dock & irisui-workbench

Dynamic DockTree with 5-way DockNavigator, floating window manager, DualLayoutEliminator, stacked DialogHost focus traps, and ActionBus.

PERSISTENCE & VFS

Binary World & Asset Formats

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.

ProjectWorkspaceLayout 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
VERIFICATION

Security & Quality Invariants

Strict memory safety inside the engine, paired with defense-in-depth across this web portal.

Engine Memory & Lint Guarantees

  • unsafe_code = "forbid" enforced across workspace crates via [workspace.lints.rust].
  • Dynamic FFI (libloading) strictly isolated inside ae_plugin_host.
  • Exported runtimes link gameplay statically via --features static-game-logic.
  • Clippy denies warnings, todo!, unimplemented!, dbg!, and redundant clones.

Web Portal Hardening

  • Strict Content Security Policy (default-src 'self', object-src 'none', frame-ancestors 'none').
  • Zero external CDNs, zero inline scripts, and zero inline event handlers.
  • XSS-immune DOM construction using createElement and textContent only.
  • External links hardened with rel="noopener noreferrer"; ReDoS-safe bounded search.