What you need
With Aura3D
With three.js
Source
A good-looking scene on first run
A bare scene keeps its authored colours, reflects a built-in studio environment, gets a shadow from lights.key and is framed by camera.auto. looks.preset(id) adds HDRI lighting, background, grade and post effects in one call (15 genre looks).
No environment, tone mapping or shadows by default. PBR metals render dark until you wire an environment.
CHANGELOG.md 5.3.0 (N1 to N4), packages/engine/src/agent-api/looks/lookPresets.ts, RESULTS.md §11
WebGPU
renderer: { backend: "auto" }: WebGPU first across desktop and Safari/iOS, automatic WebGL2 fallback on the same canvas, same scene code. All 30 showcase games run on WebGPU by default.
A separate WebGPURenderer from three/webgpu that you choose and wire yourself.
CHANGELOG.md 5.3.0 to 5.5.6, docs/upgrade-5.0.0/README.md
Rendering off the main thread
worker: { createWorker }, with node patches, frame callbacks and picking from the main thread. Opt-in; every showcase game runs with ?worker=1.
OffscreenCanvas plumbing and a message protocol of your own.
CHANGELOG.md 5.3.0 to 5.5.6
Scene code
Shorter in 4 of 5 benchmark scenes, 26% to 51% fewer lines of scene code: viewer 24 vs 49, forest 49 vs 71, skinned character 45 vs 62, game loop 61 vs 82. Five small scenes, one author.
The longer side of each of those pairs.
RESULTS.md §1
Imports and concepts
1 import module, and fewer API symbols in every benchmark scene.
Up to 8 modules (core plus addons).
RESULTS.md §3
Bloom, shadows, custom post pass
One call each: effects.bloom(), shadow: true, effects.shaderPass().
EffectComposer plus 3 or 4 addon passes; shadow flags on every mesh.
RESULTS.md §11
10,000 instances with per-instance colour
Declarative instances.*({ transforms, colors }).
Hand-written InstancedMesh matrix code.
RESULTS.md §11
Character animation
Switch clips by name with a cross-fade (handle.play("Run", { crossFade })) and fit the character to a height with one targetHeight option.
AnimationMixer, clipAction and manual fitting with Box3.
RESULTS.md §11
Type-safe assets
model(assets.robot): a generated typed key, so a missing asset is a compile error.
Asset paths are plain strings, checked only at run time.
templates/product-viewer/src/aura-assets.ts, tests/unit/agent-api/public-example-boundary.test.ts
Asset licence and integrity
Every admitted model records source, licence, author and sha256. In production, a model without a valid hash and same-origin URL does not draw.
Loads any file from any URL.
docs/agents/claims-and-boundaries.md §5 and §6, docs/api/model-loader.md
Getting assets
aura3d assets search and resolve pull licence-tagged open models (CC0, CC-BY) and type them; multi-material procedural sculpting is built into @aura3d/engine, and asset optimization, inspection and thumbnails come from the same CLI.
Bring your own files and tools.
packages/aura3d-cli/src/cli-help.ts
A deploy gate
aura3d check-deploy --dist dist fails the build on a missing hashed asset, stray files and asset-validation errors. --browser loads every route in headless Chromium and fails on failed requests and console errors; --release adds licence and quality gates.
No equivalent step.
packages/aura3d-cli/src/index.ts (check-deploy)
Game shell
HUD, mobile touch controls, first-gesture audio unlock, RuntimeQualityGovernor, juice and session flow (@aura3d/engine/game), plus genre kits for racket sports, karting, car soccer, fighting and platformer motion.
Not included.
docs/api/root-exports.md (game-kit exports), docs/api/game-kit.md
Fixed timestep, replay and QA
createFixedStepLoop, seeded createCountedRng and installQaHooks for scripted, repeatable test runs.
Write your own.
packages/engine/src/qa/, docs/api/qa-kit.md
Smooth motion on 120 and 144 Hz screens
createRenderInterpolator and createFixedStepPresenter: a 60 Hz simulation no longer freezes on every second frame at 120 Hz (50% stalled frames before, 0% after).
Write your own.
docs/api/motion-presenter.md
Blank-screen protection
installSafetyNet detects black frames and recovers. createFrameErrorBoundary keeps rendering after a throwing frame callback. A ?diag=1 diagnostics panel is built in.
Not included.
packages/debug/src/safety, docs/api/safety-net.md
Game audio
Procedural cue bank, step sequencer and tone loops on one shared audio context.
Positional audio primitives only.
packages/audio/src/synth, docs/api/audio-synth.md
Shader safety
material.custom GLSL with a chunk library (a3d_math, a3d_noise, a3d_sky, a3d_fog, a3d_toon) and loud compile errors.
ShaderMaterial with uniforms and varyings declared by hand.
docs/api/glsl-chunks.md, RESULTS.md §11
Working with AI coding agents
llms.txt, 14 agent skills, compiled recipes and a type-traps table, written into every new project by create-aura3d. aura3d info, examples, validate and render; three.js names that models guess resolve or throw an error naming the Aura3D call.
No official agent docs.
packages/aura3d-cli/skills/, docs/agents/agent-tools.md, docs/agents/guessable-api.md
Coming from three.js
aura3d import-three turns a three.js scene factory into a typed asset and an editable Aura3D scene (prototype). aura3d migrate three maps 245 three.js constructs and writes an annotated port worklist.
Not applicable.
docs/agents/three-bridge.md, packages/aura3d-cli/src/migrate-three/
Starting a project
26 create-aura3d templates (product viewer, mini-game, racing, falling blocks, fighting, arena shooter, character controller, animation studio and more), each with route-health and screenshot tests.
Generic Vite templates.
packages/create-aura3d/templates/
Proof it ships
30 playable games built on Aura3D with 100% native multi-material procedural art.
Not applicable.
docs/workflows/game-inventory.json,
showcase