AI-Native Interactive Visual Engine — 16 Phases, 16 Runnable Demos
"Every system in the engine, working together in one playable experience."
A first-person dungeon crawler that exercises all core engine phases simultaneously. Navigate a torch-lit stone dungeon, open a physics-driven gate, battle a patrolling goblin guardian with a finite-state-machine AI, and claim the golden relic. Deferred HDR lighting with flickering torchlight, Rapier 3D physics, Lua-scripted entity behaviors, event-driven game logic, and a full win/lose condition — all defined in pure YAML + Lua, zero recompilation needed.
Cinematic and interactive experiences that push every engine system to the limit.
"100+ entities, 32 lights, the most ambitious scene in the engine."
A grand colosseum showcasing the engine at full throttle. A levitating gold titan sphere sits at the heart, surrounded by 16 outer pillars, 8 obsidian sentinels, dual orbital rings of gold and platinum spheres, 4 gemstone pedestals (ruby, sapphire, emerald, ice), spiraling ember and void cubes with rainbow emission waves, and copper/steel outer orbits. 32 dynamic lights paint the scene with dramatic warm/cool contrasts. FXAA anti-aliasing keeps every edge clean.
"65 entities, 24 lights, a multi-act creation story told in PBR and light."
A cinematic visual showcase that unfolds like a creation myth. A central spark core pulses with emission, concentric rings of chrome and copper orbs orbit at different speeds, 8 obsidian pillars rise from underground, and a Gaussian splat nebula swirls at the center — all choreographed by keyframe-driven camera moves with smooth Hermite interpolation. Bloom, HDR tonemapping, and shadow mapping bring it to life.
"Minimalist void. Floating monoliths. Procedural splats. Pure atmosphere."
A dark, atmospheric showcase focused on Gaussian splatting compositing. Floating void monolith pillars drift around a procedural splat nebula, joined by void crystals, ice shards, obsidian fragments, and neon accent orbs. Ultra-low ambient lighting (0.005) creates a deeply immersive cosmic void. 16 dynamic lights add subtle color washes that breathe and pulse.
"FPS combat meets hellfire lighting. Fight 6 demons in a lava-lit arena."
A playable first-person combat arena that combines the physics and scripting systems with intense visual design. Navigate a 32×32 arena with 4 lava pits at the corners, 4 iron pillars for cover, and 6 demon enemies with AI combat logic. Health pickups float and bob, torches flicker with layered sine waves, and orange-red hellfire sunlight casts dramatic shadows across everything.
"A dark club with 6 neon pillars and floating emissive cubes."
A moody neon-lit environment with 6 pillars arranged in a hexagonal pattern, each in a different neon color (pink, cyan, purple, gold, blue, green). 3 floating emissive cubes bob gently overhead while 6 pulsing neon point lights wash the dark floor with shifting color. The cinematic camera sweeps through the space in a smooth orbit.
"25 spheres, every combination of metallic and roughness."
A material science showcase presenting a 5×5 grid of PBR spheres. Rows sweep metallic from 0.0 (dielectric) to 1.0 (full metal). Columns sweep roughness from 0.0 (mirror) to 1.0 (fully diffuse). Four colored key lights illuminate the grid from different angles, revealing how Cook-Torrance GGX lighting responds to each material parameter combination. Interactive physics with ball collision sound effects.
"A procedural galaxy, a floating crystal, and 4 colored lights."
The original Gaussian splatting demo. A procedural splat galaxy rotates at the origin while a cyan neon crystal bobs gently above a dark pedestal. Four colored point lights (purple, blue, red-orange) create a cosmic atmosphere. Simple but foundational — the scene that proved splat-mesh depth compositing works.
From raw triangles to a full deferred HDR pipeline with Gaussian splatting compositing.
"A full GPU pipeline described in 73 lines of YAML."
The entire multi-pass rendering pipeline is data-driven: shadow pass, G-Buffer geometry, Gaussian splat,
deferred lighting (Cook-Torrance GGX), bloom, tonemapping, and FXAA — all wired through
pipelines/render.yaml. Add or reorder passes without touching Rust code.
"3D Gaussian splats and traditional meshes, depth-composited in a single frame."
Load .ply 3D Gaussian Splat captures alongside conventional glTF meshes. The engine depth-composites both representations so splats and meshes coexist naturally — a NeRF-era mesh sitting inside a traditionally-modeled dungeon room.
"Edit a shader, save the file, see the result on the next frame."
Shaders are written in SLANG (with WGSL fallback) and automatically recompiled when the file changes on disk. The file watcher detects modifications and the pipeline re-creates GPU state seamlessly — no restart, no stutter.
"Four torches, four unique flickers, one atmospheric dungeon."
Each torch runs an independent Lua script with a random phase offset and layered sine waves (3 frequencies) producing organic light flicker. The deferred lighting pass accumulates all point lights with range-based attenuation.
Immediate-mode 2D overlay, bitmap font text, screen effects, and spatial audio — all driven from Lua.
"Immediate-mode 2D overlay: text, rects, animations, and screen flash."
A comprehensive showcase of the Phase 16 UI system. Title bar, stats HUD panel with live FPS and score, text size & color palettes, animated pulsing and rainbow text, a moving progress bar, auto-spawning entities with screen flash effects, and visibility toggling — all rendered as a 2D overlay on top of the 3D scene using a 6×8 bitmap font atlas.
"Snake meets Minesweeper on a dynamic 7×7 grid with numbered tiles."
A playable prototype combining Snake and Minesweeper mechanics. A 7×7 grid of tiles is spawned
at runtime via entity.spawn(). An auto-walking snake reveals tiles, showing Minesweeper-style
numbers (1-4) as UI text overlays. Hitting a mine triggers a screen flash and game-over state. Tile
emission colors change dynamically based on revealed content. Top-down camera with full HUD overlay.
"Background music, timed sound effects, and visual audio feedback."
Tests MP3 audio playback using real game assets from a snake/minesweeper game. Background music fades in over 2 seconds, then a timed schedule triggers sound effects — eat (food pickup), explosion (mine hit), and death (game over) — each at different volumes. Every sound event gets visual feedback: screen flash, a HUD panel showing the current audio state, a progress bar, countdown to the next SFX, and a fake waveform visualization.
The "AI-Native" in nAIVE. External AI agents can observe, control, and test the game.
"A Lua script plays through the entire dungeon without a screen."
Run the complete game loop headlessly — no GPU, no window. Lua test scripts inject synthetic inputs, advance time, assert game state, and verify the full gameplay loop: movement, door interaction, combat, item pickup, and win conditions.
test_full_playthrough: walks to door, opens it, collects relictest_player_stays_in_bounds: verifies all 4 walls contain the playertest_scripts_running: confirms guardian patrols + relic bobstest_game_state_initialized: asserts HP=100, game_over=false"Claude (or any LLM) can list entities, move objects, and inject input — live."
The MCP server bridges JSON-RPC 2.0 over stdin/stdout to the engine's Unix domain socket. An AI agent can query every entity, modify transforms, spawn/destroy objects, emit events, inject keyboard/mouse input, and pause/resume the game — all through standard tool-use.
"Pipe JSON into a socket, reshape the game world in real time."
The engine listens on a Unix domain socket for JSON commands. Any process — a shell script, a Python notebook, a monitoring dashboard — can query and mutate the running game without any SDK or library dependency.
"73 lines of Lua, one convincing enemy."
The guardian goblin demonstrates a complete finite-state-machine AI written entirely in Lua. It patrols side-to-side, detects the player within 8m, chases at double speed, and attacks in melee range on a cooldown timer. It takes damage and can be defeated.
Everything is YAML + Lua. The Rust engine is the runtime; the game is pure data.
"250 lines of YAML defines an entire playable dungeon."
The Relic scene declares 15 entities — player, walls, floor, ceiling, pillars, gate, torches, guardian, relic, pedestal — entirely in YAML. Each entity specifies its transform, mesh, material, collider, script, and light components declaratively. Swap the scene file, get a completely different game.
"Edit guardian.lua, save, watch the goblin change behavior mid-game."
Every Lua script is watched for changes. On modification, the VM reloads the script,
calls on_reload() if defined, and the entity picks up new behavior instantly.
Iterate on AI logic, door animations, or pickup mechanics without restarting.
"Type-checked game events defined in YAML, logged in a ring buffer."
Game events (player.damaged, door.opened, item.collected, enemy.defeated, game.level_complete) are defined in an event schema with required fields. The event bus validates payloads at emit-time, logs to a ring buffer, and dispatches to Lua listeners.
"Rapier 3D physics with character controller, slopes, and autostep."
The physics system integrates Rapier 3D with box, sphere, and capsule colliders. The player character controller handles slope climbing, automatic step-up over small obstacles, and ground snapping. Trigger volumes fire enter/exit events.
Install with brew install poro/tap/naive, then run these from the repository’s project/ folder, or browse the 19 built-in demos with naive demo.
| # | Demo | Command | GPU | Phases |
|---|---|---|---|---|
| 1 | The Relic (full game) | naive --scene scenes/relic.yaml |
Yes | 1-9 |
| 2 | TITAN — Colosseum of Light | naive --scene scenes/titan.yaml |
Yes | 1-15 |
| 3 | GENESIS — Birth of a World | naive --scene scenes/genesis.yaml |
Yes | 1-13 |
| 4 | VOID — Cosmic Splatting | naive --scene scenes/void.yaml |
Yes | 1-4, 6-7, 15 |
| 5 | INFERNO — Combat Arena | naive --scene scenes/inferno.yaml |
Yes | 1-9, 15 |
| 6 | Neon Dreamscape | naive --scene scenes/neon_dreamscape.yaml |
Yes | 1-3, 6-7, 12 |
| 7 | PBR Material Gallery | naive --scene scenes/pbr_gallery.yaml |
Yes | 1-3, 11-12 |
| 8 | Cosmic Splats | naive --scene scenes/cosmic_splats.yaml |
Yes | 1-4 |
| 9 | Splat Compositing Test | naive --scene scenes/splat_test.yaml |
Yes | 1-4 |
| 10 | Physics Playground | naive --scene scenes/physics_test.yaml |
Yes | 1-5 |
| 11 | UI & Text Rendering Demo | naive --scene scenes/ui_demo.yaml |
Yes | 1-3, 6, 16 |
| 12 | Grid UI Demo (Snake Sweeper) | naive --scene scenes/grid_ui_demo.yaml |
Yes | 1-3, 6, 16 |
| 13 | Audio Test (Snake Sweeper SFX) | naive --scene scenes/audio_test.yaml |
Yes | 1-3, 6, 11, 16 |
| 14 | Headless Test Suite | naive test tests/test_relic.lua |
No | 2, 5-7, 10 |
| 15 | MCP Server | cargo run --bin naive_mcp |
No (bridge) | 8 |
| 16 | Socket Live Control | echo '{"cmd":"list_entities"}' | socat - UNIX:/tmp/naive-runtime.sock |
Engine running | 8 |
| 17 | Havoc — 50,000-unit GPU swarm battle | naive --scene scenes/tier4_havoc.yaml |
Yes | Tier 4 |
naive --scene scenes/titan.yaml. Let the cinematic camera sweep through the colosseum. Point out the 100+ entities, dual orbital rings, gemstone pedestals, and 32 dynamic lights.naive --scene scenes/genesis.yaml. Show the multi-act creation story: spark core, rising pillars, orbiting rings, and Gaussian splat nebula.naive --scene scenes/void.yaml. Demonstrate Gaussian splatting composited with mesh objects in a dark cosmic environment.naive --scene scenes/pbr_gallery.yaml. Show the 25-sphere metallic/roughness grid proving Cook-Torrance GGX correctness.naive --scene scenes/relic.yaml. Walk around the dungeon, open the physics-driven gate (press E), fight the guardian goblin, collect the golden relic.naive --scene scenes/inferno.yaml. Show FPS combat with 6 demon enemies, lava pits, health pickups, and hellfire lighting.naive --scene scenes/ui_demo.yaml. Show the 2D overlay system: HUD panels, animated text, progress bars, entity spawning, screen flash.naive --scene scenes/grid_ui_demo.yaml. Show runtime entity spawning and UI text overlay on a dynamic game grid.naive --scene scenes/audio_test.yaml. Demonstrate MP3 playback with background music, timed SFX, and visual audio feedback.deferred_light.slang (change light color or attenuation). Save. Watch the lighting change in real time.guardian.lua, double the detect range. Save. The goblin immediately becomes more aggressive.socat to teleport the player, spawn a new light, or list all entities via JSON commands.naive test tests/test_relic.lua. The entire game plays itself with no GPU. Show all 5 tests passing.| Zero-compile iteration | Scenes, materials, pipelines, shaders, scripts, input bindings, and event schemas are all hot-reloadable data files. |
| AI-first architecture | MCP server + command socket + headless mode = an AI agent can design, play, and QA-test a game without human intervention. |
| Cutting-edge rendering | Cook-Torrance GGX PBR, Gaussian splatting compositing, FXAA anti-aliasing, shadow mapping, bloom, and HDR tonemapping — all in a single data-driven pipeline. |
| Full game UI | Immediate-mode 2D overlay with bitmap font text, colored rects, screen flash effects, and runtime entity spawning/destruction — all from Lua scripts. |
| Spatial audio | Kira audio engine with MP3/WAV support, music fade-in/out, one-shot SFX, spatial attenuation, and Lua script control. |
| From-scratch in Rust | No Unity, no Unreal, no Bevy. Custom ECS, custom renderer, custom physics integration — all type-safe Rust. |
| 16-phase engineering | Each phase builds cleanly on the last: window → scene → deferred → splats → physics → scripting → events → sockets → game → testing → PBR → bloom → genesis → rendering overhaul → advanced demos → UI overlay. |