create-aura3d 2.0.4 → 3.0.0

package/README.md

@@ -47,7 +47,7 @@ npx create-aura3d@latest --help
 - **Static deploys are first-class.** Build output is a browser app you can
   deploy like any Vite project.
 
-Aura3D 2.0.4 scaffolds pin the packed 2.0.4 dependency graph. The historical
+Aura3D 3.0.0 scaffolds pin the packed 3.0.0 dependency graph. The historical
 2.0.0 exact-tarball lifecycle receipts remain the 2.0 major-release record:
 149/149 checks against workspace source and 149/149 checks in clean projects
 that installed that packed 2.0.0 graph. Those lifecycles cover install, typecheck,

package/dist/index.js

@@ -42,7 +42,7 @@ export function createA3DProject(options) {
     const dependencies = { ...(packageJson.dependencies ?? {}) };
     const auraDependencies = Object.keys(dependencies).filter((name) => name.startsWith("@aura3d/"));
     if (auraDependencies.length === 0) {
-        dependencies["@aura3d/engine"] = options.packageVersion ?? "2.0.4";
+        dependencies["@aura3d/engine"] = options.packageVersion ?? "3.0.0";
     }
     else if (options.packageVersion) {
         for (const dependency of auraDependencies)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-aura3d",
-  "version": "2.0.4",
+  "version": "3.0.0",
   "type": "module",
   "bin": {
     "create-aura3d": "dist/cli.js"
@@ -54,7 +54,7 @@
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "dependencies": {
-    "@aura3d/asset-index": "2.0.4"
+    "@aura3d/asset-index": "3.0.0"
   },
   "description": "Start real Aura3D browser 3D apps in one command with Vite templates, typed GLB/glTF assets, route-health tests, screenshots, and deploy-ready structure.",
   "keywords": [

package/templates/animation-channel/package.json

@@ -12,7 +12,8 @@
     "test:negative-failed-puppets": "playwright test tests/concept-2-5d.spec.ts tests/puppet-2d.spec.ts tests/image-puppet.spec.ts tests/concept-2-5d-animation.spec.ts tests/puppet-2d-animation.spec.ts tests/image-puppet-animation.spec.ts --workers=1"
   },
   "dependencies": {
-    "@aura3d/engine": "2.0.4"
+    "@aura3d/engine": "3.0.0",
+    "@aura3d/navigation-recast": "3.0.0"
   },
   "devDependencies": {
     "@playwright/test": "^1.52.0",

package/templates/animation-studio/package.json

@@ -16,8 +16,9 @@
     "preview": "vite preview --host 0.0.0.0"
   },
   "dependencies": {
-    "@aura3d/animation": "2.0.4",
-    "@aura3d/engine": "2.0.4",
+    "@aura3d/animation": "3.0.0",
+    "@aura3d/engine": "3.0.0",
+    "@aura3d/navigation-recast": "3.0.0",
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
     "sharp": "^0.33.5"

package/templates/animation-studio/src/scene-player.ts

@@ -14,7 +14,7 @@
  */
 
 import { A3DRenderer, TextureBinding as EngineTextureBinding } from "@aura3d/engine/advanced-runtime";
-import { createStudioLighting, createTypedGLBActor, type TypedGLBActor } from "@aura3d/engine/production-runtime";
+import { createPerformanceGovernor, createSideViewGameRenderPreset, createStudioLighting, createTypedGLBActor, type TypedGLBActor } from "@aura3d/engine/production-runtime";
 import { createCameraPathFromPreset, sampleCameraPath, type CameraPath } from "@aura3d/engine";
 // I1 clean-room correctness: import the rendering/scene PRIMITIVES from the engine's own subpaths
 // (`@aura3d/engine/rendering` / `@aura3d/engine/scene`) — the SAME copy the A3DRenderer uses — NOT
@@ -88,6 +88,13 @@ interface LiveRouteSeekProof {
    * inspectable per-seek (e.g. "miko: talk←talk [extracted] 9 bones / 0.412rad").
    */
   readonly debugOverlay: readonly string[];
+  /** J3 perf governor snapshot (optional so old capture scripts keep working). */
+  readonly governor?: {
+    readonly resolutionScale: number;
+    readonly particleScale: number;
+    readonly lodBias: number;
+    readonly shadowSize: number;
+  };
   readonly characters: readonly {
     readonly id: string;
     readonly clip: string;
@@ -634,7 +641,15 @@ export async function mountScenePlayer(doc: EpisodeDocument): Promise<void> {
   };
 
   // 8. Pose at episode time `t`, drive camera + lip-sync + world-state, render.
+  // J3 perf governor: watches wall-clock frame cost against the side-view game
+  // budget and degrades resolution/particles/LOD/shadows in order.
+  const governorBudget = createSideViewGameRenderPreset().performanceBudget;
+  let governor = createPerformanceGovernor("conservative");
+  let lastPoseAtMs = 0;
   const poseAt = (time: number, options: LiveSeekOptions = {}): LiveRouteSeekProof => {
+    const nowMs = performance.now();
+    const frameMs = lastPoseAtMs === 0 ? 1000 / 60 : Math.min(250, Math.max(0, nowMs - lastPoseAtMs));
+    lastPoseAtMs = nowMs;
     const shot = shotAtTime(doc, time);
     const gardenGlow = sampleWorldStateGlow(doc, time);
     applyWorldGlow(gardenGlow);
@@ -820,11 +835,23 @@ export async function mountScenePlayer(doc: EpisodeDocument): Promise<void> {
     if (debugOverlayEl && debugOverlayEnabled) {
       debugOverlayEl.textContent = `t=${time.toFixed(2)}s  shot=${shot.shotId}\n${debugOverlay.join("\n")}`;
     }
+    governor = governor.step(
+      {
+        fps: 1000 / Math.max(1, frameMs),
+        frameTimeMs: frameMs,
+        draws: diagnostics.drawCalls,
+        tris: 0,
+        particles: 0,
+        shadowBytes: 0
+      },
+      governorBudget
+    );
     return {
       time,
       drawCalls: diagnostics.drawCalls,
       skinnedRenderItems,
       gardenGlow,
+      governor: { ...governor.settings },
       shot: {
         shotId: shot.shotId,
         presetId: String(shot.presetId),

package/templates/character-controller/README.md

@@ -32,7 +32,7 @@ npm run enable:physics
 ```
 
 The script executes
-`npm install @aura3d/physics@2.0.4 @aura3d/physics-rapier@2.0.4`, so the
+`npm install @aura3d/physics@3.0.0 @aura3d/physics-rapier@3.0.0`, so the
 large asynchronous physical backend is added only when this physical capsule
 path is selected and never enters the default kinematic scaffold transitively.
 

package/templates/character-controller/aura.assets.json

@@ -3,5 +3,35 @@
   "assetBasePath": "/aura-assets/",
   "outputDir": "public/aura-assets",
   "typegen": "src/aura-assets.ts",
-  "assets": []
+  "assets": [
+    {
+      "id": "showcaseWalkAnimatedGirl",
+      "type": "model",
+      "format": "glb",
+      "source": "public/aura-assets/showcaseWalkAnimatedGirl.93872fc2.glb",
+      "outputPath": "public/aura-assets/showcaseWalkAnimatedGirl.93872fc2.glb",
+      "url": "/aura-assets/showcaseWalkAnimatedGirl.93872fc2.glb",
+      "hash": "sha256-93872fc24240a071b6195d6f1339f40b09b3308dc998311252d21ebd9042d8c6",
+      "sizeBytes": 3791152,
+      "bounds": [
+        86.929,
+        161.836,
+        37.758
+      ],
+      "materials": [
+        "material_0",
+        "material_1",
+        "material_0_0",
+        "material_0_1",
+        "material_0_2",
+        "material_0_3",
+        "material_0_4"
+      ],
+      "animations": [
+        "Take 001"
+      ],
+      "textures": [],
+      "thumbnailUrl": "/aura-assets/showcaseWalkAnimatedGirl.thumb.svg"
+    }
+  ]
 }

package/templates/character-controller/package.json

@@ -5,15 +5,16 @@
   "type": "module",
   "scripts": {
     "dev": "vite --host 127.0.0.1",
-    "enable:physics": "npm install @aura3d/physics@2.0.4 @aura3d/physics-rapier@2.0.4",
+    "enable:physics": "npm install @aura3d/physics@3.0.0 @aura3d/physics-rapier@3.0.0",
     "typecheck": "tsc --noEmit",
     "build": "npm run typecheck && vite build",
     "preview": "vite preview --host 127.0.0.1",
-    "test": "playwright test tests/route-health.spec.ts tests/screenshot.spec.ts --workers=1"
+    "test": "playwright test tests/route-health.spec.ts tests/screenshot.spec.ts tests/certified-rig.spec.ts --workers=1"
   },
   "dependencies": {
-    "@aura3d/animation": "2.0.4",
-    "@aura3d/engine": "2.0.4"
+    "@aura3d/animation": "3.0.0",
+    "@aura3d/engine": "3.0.0",
+    "@aura3d/navigation-recast": "3.0.0"
   },
   "devDependencies": {
     "@playwright/test": "^1.52.0",

package/templates/character-controller/public/aura-assets/showcaseWalkAnimatedGirl.thumb.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 320 180"><rect width="320" height="180" fill="#101720"/><path d="M80 126 160 46l80 80-80 28z" fill="#77a7ff"/><text x="160" y="160" text-anchor="middle" font-family="Arial" font-size="18" fill="#f4f7fb">showcaseWalkAnimatedGirl 86.929x161.836x37.758</text></svg>

package/templates/character-controller/src/aura-assets.ts

@@ -1,3 +1,17 @@
 import { defineAuraAssets } from "@aura3d/engine";
 
-export const assets = defineAuraAssets({} as const);
+export const assets = defineAuraAssets({
+  showcaseWalkAnimatedGirl: {
+    type: "model",
+    format: "glb",
+    url: "/aura-assets/showcaseWalkAnimatedGirl.93872fc2.glb",
+    bounds: [86.929, 161.836, 37.758],
+    hash: "sha256-93872fc24240a071b6195d6f1339f40b09b3308dc998311252d21ebd9042d8c6",
+    metadata: {
+      materials: ["material_0", "material_1", "material_0_0", "material_0_1", "material_0_2", "material_0_3", "material_0_4"],
+      animations: ["Take 001"],
+      textures: [],
+      thumbnailUrl: "/aura-assets/showcaseWalkAnimatedGirl.thumb.svg"
+    }
+  }
+} as const);

package/templates/character-controller/src/main.ts

@@ -1,8 +1,10 @@
 // Character controller preview: keyboard input -> kinematic speed -> @aura3d/animation locomotion
 // kit (idle/walk/run blended by speed) -> live proof object. Hold a direction key (W/A/S/D or
 // arrows) to walk; hold Shift to run. A minimal Aura3D stage renders beneath the HUD.
-import { camera, createAuraApp, lights, material, primitives, scene } from "@aura3d/engine";
+import { camera, createAuraApp, lights, material, model, primitives, scene } from "@aura3d/engine";
+import { createPerformanceGovernor, createTopDownGameRenderPreset } from "@aura3d/engine/production-runtime";
 import { createLocomotionKit } from "@aura3d/animation";
+import { assets } from "./aura-assets.js";
 import { defaultCharacterControllerTuning, stepCharacterSpeed, type CharacterControllerState } from "./controller.js";
 
 interface CharacterControllerProof {
@@ -11,6 +13,9 @@ interface CharacterControllerProof {
   moving: boolean;
   running: boolean;
   clipWeights: ReadonlyArray<{ clip: string; weight: number }>;
+  hero: { readonly assetId: string; readonly url: string; readonly clip: string };
+  debugDraw: boolean;
+  governor: { readonly resolutionScale: number; readonly particleScale: number; readonly lodBias: number; readonly shadowSize: number };
 }
 
 declare global {
@@ -27,14 +32,21 @@ const held = new Set<string>();
 window.addEventListener("keydown", (event) => held.add(event.code));
 window.addEventListener("keyup", (event) => held.delete(event.code));
 
+// J3 scaffold surface: the engine perf governor watches frame cost against the
+// top-down preset budget, and the debug key gates overlay detail in the HUD.
+const governorBudget = createTopDownGameRenderPreset().performanceBudget;
+let governor = createPerformanceGovernor("conservative");
+let debugDraw = false;
+
 const root = document.getElementById("app") ?? document.body;
 const hud = document.createElement("pre");
 hud.id = "character-controller-hud";
 hud.style.cssText = "font:14px monospace;padding:16px;color:#6cf;background:#0c0f16;min-height:140px";
 root.appendChild(hud);
 
-// Minimal visual stage: a capsule stand-in on a floor so the route renders a real
-// Aura3D scene alongside the locomotion HUD proof.
+// Certified hero stage: the E1 humanoid-a rig (showcaseWalkAnimatedGirl, "Take
+// 001") plays its certified clip on a floor so the route renders a real Aura3D
+// scene alongside the locomotion HUD proof.
 const stage = document.createElement("div");
 stage.id = "character-controller-stage";
 stage.style.cssText = "height:320px";
@@ -42,9 +54,9 @@ root.appendChild(stage);
 createAuraApp(stage, {
   scene: scene()
     .background("#0c0f16")
-    .camera(camera.orbit({ target: [0, 1, 0], distance: 5 }))
+    .camera(camera.orbit({ target: [0, 0.8, 0], distance: 3.2 }))
     .add(primitives.box({ name: "floor", size: [6, 0.1, 6], position: [0, -0.05, 0], material: material.pbr({ color: "#151b27", roughness: 0.9 }), receiveShadow: true }))
-    .add(primitives.capsule({ name: "character stand-in", size: [0.7, 1.7, 0.7], position: [0, 1.2, 0], material: material.pbr({ color: "#6cb1f0", roughness: 0.5 }), castShadow: true }))
+    .add(model(assets.showcaseWalkAnimatedGirl, { name: "certified hero humanoid-a" }).position(0, 0, 0).animate({ clip: "Take 001", loop: true }))
     .add(lights.ambient({ intensity: 0.35 }))
     .add(lights.directional({ name: "key", position: [3, 5, 2], intensity: 1.4 }))
 });
@@ -55,23 +67,35 @@ let last = 0;
 function frame(time: number): void {
   const dt = last === 0 ? 1 / 60 : Math.min(0.05, (time - last) / 1000);
   last = time;
+  if (held.has("KeyT")) {
+    debugDraw = !debugDraw;
+    held.delete("KeyT");
+  }
   const move = [...held].some((code) => moveKeys.has(code));
   const run = held.has("ShiftLeft") || held.has("ShiftRight");
   state = stepCharacterSpeed(state, { move, run }, dt, tuning);
   const sample = kit.sample(state.speed, dt);
+  governor = governor.step(
+    { fps: 1 / Math.max(1 / 240, dt), frameTimeMs: dt * 1000, draws: 0, tris: 0, particles: 0, shadowBytes: 0 },
+    governorBudget
+  );
   const proof: CharacterControllerProof = {
     speed: Number(state.speed.toFixed(3)),
     state: sample.state,
     moving: sample.moving,
     running: sample.running,
-    clipWeights: sample.clipWeights.map((w) => ({ clip: w.clip, weight: Number(w.weight.toFixed(3)) }))
+    clipWeights: sample.clipWeights.map((w) => ({ clip: w.clip, weight: Number(w.weight.toFixed(3)) })),
+    hero: { assetId: assets.showcaseWalkAnimatedGirl.id, url: assets.showcaseWalkAnimatedGirl.url, clip: "Take 001" },
+    debugDraw,
+    governor: { ...governor.settings }
   };
   window.__AURA3D_CHARACTER_CONTROLLER_PROOF__ = proof;
   hud.textContent = [
-    "Aura3D Character Controller — hold W/A/S/D (Shift = run)",
+    "Aura3D Character Controller — hold W/A/S/D (Shift = run, T = debug)",
     `speed: ${proof.speed}`,
     `state: ${proof.state}`,
-    `clips: ${proof.clipWeights.map((w) => `${w.clip} ${w.weight}`).join("  ")}`
+    `clips: ${proof.clipWeights.map((w) => `${w.clip} ${w.weight}`).join("  ")}`,
+    ...(debugDraw ? [`governor: res ${proof.governor.resolutionScale} lod ${proof.governor.lodBias} shadow ${proof.governor.shadowSize}`] : [])
   ].join("\n");
   requestAnimationFrame(frame);
 }

package/templates/character-controller/tests/certified-rig.spec.ts

@@ -0,0 +1,52 @@
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { expect, test } from "@playwright/test";
+
+test.setTimeout(60_000);
+
+/**
+ * E1 certified-rig mount proof for the character-controller template.
+ *
+ * The template hero must be one of the E1-certified hero rigs
+ * (docs/rendering/skinning-and-morphs.md "Certified hero rigs") — currently
+ * the humanoid-a slot: showcaseWalkAnimatedGirl / "Take 001". The mounted
+ * asset id AND url assert against that roster; a capsule/placeholder swap
+ * regresses this spec instead of silently shipping an uncertified hero.
+ *
+ * No raw GLB URL literal lives in this file (public-example-boundary): the
+ * expected url is read from the template's own generated typed assets.
+ */
+const CERTIFIED_ROSTER = ["showcaseWalkAnimatedGirl"] as const;
+function certifiedHeroFromTypedAssets(): { assetId: string; url: string; clip: string } {
+  const source = readFileSync(join(dirname(fileURLToPath(import.meta.url)), "..", "src", "aura-assets.ts"), "utf8");
+  for (const assetId of CERTIFIED_ROSTER) {
+    const pattern = new RegExp(`${assetId}:([\\s\\S]*?)\\n  \\},?\\n`);
+    const block = pattern.exec(source)?.[1] ?? "";
+    const url = /url:\s*"([^"]+)"/.exec(block)?.[1];
+    if (url) return { assetId, url, clip: "Take 001" };
+  }
+  throw new Error(`no certified-roster hero declared in the template typed assets (roster: ${CERTIFIED_ROSTER.join(", ")})`);
+}
+const CERTIFIED_HERO = certifiedHeroFromTypedAssets();
+
+test("character-controller hero mounts the certified humanoid-a rig", async ({ page }) => {
+  const errors: string[] = [];
+  page.on("pageerror", (error) => errors.push(error.message));
+
+  await page.goto("/");
+  await page.waitForFunction(
+    () => Boolean((window as unknown as { __AURA3D_CHARACTER_CONTROLLER_PROOF__?: unknown }).__AURA3D_CHARACTER_CONTROLLER_PROOF__),
+    undefined,
+    { timeout: 45_000 }
+  );
+  const hero = await page.evaluate(
+    () =>
+      (window as unknown as { __AURA3D_CHARACTER_CONTROLLER_PROOF__?: { readonly hero?: { readonly assetId?: string; readonly url?: string; readonly clip?: string } } })
+        .__AURA3D_CHARACTER_CONTROLLER_PROOF__?.hero
+  );
+  expect(hero?.assetId).toBe(CERTIFIED_HERO.assetId);
+  expect(hero?.url).toBe(CERTIFIED_HERO.url);
+  expect(hero?.clip).toBe(CERTIFIED_HERO.clip);
+  expect(errors).toEqual([]);
+});

package/templates/cinematic-scene/package.json

@@ -11,7 +11,8 @@
     "test": "playwright test tests/route-health.spec.ts tests/screenshot.spec.ts --workers=1"
   },
   "dependencies": {
-    "@aura3d/engine": "2.0.4"
+    "@aura3d/engine": "3.0.0",
+    "@aura3d/navigation-recast": "3.0.0"
   },
   "devDependencies": {
     "@playwright/test": "^1.52.0",

package/templates/episode-builder/package.json

@@ -11,7 +11,8 @@
     "test": "playwright test tests/route-health.spec.ts tests/storyboard-playback.spec.ts --workers=1"
   },
   "dependencies": {
-    "@aura3d/engine": "2.0.4"
+    "@aura3d/engine": "3.0.0",
+    "@aura3d/navigation-recast": "3.0.0"
   },
   "devDependencies": {
     "@playwright/test": "^1.52.0",

package/templates/falling-blocks-starter/package.json

@@ -11,7 +11,8 @@
     "test": "playwright test tests/playable.spec.ts --workers=1"
   },
   "dependencies": {
-    "@aura3d/engine": "2.0.4"
+    "@aura3d/engine": "3.0.0",
+    "@aura3d/navigation-recast": "3.0.0"
   },
   "devDependencies": {
     "@types/node": "^22.15.30",

package/templates/fighting-game/README.md

@@ -22,11 +22,12 @@ This template demonstrates Aura3D's public game runtime APIs:
 - `src/game/stage.ts` owns `games.fighting` stage helpers, touch controls, debug colliders, and route/build readiness declarations.
 - `src/aura-assets.ts` is the typed asset manifest generated by the Aura3D CLI.
 
-The scaffold does not ship invented fighter GLBs or raw model URLs. It starts
-with Aura3D runtime-node source placeholders so the route is playable and the
-combat systems are inspectable. Add real fighter assets through the Aura3D CLI
-to switch the placeholders to typed `model(assets.playerFighter)` and
-`model(assets.rivalFighter)` nodes automatically.
+The scaffold ships two E1-certified hero rigs as its fighters (no invented
+GLBs or raw model URLs): `model(assets.showcaseWalkAnimatedGirl)` (player,
+humanoid-a) and `model(assets.showcaseRunnerRobot)` (rival, creature). If the
+typed assets are ever removed, the route falls back to Aura3D runtime-node
+source placeholders so it stays playable and the combat systems stay
+inspectable.
 
 Controls:
 
@@ -44,8 +45,8 @@ Add fighter assets:
 
 ```bash
 npx @aura3d/cli@latest assets search "animated humanoid fighting character" --profile fighting-character --json
-npx @aura3d/cli@latest assets resolve "animated humanoid fighting character" --name playerFighter --profile fighting-character
-npx @aura3d/cli@latest assets resolve "animated humanoid fighting character" --name rivalFighter --profile fighting-character
+npx @aura3d/cli@latest assets resolve "animated humanoid fighting character" --name showcaseWalkAnimatedGirl --profile fighting-character
+npx @aura3d/cli@latest assets resolve "animated creature fighting character" --name showcaseRunnerRobot --profile fighting-character
 ```
 
 The CLI writes typed definitions to `src/aura-assets.ts`. The starter imports

package/templates/fighting-game/aura.assets.json

@@ -3,5 +3,66 @@
   "assetBasePath": "/aura-assets/",
   "outputDir": "public/aura-assets",
   "typegen": "src/aura-assets.ts",
-  "assets": []
+  "assets": [
+    {
+      "id": "showcaseWalkAnimatedGirl",
+      "type": "model",
+      "format": "glb",
+      "source": "public/aura-assets/showcaseWalkAnimatedGirl.93872fc2.glb",
+      "outputPath": "public/aura-assets/showcaseWalkAnimatedGirl.93872fc2.glb",
+      "url": "/aura-assets/showcaseWalkAnimatedGirl.93872fc2.glb",
+      "hash": "sha256-93872fc24240a071b6195d6f1339f40b09b3308dc998311252d21ebd9042d8c6",
+      "sizeBytes": 3791152,
+      "bounds": [
+        86.929,
+        161.836,
+        37.758
+      ],
+      "materials": [
+        "material_0",
+        "material_1",
+        "material_0_0",
+        "material_0_1",
+        "material_0_2",
+        "material_0_3",
+        "material_0_4"
+      ],
+      "animations": [
+        "Take 001"
+      ],
+      "textures": [],
+      "thumbnailUrl": "/aura-assets/showcaseWalkAnimatedGirl.thumb.svg"
+    },
+    {
+      "id": "showcaseRunnerRobot",
+      "type": "model",
+      "format": "glb",
+      "source": "public/aura-assets/showcaseRunnerRobot.252b3a16.glb",
+      "outputPath": "public/aura-assets/showcaseRunnerRobot.252b3a16.glb",
+      "url": "/aura-assets/showcaseRunnerRobot.252b3a16.glb",
+      "hash": "sha256-252b3a16d5a8d7fd67a4304ec8135d4fa492802a31bc2fc2d4614e130a1f4e73",
+      "sizeBytes": 5500216,
+      "bounds": [
+        17.509,
+        9.101,
+        27.461
+      ],
+      "materials": [
+        "HEAD",
+        "EYES",
+        "BODY",
+        "HINGE",
+        "material",
+        "material_5"
+      ],
+      "animations": [
+        "IDLE",
+        "WALK",
+        "RUN",
+        "ALL"
+      ],
+      "textures": [],
+      "thumbnailUrl": "/aura-assets/showcaseRunnerRobot.thumb.svg"
+    }
+  ]
 }

package/templates/fighting-game/package.json

@@ -8,10 +8,11 @@
     "typecheck": "tsc --noEmit",
     "build": "npm run typecheck && vite build",
     "preview": "vite preview --host 127.0.0.1",
-    "test": "playwright test tests/route-health.spec.ts tests/gameplay-smoke.spec.ts --workers=1"
+    "test": "playwright test tests/route-health.spec.ts tests/gameplay-smoke.spec.ts tests/certified-rig.spec.ts --workers=1"
   },
   "dependencies": {
-    "@aura3d/engine": "2.0.4"
+    "@aura3d/engine": "3.0.0",
+    "@aura3d/navigation-recast": "3.0.0"
   },
   "devDependencies": {
     "@playwright/test": "^1.52.0",

package/templates/fighting-game/public/aura-assets/showcaseRunnerRobot.thumb.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 320 180"><rect width="320" height="180" fill="#101720"/><path d="M80 126 160 46l80 80-80 28z" fill="#77a7ff"/><text x="160" y="160" text-anchor="middle" font-family="Arial" font-size="18" fill="#f4f7fb">showcaseRunnerRobot 17.509x14.644x3.963</text></svg>

package/templates/fighting-game/public/aura-assets/showcaseWalkAnimatedGirl.thumb.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 320 180"><rect width="320" height="180" fill="#101720"/><path d="M80 126 160 46l80 80-80 28z" fill="#77a7ff"/><text x="160" y="160" text-anchor="middle" font-family="Arial" font-size="18" fill="#f4f7fb">showcaseWalkAnimatedGirl 86.929x161.836x37.758</text></svg>

package/templates/fighting-game/src/aura-assets.ts

@@ -2,10 +2,41 @@ import { defineAuraAssets } from "@aura3d/engine";
 
 export const assets = defineAuraAssets({
   /*
-   * Add your own fighter GLBs with the Aura3D CLI, then keep these generated
-   * keys so src/main.ts can switch from source placeholders to typed models:
+   * Certified E1 hero rigs ship as the default fighters (see
+   * docs/rendering/skinning-and-morphs.md "Certified hero rigs"):
+   * - player: showcaseWalkAnimatedGirl (humanoid-a) / "Take 001"
+   * - rival: showcaseRunnerRobot (creature) / "WALK"
    *
-   * npx @aura3d/cli@latest assets add ./assets/player-fighter.glb --name playerFighter
-   * npx @aura3d/cli@latest assets add ./assets/rival-fighter.glb --name rivalFighter
+   * Swap in your own fighter GLBs with the Aura3D CLI and keep these keys so
+   * src/main.ts keeps mounting typed models instead of source placeholders:
+   *
+   * npx @aura3d/cli@latest assets add ./assets/player-fighter.glb --name showcaseWalkAnimatedGirl
+   * npx @aura3d/cli@latest assets add ./assets/rival-fighter.glb --name showcaseRunnerRobot
    */
-});
+  showcaseWalkAnimatedGirl: {
+    type: "model",
+    format: "glb",
+    url: "/aura-assets/showcaseWalkAnimatedGirl.93872fc2.glb",
+    bounds: [86.929, 161.836, 37.758],
+    hash: "sha256-93872fc24240a071b6195d6f1339f40b09b3308dc998311252d21ebd9042d8c6",
+    metadata: {
+      materials: ["material_0", "material_1", "material_0_0", "material_0_1", "material_0_2", "material_0_3", "material_0_4"],
+      animations: ["Take 001"],
+      textures: [],
+      thumbnailUrl: "/aura-assets/showcaseWalkAnimatedGirl.thumb.svg"
+    }
+  },
+  showcaseRunnerRobot: {
+    type: "model",
+    format: "glb",
+    url: "/aura-assets/showcaseRunnerRobot.252b3a16.glb",
+    bounds: [17.509, 9.101, 27.461],
+    hash: "sha256-252b3a16d5a8d7fd67a4304ec8135d4fa492802a31bc2fc2d4614e130a1f4e73",
+    metadata: {
+      materials: ["HEAD", "EYES", "BODY", "HINGE", "material", "material_5"],
+      animations: ["IDLE", "WALK", "RUN", "ALL"],
+      textures: [],
+      thumbnailUrl: "/aura-assets/showcaseRunnerRobot.thumb.svg"
+    }
+  }
+} as const);