create-aura3d 3.0.0 → 4.0.0

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

@@ -5,64 +5,74 @@
   "typegen": "src/aura-assets.ts",
   "assets": [
     {
-      "id": "showcaseWalkAnimatedGirl",
+      "id": "auraclashPlayerRig",
       "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"
-      ],
+      "source": "public/aura-assets/auraclash-player-rig.glb",
+      "outputPath": "public/aura-assets/auraclash-player-rig.glb",
+      "url": "/aura-assets/auraclash-player-rig.glb",
+      "hash": "sha256-3318d671632878ed27b8af6de88c6e5ca647e0d4a04cf03780d555fa07cec087",
+      "sizeBytes": 7822664,
+      "materials": [],
       "animations": [
-        "Take 001"
+        "Crouch_Idle_Loop",
+        "Death01",
+        "Hit_Chest",
+        "Hit_Head",
+        "Idle_Loop",
+        "Jump_Loop",
+        "Punch_Cross",
+        "Punch_Jab",
+        "Sprint_Loop",
+        "Sword_Attack",
+        "Walk_Loop",
+        "Sword_Block"
       ],
       "textures": [],
-      "thumbnailUrl": "/aura-assets/showcaseWalkAnimatedGirl.thumb.svg"
+      "libraryId": "auraclash-player-rig",
+      "libraryKit": "characters/humanoid-pbr",
+      "license": "CC0",
+      "attribution": "Quaternius",
+      "sourcePage": "https://quaternius.itch.io/modular-character-outfits-fantasy",
+      "bounds": [
+        1.669,
+        1.788,
+        0.349
+      ]
     },
     {
-      "id": "showcaseRunnerRobot",
+      "id": "auraclashRivalRig",
       "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"
-      ],
+      "source": "public/aura-assets/auraclash-rival-rig.glb",
+      "outputPath": "public/aura-assets/auraclash-rival-rig.glb",
+      "url": "/aura-assets/auraclash-rival-rig.glb",
+      "hash": "sha256-c8d844dc4a70bc5d548c1bdd5c20c7a2f336529088fd350098431adf87cdf13b",
+      "sizeBytes": 4732472,
+      "materials": [],
       "animations": [
-        "IDLE",
-        "WALK",
-        "RUN",
-        "ALL"
+        "Hit_Knockback",
+        "Idle_FoldArms_Loop",
+        "LayToIdle",
+        "Melee_Hook",
+        "NinjaJump_Idle_Loop",
+        "Shield_Dash_RM",
+        "Sword_Block",
+        "Sword_Regular_A",
+        "Sword_Regular_Combo",
+        "Zombie_Walk_Fwd_Loop"
       ],
       "textures": [],
-      "thumbnailUrl": "/aura-assets/showcaseRunnerRobot.thumb.svg"
+      "libraryId": "auraclash-rival-rig",
+      "libraryKit": "characters/humanoid-pbr",
+      "license": "CC0",
+      "attribution": "Quaternius",
+      "sourcePage": "https://quaternius.itch.io/modular-character-outfits-fantasy",
+      "bounds": [
+        1.799,
+        1.869,
+        0.373
+      ]
     }
   ]
 }

package/templates/fighting-game/package.json

@@ -11,11 +11,13 @@
     "test": "playwright test tests/route-health.spec.ts tests/gameplay-smoke.spec.ts tests/certified-rig.spec.ts --workers=1"
   },
   "dependencies": {
-    "@aura3d/engine": "3.0.0",
-    "@aura3d/navigation-recast": "3.0.0"
+    "@aura3d/engine": "4.0.0",
+    "@aura3d/navigation-recast": "4.0.0",
+    "@aura3d/assets": "4.0.0"
   },
   "devDependencies": {
-    "@playwright/test": "^1.52.0",
+    "@playwright/test": "1.59.1",
+    "@types/node": "^22.15.30",
     "typescript": "^5.8.3",
     "vite": "^7.3.2"
   }

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

@@ -2,41 +2,75 @@ import { defineAuraAssets } from "@aura3d/engine";
 
 export const assets = defineAuraAssets({
   /*
-   * 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"
+   * Library humanoid rigs ship as the default fighters (#481 mapping;
+   * characters/humanoid-pbr kit, CC0/Quaternius):
+   * - player: auraclashPlayerRig / "Idle_Loop"
+   * - rival:  auraclashRivalRig  / "Zombie_Walk_Fwd_Loop"
    *
    * 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
+   * npx @aura3d/cli@latest assets add ./assets/player-fighter.glb --name auraclashPlayerRig
+   * npx @aura3d/cli@latest assets add ./assets/rival-fighter.glb --name auraclashRivalRig
    */
-  showcaseWalkAnimatedGirl: {
+  auraclashPlayerRig: {
     type: "model",
     format: "glb",
-    url: "/aura-assets/showcaseWalkAnimatedGirl.93872fc2.glb",
-    bounds: [86.929, 161.836, 37.758],
-    hash: "sha256-93872fc24240a071b6195d6f1339f40b09b3308dc998311252d21ebd9042d8c6",
+    url: "/aura-assets/auraclash-player-rig.glb",
+    bounds: [1.669, 1.788, 0.349],
+    hash: "sha256-3318d671632878ed27b8af6de88c6e5ca647e0d4a04cf03780d555fa07cec087",
     metadata: {
-      materials: ["material_0", "material_1", "material_0_0", "material_0_1", "material_0_2", "material_0_3", "material_0_4"],
-      animations: ["Take 001"],
+      materials: [],
+      animations: [
+        "Crouch_Idle_Loop",
+        "Death01",
+        "Hit_Chest",
+        "Hit_Head",
+        "Idle_Loop",
+        "Jump_Loop",
+        "Punch_Cross",
+        "Punch_Jab",
+        "Sprint_Loop",
+        "Sword_Attack",
+        "Walk_Loop",
+        "Sword_Block"
+      ],
       textures: [],
-      thumbnailUrl: "/aura-assets/showcaseWalkAnimatedGirl.thumb.svg"
+      thumbnailUrl: "",
+      libraryId: "auraclash-player-rig",
+      libraryKit: "characters/humanoid-pbr",
+      license: "CC0",
+      attribution: "Quaternius",
+      sourcePage: "https://quaternius.itch.io/modular-character-outfits-fantasy"
     }
   },
-  showcaseRunnerRobot: {
+  auraclashRivalRig: {
     type: "model",
     format: "glb",
-    url: "/aura-assets/showcaseRunnerRobot.252b3a16.glb",
-    bounds: [17.509, 9.101, 27.461],
-    hash: "sha256-252b3a16d5a8d7fd67a4304ec8135d4fa492802a31bc2fc2d4614e130a1f4e73",
+    url: "/aura-assets/auraclash-rival-rig.glb",
+    bounds: [1.799, 1.869, 0.373],
+    hash: "sha256-c8d844dc4a70bc5d548c1bdd5c20c7a2f336529088fd350098431adf87cdf13b",
     metadata: {
-      materials: ["HEAD", "EYES", "BODY", "HINGE", "material", "material_5"],
-      animations: ["IDLE", "WALK", "RUN", "ALL"],
+      materials: [],
+      animations: [
+        "Hit_Knockback",
+        "Idle_FoldArms_Loop",
+        "LayToIdle",
+        "Melee_Hook",
+        "NinjaJump_Idle_Loop",
+        "Shield_Dash_RM",
+        "Sword_Block",
+        "Sword_Regular_A",
+        "Sword_Regular_Combo",
+        "Zombie_Walk_Fwd_Loop"
+      ],
       textures: [],
-      thumbnailUrl: "/aura-assets/showcaseRunnerRobot.thumb.svg"
+      thumbnailUrl: "",
+      libraryId: "auraclash-rival-rig",
+      libraryKit: "characters/humanoid-pbr",
+      license: "CC0",
+      attribution: "Quaternius",
+      sourcePage: "https://quaternius.itch.io/modular-character-outfits-fantasy"
     }
   }
 } as const);

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

@@ -8,20 +8,49 @@ import {
   primitives
 } from "@aura3d/engine";
 
+/**
+ * T0.9a clip-map contract (Q-06-8 / #488). The engine's `validateClipMap` lives
+ * on the in-repo lane barrel, which the published `@aura3d/engine` does not
+ * export, so a scaffolded project could not type-check or bundle the import.
+ * Same contract here: every required state must map to an embedded clip
+ * (else FIGHTER_CLIP_MISSING with the list); each stand-in warns once.
+ */
+interface AuraClipMapEntry {
+  readonly clip: string;
+  readonly standIn?: boolean;
+}
+
+function validateClipMap<State extends string>(
+  map: Record<State, AuraClipMapEntry>,
+  options: { readonly availableClips: readonly string[]; readonly requiredStates: readonly State[]; readonly label: string }
+): void {
+  const available = new Set(options.availableClips);
+  const missing: string[] = [];
+  for (const state of options.requiredStates) {
+    const entry = map[state];
+    if (!entry || !available.has(entry.clip)) {
+      missing.push(entry ? `${state}→"${entry.clip}"` : state);
+    } else if (entry.standIn === true) {
+      console.warn(`FIGHTER_CLIP_STAND_IN: ${options.label} state "${state}" stands in with "${entry.clip}".`);
+    }
+  }
+  if (missing.length > 0) throw new Error(`FIGHTER_CLIP_MISSING (${options.label}): ${missing.join(", ")}`);
+}
+
 export type FighterId = "player" | "rival";
 /**
- * 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"
+ * Library humanoid rigs mounted as the two fighters (#481 mapping;
+ * characters/humanoid-pbr kit). The asset keys ARE the manifest ids, so the
+ * mounted asset id asserts directly against the template manifest:
+ * - player: auraclashPlayerRig / "Idle_Loop"
+ * - rival:  auraclashRivalRig  / "Zombie_Walk_Fwd_Loop"
  */
-export const PLAYER_FIGHTER_ASSET = "showcaseWalkAnimatedGirl" as const;
-export const RIVAL_FIGHTER_ASSET = "showcaseRunnerRobot" as const;
+export const PLAYER_FIGHTER_ASSET = "auraclashPlayerRig" as const;
+export const RIVAL_FIGHTER_ASSET = "auraclashRivalRig" 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"
+  player: "Idle_Loop",
+  rival: "Zombie_Walk_Fwd_Loop"
 };
 export type FighterClip = "idle" | "walk" | "jump" | "dash" | "guard" | "light" | "heavy" | "special" | "hitstun";
 
@@ -47,10 +76,10 @@ export const REQUIRED_FIGHTER_CLIPS: readonly FighterClip[] = [
 ];
 
 export const publicAssetInstructions = [
-  "certified default heroes: showcaseWalkAnimatedGirl (player) + showcaseRunnerRobot (rival)",
+  "certified default heroes: auraclashPlayerRig (player) + auraclashRivalRig (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 showcaseWalkAnimatedGirl --profile fighting-character",
-  "npx @aura3d/cli@latest assets resolve \"animated creature fighting character\" --name showcaseRunnerRobot --profile fighting-character",
+  "npx @aura3d/cli@latest assets resolve \"animated humanoid fighting character\" --name auraclashPlayerRig --profile fighting-character",
+  "npx @aura3d/cli@latest assets resolve \"animated creature fighting character\" --name auraclashRivalRig --profile fighting-character",
   "npx @aura3d/cli@latest assets validate-game --profile fighting-character --json"
 ] as const;
 
@@ -95,6 +124,22 @@ export function createFighterAnimationController(
   id: FighterId,
   asset?: AuraAssetRef<"model">
 ): AnimationController<FighterClip> {
+  if (asset) {
+    // Adopt the T0.9a clip-map contract (Q-06-8 / #488): every fighter state
+    // resolves through `validateClipMap` against the embedded GLB clips, so an
+    // absent clip throws FIGHTER_CLIP_MISSING and stand-ins warn uniformly.
+    const certified = FIGHTER_CERTIFIED_CLIP[id];
+    // No fallback to the certified clip: an asset without embedded animation
+    // metadata must fail validation, not pass it by assumption.
+    const embedded = asset.metadata?.animations;
+    const availableClips = Array.isArray(embedded)
+      ? embedded.filter((clip): clip is string => typeof clip === "string")
+      : [];
+    const clipMap = Object.fromEntries(
+      REQUIRED_FIGHTER_CLIPS.map((state) => [state, { clip: certified, standIn: true as const }])
+    ) as Record<FighterClip, AuraClipMapEntry>;
+    validateClipMap(clipMap, { availableClips, requiredStates: REQUIRED_FIGHTER_CLIPS, label: id });
+  }
   return new AnimationController<FighterClip>({
     id: `${id}-animation-controller`,
     ...(asset ? { clipRegistry: animationClipRegistry(asset) } : {}),