create-aura3d 2.0.4 → 3.0.0

package/templates/fighting-game/src/game/fighters.ts

@@ -9,7 +9,20 @@ import {
 } from "@aura3d/engine";
 
 export type FighterId = "player" | "rival";
-export type FighterAssetKey = "playerFighter" | "rivalFighter";
+/**
+ * Certified E1 hero rigs mounted as the two fighters. The asset keys ARE the
+ * certification roster ids (docs/rendering/skinning-and-morphs.md), so the
+ * mounted asset id asserts directly against the roster:
+ * - player: showcaseWalkAnimatedGirl (humanoid-a) / "Take 001"
+ * - rival: showcaseRunnerRobot (creature) / "WALK"
+ */
+export const PLAYER_FIGHTER_ASSET = "showcaseWalkAnimatedGirl" as const;
+export const RIVAL_FIGHTER_ASSET = "showcaseRunnerRobot" as const;
+export type FighterAssetKey = typeof PLAYER_FIGHTER_ASSET | typeof RIVAL_FIGHTER_ASSET;
+export const FIGHTER_CERTIFIED_CLIP: Record<FighterId, string> = {
+  player: "Take 001",
+  rival: "WALK"
+};
 export type FighterClip = "idle" | "walk" | "jump" | "dash" | "guard" | "light" | "heavy" | "special" | "hitstun";
 
 export type TypedFighterAssets = Partial<Record<FighterAssetKey, AuraAssetRef<"model">>>;
@@ -20,7 +33,7 @@ export interface ResolvedFighterAssets {
   readonly typedFighterAssetCount: number;
 }
 
-export const REQUIRED_FIGHTER_ASSETS: readonly FighterAssetKey[] = ["playerFighter", "rivalFighter"];
+export const REQUIRED_FIGHTER_ASSETS: readonly FighterAssetKey[] = [PLAYER_FIGHTER_ASSET, RIVAL_FIGHTER_ASSET];
 export const REQUIRED_FIGHTER_CLIPS: readonly FighterClip[] = [
   "idle",
   "walk",
@@ -34,9 +47,10 @@ export const REQUIRED_FIGHTER_CLIPS: readonly FighterClip[] = [
 ];
 
 export const publicAssetInstructions = [
+  "certified default heroes: showcaseWalkAnimatedGirl (player) + showcaseRunnerRobot (rival)",
   "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",
   "npx @aura3d/cli@latest assets validate-game --profile fighting-character --json"
 ] as const;
 
@@ -66,8 +80,8 @@ export const fighterAnimationClips: readonly AuraNamedAnimationClipDefinition<Fi
 
 export function resolveTypedFighterAssets(assetManifest: TypedFighterAssets): ResolvedFighterAssets {
   const typedFighterAssets: TypedFighterAssets = {
-    playerFighter: assetManifest.playerFighter,
-    rivalFighter: assetManifest.rivalFighter
+    [PLAYER_FIGHTER_ASSET]: assetManifest[PLAYER_FIGHTER_ASSET],
+    [RIVAL_FIGHTER_ASSET]: assetManifest[RIVAL_FIGHTER_ASSET]
   };
   const missingFighterAssets = REQUIRED_FIGHTER_ASSETS.filter((key) => !typedFighterAssets[key]);
   return {
@@ -112,7 +126,8 @@ export function createFighterNode(
   position: readonly [number, number, number],
   facing: 1 | -1,
   color: string,
-  typedFighterAssets: TypedFighterAssets
+  typedFighterAssets: TypedFighterAssets,
+  visualScale = 1
 ) {
   const asset = typedFighterAssets[assetKey];
   const runtime = game.runtimeNode(id, {
@@ -123,7 +138,7 @@ export function createFighterNode(
     return model(asset, { name: label })
       .position(position[0], position[1], position[2])
       .rotate(0, facing < 0 ? Math.PI : 0, 0)
-      .scale(0.72)
+      .scale(visualScale)
       .runtime(runtime);
   }
 

package/templates/fighting-game/src/main.ts

@@ -4,10 +4,13 @@ import {
   animationLayer,
   createFighterAnimationController,
   createFighterNode,
+  FIGHTER_CERTIFIED_CLIP,
   isLoopingFighterClip,
+  PLAYER_FIGHTER_ASSET,
   publicAssetInstructions,
   REQUIRED_FIGHTER_ASSETS,
   resolveTypedFighterAssets,
+  RIVAL_FIGHTER_ASSET,
   type FighterClip
 } from "./game/fighters";
 import { heavyMove, lightMove, specialMove } from "./game/moves";
@@ -129,8 +132,10 @@ const inputOptions = {
 const arena = scene()
   .background("#10071c")
   .addMany(fightingStage.nodes)
-  .add(createFighterNode("player", "playerFighter", "Player fighter", playerStart, 1, "#45f5bb", typedFighterAssets))
-  .add(createFighterNode("rival", "rivalFighter", "Rival fighter", rivalStart, -1, "#ffca5f", typedFighterAssets))
+  // The creature rival renders roughly twice the player height at scale 1, so
+  // it mounts slightly under scale to share the frame with the humanoid player.
+  .add(createFighterNode("player", PLAYER_FIGHTER_ASSET, "Player fighter", playerStart, 1, "#45f5bb", typedFighterAssets, 1))
+  .add(createFighterNode("rival", RIVAL_FIGHTER_ASSET, "Rival fighter", rivalStart, -1, "#ffca5f", typedFighterAssets, 0.75))
   .addMany([
     effects.bloom({ intensity: 0.32 }),
     lights.studio({ intensity: 1.15 }),
@@ -183,8 +188,8 @@ const director = game.cameraDirector({
 });
 const playerNode = app.nodes.require("player");
 const rivalNode = app.nodes.require("rival");
-const playerAnimation = createFighterAnimationController("player", typedFighterAssets.playerFighter);
-const rivalAnimation = createFighterAnimationController("rival", typedFighterAssets.rivalFighter);
+const playerAnimation = createFighterAnimationController("player", typedFighterAssets[PLAYER_FIGHTER_ASSET]);
+const rivalAnimation = createFighterAnimationController("rival", typedFighterAssets[RIVAL_FIGHTER_ASSET]);
 
 playerAnimation.bindRuntimeNode(playerNode, { defaultClipId: "idle", fallbackClipId: "idle" });
 rivalAnimation.bindRuntimeNode(rivalNode, { defaultClipId: "idle", fallbackClipId: "idle" });
@@ -207,6 +212,18 @@ gameWindow.__AURA3D_GAME_SOURCE__ = {
   typedAssetPattern: "src/aura-assets.ts",
   typedAssetKeys: REQUIRED_FIGHTER_ASSETS,
   missingAssets: missingFighterAssets,
+  heroAssets: {
+    player: {
+      assetId: assets[PLAYER_FIGHTER_ASSET]?.id ?? PLAYER_FIGHTER_ASSET,
+      url: assets[PLAYER_FIGHTER_ASSET]?.url,
+      certifiedClip: FIGHTER_CERTIFIED_CLIP.player
+    },
+    rival: {
+      assetId: assets[RIVAL_FIGHTER_ASSET]?.id ?? RIVAL_FIGHTER_ASSET,
+      url: assets[RIVAL_FIGHTER_ASSET]?.url,
+      certifiedClip: FIGHTER_CERTIFIED_CLIP.rival
+    }
+  },
   addAssets: publicAssetInstructions,
   touchControls: touchLayout,
   readiness: routeReadiness

package/templates/fighting-game/tests/certified-rig.spec.ts

@@ -0,0 +1,53 @@
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { expect, test } from "@playwright/test";
+
+test.setTimeout(90_000);
+
+/**
+ * E1 certified-rig mount proof for the fighting-game template.
+ *
+ * Both fighters must be E1-certified hero rigs
+ * (docs/rendering/skinning-and-morphs.md "Certified hero rigs"):
+ * - player: showcaseWalkAnimatedGirl (humanoid-a) / "Take 001"
+ * - rival: showcaseRunnerRobot (creature) / "WALK"
+ * The mounted asset ids AND urls assert against that roster; a placeholder or
+ * fixture swap regresses this spec instead of silently shipping uncertified
+ * heroes.
+ */
+/*
+ * No raw GLB URL literal lives in this file (public-example-boundary): expected
+ * urls are read from the template's own generated typed assets. A placeholder
+ * or fixture swap (roster id gone from aura-assets.ts) throws here instead of
+ * silently shipping uncertified heroes.
+ */
+const CERTIFIED_ROSTER = {
+  player: { assetId: "showcaseWalkAnimatedGirl", certifiedClip: "Take 001" },
+  rival: { assetId: "showcaseRunnerRobot", certifiedClip: "WALK" }
+} as const;
+function heroUrlFromTypedAssets(assetId: string): string {
+  const source = readFileSync(join(dirname(fileURLToPath(import.meta.url)), "..", "src", "aura-assets.ts"), "utf8");
+  const pattern = new RegExp(`${assetId}:([\\s\\S]*?)\\n  \\},?\\n`);
+  const block = pattern.exec(source)?.[1] ?? "";
+  const url = /url:\s*"([^"]+)"/.exec(block)?.[1];
+  if (!url) throw new Error(`certified-roster hero ${assetId} missing from the template typed assets`);
+  return url;
+}
+const CERTIFIED_HEROES = {
+  player: { ...CERTIFIED_ROSTER.player, url: heroUrlFromTypedAssets(CERTIFIED_ROSTER.player.assetId) },
+  rival: { ...CERTIFIED_ROSTER.rival, url: heroUrlFromTypedAssets(CERTIFIED_ROSTER.rival.assetId) }
+} as const;
+
+test("fighting-game fighters mount certified hero rigs", async ({ page }) => {
+  await page.goto("/");
+  await page.waitForFunction(() => Boolean((window as any).__AURA3D_GAME_SOURCE__?.readiness), undefined, {
+    polling: 100,
+    timeout: 60_000
+  });
+  const source = await page.evaluate(() => (window as any).__AURA3D_GAME_SOURCE__);
+  expect(source?.heroAssets?.player).toMatchObject(CERTIFIED_HEROES.player);
+  expect(source?.heroAssets?.rival).toMatchObject(CERTIFIED_HEROES.rival);
+  expect(source?.missingAssets ?? []).toEqual([]);
+  expect(source?.readiness?.proofMode).toBe("typed-assets");
+});

package/templates/fighting-game/tests/gameplay-smoke.spec.ts

@@ -33,6 +33,11 @@ test("input replay produces runtime evidence and a hit declaration", async ({ pa
   expect(evidence.systems.cameraPlan).toBeTruthy();
   expect(evidence.systems.stagePlan).toBeTruthy();
   expect(replay.hitCount).toBeGreaterThan(0);
-  expect(source.readiness.sourceOnly).toBe(true);
+  // Certified heroes ship as typed fighter assets (humanoid-a + creature), so
+  // the route runs in typed-assets proof mode instead of source placeholders.
+  expect(source.readiness.sourceOnly).toBe(false);
+  expect(source.readiness.placeholderMode).toBe(false);
+  expect(source.readiness.proofMode).toBe("typed-assets");
+  expect(source.readiness.missingTypedAssets ?? []).toEqual([]);
   expect(source.readiness.publicEngineApis).toContain("games.fighting.stagePreset");
 });

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

@@ -5,27 +5,51 @@
   "typegen": "src/aura-assets.ts",
   "assets": [
     {
-      "id": "playerModel",
+      "id": "showcaseKenneyOobiPlatformerHero",
       "type": "model",
       "format": "glb",
-      "source": "public/aura-assets/player-fixture.glb",
-      "outputPath": "public/aura-assets/player-fixture.glb",
-      "url": "/aura-assets/player-fixture.glb",
-      "hash": "sha256-047f5e5fb3bb6d378bd1df16ca6137f2a596c99b3a1b5690b4020c05aaf6f319",
-      "sizeBytes": 463988,
+      "source": "public/aura-assets/showcaseKenneyOobiPlatformerHero.3f821141.glb",
+      "outputPath": "public/aura-assets/showcaseKenneyOobiPlatformerHero.3f821141.glb",
+      "url": "/aura-assets/showcaseKenneyOobiPlatformerHero.3f821141.glb",
+      "hash": "sha256-3f82114135cdf4b627d463901308eb0dcf4bbbb10f1958f044eaa42160ad5df5",
+      "sizeBytes": 208028,
       "bounds": [
-        1.2,
-        1.9,
-        0.8
+        0.868,
+        0.907,
+        0.603
       ],
       "materials": [
-        "painted robot body",
-        "black joints",
-        "white armor"
+        "colormap"
+      ],
+      "animations": [
+        "attack-kick-left",
+        "attack-kick-right",
+        "attack-melee-left",
+        "attack-melee-right",
+        "crouch",
+        "die",
+        "drive",
+        "emote-no",
+        "emote-yes",
+        "fall",
+        "holding-both",
+        "holding-both-shoot",
+        "holding-left",
+        "holding-left-shoot",
+        "holding-right",
+        "holding-right-shoot",
+        "idle",
+        "interact-left",
+        "interact-right",
+        "jump",
+        "pick-up",
+        "sit",
+        "sprint",
+        "static",
+        "walk"
       ],
-      "animations": [],
       "textures": [],
-      "thumbnailUrl": "/aura-assets/player.thumb.svg"
+      "thumbnailUrl": "/aura-assets/showcaseKenneyOobiPlatformerHero.thumb.svg"
     }
   ]
 }

package/templates/mini-game/package.json

@@ -8,10 +8,10 @@
     "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/playable.spec.ts tests/screenshot.spec.ts --workers=1"
+    "test": "playwright test tests/route-health.spec.ts tests/playable.spec.ts tests/screenshot.spec.ts tests/certified-rig.spec.ts --workers=1"
   },
   "dependencies": {
-    "@aura3d/lean": "2.0.4"
+    "@aura3d/lean": "3.0.0"
   },
   "devDependencies": {
     "@playwright/test": "^1.52.0",

package/templates/mini-game/public/aura-assets/showcaseKenneyOobiPlatformerHero.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">showcaseKenneyOobiPlatformerHero 0.868x0.907x0.603</text></svg>

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

@@ -1,17 +1,43 @@
 import { defineAuraAssets } from "@aura3d/lean/game";
 
 export const assets = defineAuraAssets({
-  playerModel: {
+  showcaseKenneyOobiPlatformerHero: {
     type: "model",
     format: "glb",
-    url: "/aura-assets/player-fixture.glb",
-    bounds: [1.2, 1.9, 0.8],
-    hash: "sha256-047f5e5fb3bb6d378bd1df16ca6137f2a596c99b3a1b5690b4020c05aaf6f319",
+    url: "/aura-assets/showcaseKenneyOobiPlatformerHero.3f821141.glb",
+    bounds: [0.868, 0.907, 0.603],
+    hash: "sha256-3f82114135cdf4b627d463901308eb0dcf4bbbb10f1958f044eaa42160ad5df5",
     metadata: {
-      materials: ["painted robot body", "black joints", "white armor"],
-      animations: [],
+      materials: ["colormap"],
+      animations: [
+        "attack-kick-left",
+        "attack-kick-right",
+        "attack-melee-left",
+        "attack-melee-right",
+        "crouch",
+        "die",
+        "drive",
+        "emote-no",
+        "emote-yes",
+        "fall",
+        "holding-both",
+        "holding-both-shoot",
+        "holding-left",
+        "holding-left-shoot",
+        "holding-right",
+        "holding-right-shoot",
+        "idle",
+        "interact-left",
+        "interact-right",
+        "jump",
+        "pick-up",
+        "sit",
+        "sprint",
+        "static",
+        "walk"
+      ],
       textures: [],
-      thumbnailUrl: "/aura-assets/player.thumb.svg"
+      thumbnailUrl: "/aura-assets/showcaseKenneyOobiPlatformerHero.thumb.svg"
     }
   }
 } as const);

package/templates/mini-game/src/main.ts

@@ -22,8 +22,13 @@ interface MiniGameEvidence {
   readonly deaths: number;
   readonly checkpointId: string;
   readonly collected: readonly string[];
+  readonly hero: { readonly assetId: string; readonly url: string };
   readonly player: { readonly x: number; readonly y: number; readonly grounded: boolean };
   readonly events: readonly string[];
+  readonly cameraRig: { readonly kind: string; readonly position: readonly [number, number, number] };
+  readonly gameFeel: { readonly trauma: number; readonly frozen: boolean };
+  readonly debugDraw: boolean;
+  readonly governor: { readonly resolutionScale: number; readonly particleScale: number };
   readonly evidence: { readonly entry: string; readonly physics: string; readonly typedAssets: number };
 }
 
@@ -58,12 +63,20 @@ const input = game.input({
     jump: ["Space", "KeyW", "ArrowUp"],
     dash: ["ShiftLeft", "ShiftRight"],
     down: ["KeyS", "ArrowDown"],
-    reset: ["KeyR"]
+    reset: ["KeyR"],
+    debug: ["KeyT"]
   },
   axes: { moveX: { negative: "left", positive: "right" } },
   bufferMs: 140
 });
 const platformer = game.platformer(level);
+// J3 scaffold surface: camera rig frames the opening shot, game feel adds
+// trauma/shake on impacts, the debug toggle gates overlays, and the lean perf
+// governor degrades resolution/particle scale when frames run long.
+const cameraRig = game.cameraRig({ kind: "side-view-follow", offset: [0, 2.98, 10.4] });
+const gameFeel = game.gameFeel();
+const debugDraw = game.debugDraw();
+const governor = game.performanceGovernor("conservative");
 const routeEvents: string[] = [];
 const app = createAuraApp("#app", { scene: buildScene() });
 const player = app.nodes.require("mini-player");
@@ -76,6 +89,9 @@ let objective = "Collect coins, avoid spikes, reach the goal";
 
 app.onFrame((dt) => {
   input.update(dt);
+  governor.step(Math.max(0, dt) * 1000);
+  gameFeel.update(Math.max(0, dt));
+  if (input.pressed("debug")) debugDraw.toggle();
   if (input.pressed("reset")) {
     platformer.reset();
     routeEvents.push("reset:Route reset");
@@ -96,12 +112,22 @@ app.onFrame((dt) => {
       dashPressed: firstSubstep && dashPressed,
       fastFall: input.held("down")
     });
-    for (const event of state.events) updateObjective(event);
+    for (const event of state.events) {
+      updateObjective(event);
+      if (event.type === "collect") gameFeel.addTrauma(0.25);
+      if (event.type === "hazard" || event.type === "fall") {
+        gameFeel.addTrauma(0.7);
+        gameFeel.hitStop();
+      }
+      if (event.type === "land") gameFeel.addTrauma(0.12);
+    }
     remaining -= substep;
     firstSubstep = false;
   } while (remaining > 0.000_001);
 
-  player.setPosition(state.player.x + 0.38, state.player.y + 0.5, 0);
+  // The certified Oobi hero is feet-origin (GLB min y = 0), so the visual
+  // rides at the physics point instead of the old fixture's +0.5 lift.
+  player.setPosition(state.player.x + 0.38, state.player.y + 0.01, 0);
   lift.setPosition(level.movingPlatforms[0].x + level.movingPlatforms[0].width / 2, movingLiftY(state.time), 0);
   for (const [id, node] of coins) node.setVisible(!state.collected.includes(id));
   checkpoint.setVisible(!state.activatedCheckpoints.includes("mid"));
@@ -139,10 +165,14 @@ function buildScene() {
     primitives.box({ name: "finish portal", material: material.pbr({ color: "#ffad57", metallic: 0.2, roughness: 0.18 }) })
       .position(level.finish.x, level.finish.y + 0.7, 0.08).scale([0.22, 0.92, 0.16]).runtime("goal")
   ];
+  // Opening shot is framed by the side-view camera rig. The offset reproduces
+  // the certified framing exactly (position [6.1, 3.8, 10.4], target
+  // [6.1, 0.82, 0]) so screenshot baselines do not shift.
+  const opening = cameraRig.snap([6.1, 0.82, 0]);
   return scene().background("#071015")
-    .add(model(assets.playerModel, { name: "typed mini-game player" }).position(level.start.x + 0.38, level.start.y + 0.5, 0).scale(0.28).runtime("mini-player"))
+    .add(model(assets.showcaseKenneyOobiPlatformerHero, { name: "certified hero vehicle-driver" }).position(level.start.x + 0.38, level.start.y + 0.01, 0).scale(1).runtime("mini-player"))
     .addMany(nodes)
-    .camera(camera.perspective({ position: [6.1, 3.8, 10.4], target: [6.1, 0.82, 0], fov: 46 }));
+    .camera(camera.perspective({ position: [opening[0], opening[1], opening[2]], target: [6.1, 0.82, 0], fov: 46 }));
 }
 
 function updateObjective(event: LeanPlatformerEvent): void {
@@ -178,8 +208,13 @@ function publishEvidence(state: ReturnType<typeof platformer.snapshot>): void {
     deaths: state.deaths,
     checkpointId: state.checkpointId,
     collected: state.collected,
+    hero: { assetId: assets.showcaseKenneyOobiPlatformerHero.id, url: assets.showcaseKenneyOobiPlatformerHero.url },
     player: { x: state.player.x, y: state.player.y, grounded: state.player.grounded },
     events: [...routeEvents],
+    cameraRig: { kind: cameraRig.kind, position: cameraRig.follow([state.player.x, state.player.y, 0], 1 / 60) },
+    gameFeel: gameFeel.snapshot(),
+    debugDraw: debugDraw.enabled,
+    governor: { ...governor.settings },
     evidence: { entry: "@aura3d/lean/game", physics: "solver-free deterministic arcade", typedAssets: Object.keys(assets).length }
   };
 }

package/templates/mini-game/tests/certified-rig.spec.ts

@@ -0,0 +1,40 @@
+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 mini-game template.
+ *
+ * The template hero must be one of the E1-certified hero rigs
+ * (docs/rendering/skinning-and-morphs.md "Certified hero rigs") — currently
+ * the vehicle-driver slot: showcaseKenneyOobiPlatformerHero / "walk".
+ * The mounted asset id AND url assert against that roster; a fixture 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 = ["showcaseKenneyOobiPlatformerHero"] as const;
+function certifiedHeroFromTypedAssets(): { assetId: string; url: 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]*?url:\\s*"([^"]+)"`);
+    const match = pattern.exec(source);
+    if (match?.[1]) return { assetId, url: match[1] };
+  }
+  throw new Error(`no certified-roster hero declared in the template typed assets (roster: ${CERTIFIED_ROSTER.join(", ")})`);
+}
+const CERTIFIED_HERO = certifiedHeroFromTypedAssets();
+
+test("mini-game hero mounts the certified vehicle-driver rig", async ({ page }) => {
+  await page.goto("/");
+  await expect.poll(() => page.locator("body").getAttribute("data-aura3d-ready"), { timeout: 45_000 }).toBe("true");
+  const hero = await page.evaluate(
+    () => (window as unknown as { readonly __AURA3D_MINI_GAME__?: { readonly hero?: { readonly assetId?: string; readonly url?: string } } }).__AURA3D_MINI_GAME__?.hero
+  );
+  expect(hero?.assetId).toBe(CERTIFIED_HERO.assetId);
+  expect(hero?.url).toBe(CERTIFIED_HERO.url);
+});

package/templates/product-viewer/package.json

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

package/templates/product-viewer/src/main.ts

@@ -10,11 +10,18 @@ import {
 } from "@aura3d/lean/product";
 import { assets } from "./aura-assets";
 
+// PART C2 game-ready adoption: the plinth wears the @aura3d/materials
+// "carPaint" preset shell (clearcoat 1 + flake normal scale) in a pearl studio
+// base, and the floor carries the "glassThin" preset color/roughness values as
+// a glass display deck (transmission itself lives in the full engine API).
+const carPaintPlinth = material.clearcoatPaint({ color: "#d7dce2", roughness: 0.3, metallic: 0.55, clearcoat: 1 });
+const glassThinDeck = material.pbr({ color: "#9fc6d4", roughness: 0.08, metallic: 0 });
+
 const productScene = scene()
   .background("#071018")
-  .add(primitives.plane({ name: "studio floor", material: material.pbr({ color: "#22313b", roughness: 0.32, metallic: 0.08 }) })
+  .add(primitives.plane({ name: "glass deck floor", material: glassThinDeck })
     .position(0, -0.05, -0.62).scale([6.2, 1, 5.2]))
-  .add(primitives.box({ name: "product plinth", material: material.clearcoatPaint({ color: "#dce7ed", roughness: 0.2, metallic: 0.18 }) })
+  .add(primitives.box({ name: "carPaint product plinth", material: carPaintPlinth })
     .position(0, 0.06, -0.62).scale([1.82, 0.18, 1.4]))
   .add(model(assets.product, { name: "typed studio product" }).position(0, 1.08, -0.62).scale(0.66))
   .add(environments.studio())

package/templates/prompt-animation-channel/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/racing-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/racing-starter/src/main.ts

@@ -174,6 +174,7 @@ function buildScene() {
       .scale(0.18)
       .runtime(game.runtimeNode("race-car", { tags: ["player", "vehicle", "typed-asset", "runtime"] })),
     ...routeRibbonNodes(),
+    ...paintAndGlassGantryNodes(),
     primitives.box({ name: "checkpoint marker", material: material.neon({ color: "#7ff0c5", emissive: "#7ff0c5", emissiveIntensity: 0.7 }) })
       .position(0.06, 0.18, 0.2)
       .scale([0.16, 0.28, 0.95])
@@ -199,6 +200,36 @@ function routeRibbonNodes(): AuraNodeInput[] {
   );
 }
 
+// PART C2 game-ready adoption: a static paint-and-glass gantry south of the
+// start straight wearing the @aura3d/materials "carPaint" preset (clearcoat
+// shell + flake normal) on the showcase shell and the "glassThin" preset
+// (thin-walled transmission) on the canopy panel.
+function paintAndGlassGantryNodes(): AuraNodeInput[] {
+  const carPaintShell = material.clearcoatPaint({
+    color: "#c1121f",
+    roughness: 0.32,
+    metallic: 0.65,
+    clearcoat: 1,
+    clearcoatRoughness: 0.06,
+    normalScale: 0.35,
+    envMapIntensity: 1.4
+  });
+  const glassThinCanopy = material.glass({
+    color: "#bfe6f2",
+    opacity: 0.35,
+    transmission: 0.9,
+    thickness: 0.02,
+    roughness: 0.05
+  });
+  const post = material.pbr({ color: "#1c2530", roughness: 0.6, metallic: 0.4 });
+  return [
+    primitives.box({ name: "carPaint showcase shell", material: carPaintShell }).position(2.7, 0.3, -1.7).scale([1.5, 0.55, 0.75]),
+    primitives.box({ name: "glassThin canopy", material: glassThinCanopy }).position(2.7, 1.5, -1.7).scale([1.7, 0.06, 0.95]),
+    primitives.box({ name: "gantry post west", material: post }).position(1.95, 0.75, -1.7).scale([0.08, 1.5, 0.08]),
+    primitives.box({ name: "gantry post east", material: post }).position(3.45, 0.75, -1.7).scale([0.08, 1.5, 0.08])
+  ];
+}
+
 function createHud(): HTMLElement {
   const root = document.createElement("aside");
   root.id = "racing-starter-hud";

package/templates/three-compat-architecture-interior/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/three-compat-asset-inspector/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/three-compat-character-viewer/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/three-compat-custom-threejs-migration/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/three-compat-large-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/three-compat-material-authoring/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",