@auraindustry/aurajs 0.0.7 → 0.1.0

package/templates/create/3d-collectathon/assets/models/starter-avatar.gltf

@@ -0,0 +1,184 @@
+{
+  "asset": {
+    "version": "2.0"
+  },
+  "buffers": [
+    {
+      "byteLength": 876,
+      "uri": "data:application/octet-stream;base64,AAAAvwAAAAAAAAC/AAAAPwAAAAAAAAC/AAAAPwAAgD8AAAC/AAAAvwAAgD8AAAC/AAAAvwAAAAAAAAA/AAAAPwAAAAAAAAA/AAAAPwAAgD8AAAA/AAAAvwAAgD8AAAA/AAABAAIAAAACAAMABAAGAAUABAAHAAYAAAAEAAUAAAAFAAEAAwACAAYAAwAGAAcAAQAFAAYAAQAGAAIAAAADAAcAAAAHAAQAAAAAAAAAAAAAAAAAAAAAAM3MTD0AAAAAAAAAAAAAAAAAAAAAAAAAAM3MrD8AAAAAAAAAAIXrsT8AAAAAAAAAAM3MrD8AAAAAAAAAAGZm5j5mZmY/AAAAAAAAAAAAAAAAAAAAAI/CdT0AAAAAAAAAAAAAAAAAAAAAPQrXvuxROD8K16M9PQrXvnsULj8K16O9PQrXvuxROD8K16M9PQrXPuxROD8K16O9PQrXPnsULj8K16M9PQrXPuxROD8K16O9KVwPvuxROD4K16O9KVwPvilcDz4K16M9KVwPvuxROD4K16O9KVwPPuxROD4K16M9KVwPPilcDz4K16O9KVwPPuxROD4K16M9AAAAAM3MzD7NzEw/AAAAAAAAAAAAAAAAAAAAAM3MzD0AAAAAAAAAAAAAAAAAAAAAPQrXvqRwPT8pXA8+PQrXvlK4Hj8pXA++PQrXvqRwPT8pXA8+PQrXPqRwPT8pXA++PQrXPlK4Hj8pXA8+PQrXPqRwPT8pXA++KVwPvq5HYT4pXA++KVwPvgrXoz0pXA8+KVwPvq5HYT4pXA++KVwPPq5HYT4pXA8+KVwPPgrXoz0pXA++KVwPPq5HYT4pXA8+AAAAAJqZmT6amRk/AAAAAAAAAAAAAAAAAAAAAI/CdT6PwnU9AAAAAArXIz2PwvU9PQrXvuxROD8K16M8PQrXvoXrUT8K16M9PQrXvhSuRz8K1yM9PQrXPuxROD8K16O8PQrXPoXrUT8K16O9PQrXPhSuRz8K1yO9AAAAADMzsz4zMzM/AAAAAArXoz2PwvU9AAAAAI/Cdb0K16M8AAAAAI/C9b0K16O9PQrXvlyPQj8K1yM9PQrXvjMzMz8K16M8PQrXvsP1KD8AAAAAPQrXPlyPQj8K1yO9PQrXPjMzMz8K16O8PQrXPsP1KD8AAAAAAAAAAAAAgD4AAAA/"
+    }
+  ],
+  "bufferViews": [
+    { "buffer": 0, "byteOffset": 0, "byteLength": 96 },
+    { "buffer": 0, "byteOffset": 96, "byteLength": 72 },
+    { "buffer": 0, "byteOffset": 168, "byteLength": 36 },
+    { "buffer": 0, "byteOffset": 204, "byteLength": 36 },
+    { "buffer": 0, "byteOffset": 240, "byteLength": 12 },
+    { "buffer": 0, "byteOffset": 252, "byteLength": 36 },
+    { "buffer": 0, "byteOffset": 288, "byteLength": 36 },
+    { "buffer": 0, "byteOffset": 324, "byteLength": 36 },
+    { "buffer": 0, "byteOffset": 360, "byteLength": 36 },
+    { "buffer": 0, "byteOffset": 396, "byteLength": 36 },
+    { "buffer": 0, "byteOffset": 432, "byteLength": 12 },
+    { "buffer": 0, "byteOffset": 444, "byteLength": 36 },
+    { "buffer": 0, "byteOffset": 480, "byteLength": 36 },
+    { "buffer": 0, "byteOffset": 516, "byteLength": 36 },
+    { "buffer": 0, "byteOffset": 552, "byteLength": 36 },
+    { "buffer": 0, "byteOffset": 588, "byteLength": 36 },
+    { "buffer": 0, "byteOffset": 624, "byteLength": 12 },
+    { "buffer": 0, "byteOffset": 636, "byteLength": 36 },
+    { "buffer": 0, "byteOffset": 672, "byteLength": 36 },
+    { "buffer": 0, "byteOffset": 708, "byteLength": 36 },
+    { "buffer": 0, "byteOffset": 744, "byteLength": 12 },
+    { "buffer": 0, "byteOffset": 756, "byteLength": 36 },
+    { "buffer": 0, "byteOffset": 792, "byteLength": 36 },
+    { "buffer": 0, "byteOffset": 828, "byteLength": 36 },
+    { "buffer": 0, "byteOffset": 864, "byteLength": 12 }
+  ],
+  "accessors": [
+    { "bufferView": 0, "byteOffset": 0, "componentType": 5126, "count": 8, "type": "VEC3" },
+    { "bufferView": 1, "byteOffset": 0, "componentType": 5123, "count": 36, "type": "SCALAR" },
+    { "bufferView": 2, "byteOffset": 0, "componentType": 5126, "count": 3, "type": "VEC3" },
+    { "bufferView": 3, "byteOffset": 0, "componentType": 5126, "count": 3, "type": "VEC3" },
+    { "bufferView": 4, "byteOffset": 0, "componentType": 5126, "count": 3, "type": "SCALAR" },
+    { "bufferView": 5, "byteOffset": 0, "componentType": 5126, "count": 3, "type": "VEC3" },
+    { "bufferView": 6, "byteOffset": 0, "componentType": 5126, "count": 3, "type": "VEC3" },
+    { "bufferView": 7, "byteOffset": 0, "componentType": 5126, "count": 3, "type": "VEC3" },
+    { "bufferView": 8, "byteOffset": 0, "componentType": 5126, "count": 3, "type": "VEC3" },
+    { "bufferView": 9, "byteOffset": 0, "componentType": 5126, "count": 3, "type": "VEC3" },
+    { "bufferView": 10, "byteOffset": 0, "componentType": 5126, "count": 3, "type": "SCALAR" },
+    { "bufferView": 11, "byteOffset": 0, "componentType": 5126, "count": 3, "type": "VEC3" },
+    { "bufferView": 12, "byteOffset": 0, "componentType": 5126, "count": 3, "type": "VEC3" },
+    { "bufferView": 13, "byteOffset": 0, "componentType": 5126, "count": 3, "type": "VEC3" },
+    { "bufferView": 14, "byteOffset": 0, "componentType": 5126, "count": 3, "type": "VEC3" },
+    { "bufferView": 15, "byteOffset": 0, "componentType": 5126, "count": 3, "type": "VEC3" },
+    { "bufferView": 16, "byteOffset": 0, "componentType": 5126, "count": 3, "type": "SCALAR" },
+    { "bufferView": 17, "byteOffset": 0, "componentType": 5126, "count": 3, "type": "VEC3" },
+    { "bufferView": 18, "byteOffset": 0, "componentType": 5126, "count": 3, "type": "VEC3" },
+    { "bufferView": 19, "byteOffset": 0, "componentType": 5126, "count": 3, "type": "VEC3" },
+    { "bufferView": 20, "byteOffset": 0, "componentType": 5126, "count": 3, "type": "SCALAR" },
+    { "bufferView": 21, "byteOffset": 0, "componentType": 5126, "count": 3, "type": "VEC3" },
+    { "bufferView": 22, "byteOffset": 0, "componentType": 5126, "count": 3, "type": "VEC3" },
+    { "bufferView": 23, "byteOffset": 0, "componentType": 5126, "count": 3, "type": "VEC3" },
+    { "bufferView": 24, "byteOffset": 0, "componentType": 5126, "count": 3, "type": "SCALAR" }
+  ],
+  "materials": [
+    {
+      "name": "Body",
+      "pbrMetallicRoughness": {
+        "baseColorFactor": [0.86, 0.63, 0.4, 1],
+        "metallicFactor": 0.04,
+        "roughnessFactor": 0.88
+      }
+    },
+    {
+      "name": "Accent",
+      "pbrMetallicRoughness": {
+        "baseColorFactor": [0.15, 0.68, 0.88, 1],
+        "metallicFactor": 0.08,
+        "roughnessFactor": 0.62
+      }
+    }
+  ],
+  "meshes": [
+    {
+      "name": "BodyCube",
+      "primitives": [
+        { "attributes": { "POSITION": 0 }, "indices": 1, "material": 0 }
+      ]
+    },
+    {
+      "name": "AccentCube",
+      "primitives": [
+        { "attributes": { "POSITION": 0 }, "indices": 1, "material": 1 }
+      ]
+    }
+  ],
+  "nodes": [
+    { "name": "Root", "children": [1] },
+    { "name": "AvatarRig", "children": [2, 3, 4, 5, 6, 7] },
+    { "name": "Torso", "mesh": 0, "translation": [0, 0.65, 0], "scale": [0.38, 0.6, 0.22] },
+    { "name": "Head", "mesh": 1, "translation": [0, 1.35, 0], "scale": [0.28, 0.28, 0.28] },
+    { "name": "ArmL", "mesh": 1, "translation": [-0.42, 0.72, 0], "scale": [0.12, 0.46, 0.12] },
+    { "name": "ArmR", "mesh": 1, "translation": [0.42, 0.72, 0], "scale": [0.12, 0.46, 0.12] },
+    { "name": "LegL", "mesh": 0, "translation": [-0.14, 0.18, 0], "scale": [0.14, 0.36, 0.14] },
+    { "name": "LegR", "mesh": 0, "translation": [0.14, 0.18, 0], "scale": [0.14, 0.36, 0.14] }
+  ],
+  "scenes": [
+    { "nodes": [0] }
+  ],
+  "scene": 0,
+  "animations": [
+    {
+      "name": "Idle",
+      "channels": [
+        { "sampler": 0, "target": { "node": 1, "path": "translation" } },
+        { "sampler": 1, "target": { "node": 3, "path": "translation" } }
+      ],
+      "samplers": [
+        { "input": 4, "output": 2, "interpolation": "LINEAR" },
+        { "input": 4, "output": 3, "interpolation": "LINEAR" }
+      ]
+    },
+    {
+      "name": "Walk",
+      "channels": [
+        { "sampler": 0, "target": { "node": 1, "path": "translation" } },
+        { "sampler": 1, "target": { "node": 4, "path": "translation" } },
+        { "sampler": 2, "target": { "node": 5, "path": "translation" } },
+        { "sampler": 3, "target": { "node": 6, "path": "translation" } },
+        { "sampler": 4, "target": { "node": 7, "path": "translation" } }
+      ],
+      "samplers": [
+        { "input": 10, "output": 5, "interpolation": "LINEAR" },
+        { "input": 10, "output": 6, "interpolation": "LINEAR" },
+        { "input": 10, "output": 7, "interpolation": "LINEAR" },
+        { "input": 10, "output": 8, "interpolation": "LINEAR" },
+        { "input": 10, "output": 9, "interpolation": "LINEAR" }
+      ]
+    },
+    {
+      "name": "Run",
+      "channels": [
+        { "sampler": 0, "target": { "node": 1, "path": "translation" } },
+        { "sampler": 1, "target": { "node": 4, "path": "translation" } },
+        { "sampler": 2, "target": { "node": 5, "path": "translation" } },
+        { "sampler": 3, "target": { "node": 6, "path": "translation" } },
+        { "sampler": 4, "target": { "node": 7, "path": "translation" } }
+      ],
+      "samplers": [
+        { "input": 16, "output": 11, "interpolation": "LINEAR" },
+        { "input": 16, "output": 12, "interpolation": "LINEAR" },
+        { "input": 16, "output": 13, "interpolation": "LINEAR" },
+        { "input": 16, "output": 14, "interpolation": "LINEAR" },
+        { "input": 16, "output": 15, "interpolation": "LINEAR" }
+      ]
+    },
+    {
+      "name": "Jump",
+      "channels": [
+        { "sampler": 0, "target": { "node": 1, "path": "translation" } },
+        { "sampler": 1, "target": { "node": 4, "path": "translation" } },
+        { "sampler": 2, "target": { "node": 5, "path": "translation" } }
+      ],
+      "samplers": [
+        { "input": 20, "output": 17, "interpolation": "LINEAR" },
+        { "input": 20, "output": 18, "interpolation": "LINEAR" },
+        { "input": 20, "output": 19, "interpolation": "LINEAR" }
+      ]
+    },
+    {
+      "name": "Fall",
+      "channels": [
+        { "sampler": 0, "target": { "node": 1, "path": "translation" } },
+        { "sampler": 1, "target": { "node": 4, "path": "translation" } },
+        { "sampler": 2, "target": { "node": 5, "path": "translation" } }
+      ],
+      "samplers": [
+        { "input": 24, "output": 21, "interpolation": "LINEAR" },
+        { "input": 24, "output": 22, "interpolation": "LINEAR" },
+        { "input": 24, "output": 23, "interpolation": "LINEAR" }
+      ]
+    }
+  ]
+}

package/templates/create/3d-collectathon/config/gameplay/.gitkeep

@@ -0,0 +1 @@
+

package/templates/create/3d-collectathon/content/gameplay/collectibles.json

@@ -0,0 +1,26 @@
+{
+  "schema": "aurajs.collectibles.v1",
+  "collectibles": [
+    {
+      "id": "orb-a",
+      "x": -2.8,
+      "y": 1.8,
+      "z": 2.2,
+      "value": 1
+    },
+    {
+      "id": "orb-b",
+      "x": 2.4,
+      "y": 2.4,
+      "z": 0.4,
+      "value": 1
+    },
+    {
+      "id": "orb-c",
+      "x": 4.6,
+      "y": 3.8,
+      "z": -2.8,
+      "value": 1
+    }
+  ]
+}

package/templates/create/3d-collectathon/content/gameplay/course.js

@@ -0,0 +1,46 @@
+export const PLAYER_HALF = { x: 0.45, y: 0.55, z: 0.45 };
+export const MOVE_SPEED = 5.6;
+export const JUMP_SPEED = 8.4;
+export const GRAVITY = 20.0;
+export const WORLD_LIMIT = 9.2;
+export const TARGET_COLLECTIBLES = 5;
+export const START_TIMER_SECONDS = 95;
+
+export const FLOOR_SCALE = { x: 26, y: 1, z: 26 };
+export const PLAYER_SPAWN = { x: 0, y: 1.1, z: 5.8 };
+export const CAMERA_OFFSET = { x: 7.8, y: 6.2, z: 8.5 };
+export const CAMERA_LOOK_OFFSET = { x: 0, y: 0.2, z: 0 };
+
+export const WORLD_PLATFORMS = [
+  { x: -3.2, y: 1.2, z: 2.6, sx: 3.0, sy: 0.5, sz: 2.3 },
+  { x: 2.5, y: 2.2, z: 1.2, sx: 2.8, sy: 0.5, sz: 2.1 },
+  { x: 4.9, y: 3.3, z: -1.8, sx: 2.8, sy: 0.5, sz: 2.0 },
+  { x: -1.0, y: 3.7, z: -3.3, sx: 3.0, sy: 0.5, sz: 2.2 },
+  { x: 3.8, y: 4.8, z: -5.1, sx: 2.8, sy: 0.5, sz: 2.0 },
+];
+
+export const CHECKPOINTS = [
+  { x: 0.0, y: 1.1, z: 5.8, radius: 1.4 },
+  { x: -3.2, y: 2.0, z: 2.6, radius: 1.2 },
+  { x: 2.5, y: 3.0, z: 1.2, radius: 1.2 },
+  { x: -1.0, y: 4.5, z: -3.3, radius: 1.25 },
+  { x: 3.8, y: 5.7, z: -5.1, radius: 1.3 },
+];
+
+export const COLLECTIBLE_SPAWNS = [
+  { x: -3.2, y: 2.0, z: 2.6 },
+  { x: 2.5, y: 3.0, z: 1.2 },
+  { x: 4.9, y: 4.1, z: -1.8 },
+  { x: -1.0, y: 4.5, z: -3.3 },
+  { x: 3.8, y: 5.7, z: -5.1 },
+  { x: 0.2, y: 2.8, z: -0.8 },
+];
+
+export const MOVING_PLATFORM = {
+  from: { x: 0.7, y: 2.1, z: -0.5 },
+  to: { x: 3.2, y: 3.1, z: -2.1 },
+  size: { x: 2.2, y: 0.4, z: 1.8 },
+  periodSeconds: 3.0,
+};
+
+export const GOAL_ZONE = { x: 3.8, y: 5.9, z: -5.1, radius: 1.15 };

package/templates/create/3d-collectathon/content/registries/.gitkeep

@@ -0,0 +1 @@
+

package/templates/create/3d-collectathon/docs/design/.gitkeep

@@ -0,0 +1 @@
+

package/templates/create/3d-collectathon/docs/design/loop.md

@@ -0,0 +1,5 @@
+# 3D Collectathon Loop
+
+1. Traverse the route, gather the collectible set, and clear the course.
+1. Keep authored route nouns in `content/gameplay/course.js`, collectible placement in `content/gameplay/collectibles.json`, and reusable presentation pieces in `prefabs/`.
+1. If you add template-specific tuning beyond `game.config.json`, keep it in `config/gameplay/` instead of burying it in scene constants.

package/templates/create/3d-collectathon/prefabs/collectible.prefab.js

@@ -0,0 +1,15 @@
+const collectiblePrefab = {
+  id: 'collectible',
+  kind: 'prefab',
+  role: 'pickup',
+  view: { kind: 'pickup3d' },
+  components: {},
+  hooks: {},
+  notes: ['Keep collection VFX and reward payload shape here.'],
+};
+
+export function createCollectiblePrefab() {
+  return collectiblePrefab;
+}
+
+export default collectiblePrefab;

package/templates/create/3d-collectathon/prefabs/player.prefab.js

@@ -0,0 +1,207 @@
+import {
+  activeCheckpoint,
+  createCharacterAvatar3D,
+  setAvatarVisual3D,
+} from '../src/starter-utils/index.js';
+import {
+  CAMERA_LOOK_OFFSET,
+  CAMERA_OFFSET,
+  JUMP_SPEED,
+  MOVE_SPEED,
+  PLAYER_HALF,
+} from '../content/gameplay/course.js';
+
+export const PLAYER_AVATAR_MODEL_PATH = 'assets/models/starter-avatar.gltf';
+
+const PLAYER_BODY_HEIGHT = PLAYER_HALF.y * 2;
+const PLAYER_RUN_SPEED = MOVE_SPEED * 1.35;
+const PLAYER_VISUAL_OFFSET = { x: 0, y: -PLAYER_HALF.y, z: 0 };
+const PLAYER_VISUAL_SCALE = { x: 1, y: 1, z: 1 };
+
+const playerPrefab = {
+  id: 'player',
+  kind: 'prefab',
+  role: 'player',
+  view: {
+    kind: 'avatar3d',
+    collider: { shape: 'capsule', size: { x: PLAYER_HALF.x * 2, y: PLAYER_BODY_HEIGHT, z: PLAYER_HALF.z * 2 } },
+    asset: { path: PLAYER_AVATAR_MODEL_PATH, clips: ['Idle', 'Walk', 'Run', 'Jump', 'Fall'] },
+  },
+  components: {
+    avatar: {
+      model: PLAYER_AVATAR_MODEL_PATH,
+      clips: ['Idle', 'Walk', 'Run', 'Jump', 'Fall'],
+    },
+  },
+  hooks: {
+    bindVisual: 'bindPlayerAvatarVisual',
+  },
+  notes: ['This starter keeps the player prefab avatar-first so the collectathon loop starts from an imported character.'],
+};
+
+function normalizeImportedSceneRecord(entry) {
+  if (entry && entry.ok === true && Number.isInteger(entry.importId) && entry.importId > 0) {
+    return entry;
+  }
+  if (entry && Number.isInteger(entry.importId) && entry.importId > 0) {
+    return { ok: true, ...entry };
+  }
+  return null;
+}
+
+function resolveImportId(entry) {
+  if (Number.isInteger(entry) && entry > 0) return entry;
+  if (Number.isInteger(entry?.importId) && entry.importId > 0) return entry.importId;
+  return null;
+}
+
+function resolveRootSceneNodeId(record) {
+  if (!record || !Array.isArray(record.nodeHandles) || record.nodeHandles.length === 0) {
+    return null;
+  }
+
+  const rootSourceIndex = Array.isArray(record.rootSourceNodeIndices) && record.rootSourceNodeIndices.length > 0
+    ? Number(record.rootSourceNodeIndices[0])
+    : null;
+  if (Number.isInteger(rootSourceIndex) && rootSourceIndex >= 0) {
+    const match = record.nodeHandles.find((entry) => Number(entry?.sourceNodeIndex) === rootSourceIndex);
+    if (Number.isInteger(match?.nodeId) && match.nodeId > 0) {
+      return match.nodeId;
+    }
+  }
+
+  const first = record.nodeHandles.find((entry) => Number.isInteger(entry?.nodeId) && entry.nodeId > 0);
+  return Number.isInteger(first?.nodeId) ? first.nodeId : null;
+}
+
+function createPlayerClipMap(importId) {
+  return {
+    idle: { importId, animation: 'Idle', loop: true, transitionSeconds: 0.18 },
+    walk: { importId, animation: 'Walk', loop: true, transitionSeconds: 0.14 },
+    run: { importId, animation: 'Run', loop: true, transitionSeconds: 0.1 },
+    jump: { importId, animation: 'Jump', loop: false, transitionSeconds: 0.08 },
+    fall: { importId, animation: 'Fall', loop: true, transitionSeconds: 0.08 },
+  };
+}
+
+export function createPlayerAvatar(spawn) {
+  return createCharacterAvatar3D({
+    position: spawn,
+    radius: PLAYER_HALF.x,
+    height: PLAYER_BODY_HEIGHT,
+    moveSpeed: MOVE_SPEED,
+    runSpeed: PLAYER_RUN_SPEED,
+    jumpSpeed: JUMP_SPEED,
+    visual: {
+      offset: PLAYER_VISUAL_OFFSET,
+      scale: PLAYER_VISUAL_SCALE,
+    },
+    camera: {
+      offset: CAMERA_OFFSET,
+      lookOffset: CAMERA_LOOK_OFFSET,
+      rotateWithFacing: false,
+    },
+  });
+}
+
+export function resetPlayerAvatar(avatar, spawn) {
+  avatar.position = { x: spawn.x, y: spawn.y, z: spawn.z };
+  avatar.grounded = false;
+  avatar.onSlope = false;
+  avatar.velocityY = 0;
+  avatar.facingYaw = 0;
+  avatar.locomotion = 'idle';
+  avatar.motion = {
+    moveX: 0,
+    moveZ: 0,
+    magnitude: 0,
+    speed: 0,
+  };
+  avatar.input = {
+    moveX: 0,
+    moveZ: 0,
+    jump: false,
+    run: false,
+  };
+  avatar.visual.activeClipKey = null;
+  avatar.visual.activeClipId = null;
+  return avatar;
+}
+
+export function loadPlayerAvatarVisual() {
+  const loaded = aura.scene3d.loadGltfScene(PLAYER_AVATAR_MODEL_PATH, {
+    bindRenderNodes: true,
+    visible: true,
+    cull: false,
+  });
+  const importId = resolveImportId(loaded);
+  if (!importId) {
+    throw new Error(`[3d-collectathon-template] failed to load starter avatar model: ${PLAYER_AVATAR_MODEL_PATH}`);
+  }
+
+  const record = normalizeImportedSceneRecord(loaded)
+    || normalizeImportedSceneRecord(aura.scene3d.getImportedScene(importId));
+  const sceneNodeId = resolveRootSceneNodeId(record);
+  if (!sceneNodeId) {
+    throw new Error('[3d-collectathon-template] starter avatar model missing a bindable root scene node');
+  }
+
+  return {
+    importId,
+    path: PLAYER_AVATAR_MODEL_PATH,
+    sceneNodeId,
+  };
+}
+
+export function bindPlayerAvatarVisual(avatar, visual) {
+  return setAvatarVisual3D(avatar, {
+    sceneNodeId: visual.sceneNodeId,
+    offset: PLAYER_VISUAL_OFFSET,
+    scale: PLAYER_VISUAL_SCALE,
+    clipMap: createPlayerClipMap(visual.importId),
+  });
+}
+
+export function createPlayerPrefab() {
+  return playerPrefab;
+}
+
+export function drawCollectathonActors({ mesh, materials, state, goalZone }) {
+  for (const collectible of state.collectibles) {
+    if (collectible.collected) continue;
+    aura.draw3d.drawMesh(mesh, materials.collectible, {
+      position: {
+        x: collectible.x,
+        y: collectible.y + (Math.sin((state.elapsed * 2.2) + collectible.x) * 0.16),
+        z: collectible.z,
+      },
+      rotation: {
+        x: state.elapsed * 0.5,
+        y: state.elapsed * 1.7,
+        z: state.elapsed * 0.3,
+      },
+      scale: { x: 0.45, y: 0.45, z: 0.45 },
+    });
+  }
+
+  const checkpoint = activeCheckpoint(state.checkpointSystem);
+  if (checkpoint) {
+    aura.draw3d.drawMesh(mesh, materials.checkpoint, {
+      position: { x: checkpoint.x, y: checkpoint.y - 0.35, z: checkpoint.z },
+      rotation: { x: 0, y: state.elapsed, z: 0 },
+      scale: { x: 0.4, y: 0.4, z: 0.4 },
+    });
+  }
+
+  aura.draw3d.drawMesh(mesh, materials.goal, {
+    position: { x: goalZone.x, y: goalZone.y, z: goalZone.z },
+    rotation: { x: 0, y: state.elapsed * 0.9, z: 0 },
+    scale: {
+      x: goalZone.radius * 1.25,
+      y: goalZone.radius * 1.25,
+      z: goalZone.radius * 1.25,
+    },
+  });
+}
+
+export default playerPrefab;

package/templates/create/3d-collectathon/prefabs/world.prefab.js

@@ -0,0 +1,112 @@
+import { FLOOR_SCALE, WORLD_PLATFORMS } from '../content/gameplay/course.js';
+
+const worldPrefab = {
+  id: 'world',
+  kind: 'prefab',
+  role: 'world',
+  view: {
+    kind: 'environment3d',
+  },
+  hooks: {},
+  notes: ['Treat this as the authored world descriptor before you move to richer scene data.'],
+};
+
+export function createWorldPrefab() {
+  return {
+    ...worldPrefab,
+    platformCount: WORLD_PLATFORMS.length,
+  };
+}
+
+function addObstacleBox(platform) {
+  const halfX = platform.sx * 0.5;
+  const halfY = platform.sy * 0.5;
+  const halfZ = platform.sz * 0.5;
+  aura.character3d.addObstacle(
+    { x: platform.x - halfX, y: platform.y - halfY, z: platform.z - halfZ },
+    { x: platform.x + halfX, y: platform.y + halfY, z: platform.z + halfZ },
+  );
+}
+
+export function findSupportTop(x, z, movingPlatform) {
+  let top = 0;
+
+  const includePlatform = (platform) => {
+    const halfX = platform.sx * 0.5;
+    const halfZ = platform.sz * 0.5;
+    if (Math.abs(x - platform.x) > halfX || Math.abs(z - platform.z) > halfZ) return;
+    top = Math.max(top, platform.y + (platform.sy * 0.5));
+  };
+
+  for (const platform of WORLD_PLATFORMS) {
+    includePlatform(platform);
+  }
+
+  includePlatform({
+    x: movingPlatform.position.x,
+    y: movingPlatform.position.y,
+    z: movingPlatform.position.z,
+    sx: movingPlatform.size.x,
+    sy: movingPlatform.size.y,
+    sz: movingPlatform.size.z,
+  });
+
+  return top;
+}
+
+export function syncCollectathonCharacterObstacles(movingPlatform) {
+  if (typeof aura?.character3d?.clearObstacles !== 'function' || typeof aura?.character3d?.addObstacle !== 'function') {
+    return;
+  }
+
+  aura.character3d.clearObstacles();
+  aura.character3d.addObstacle(
+    { x: -FLOOR_SCALE.x * 0.5, y: -1.0, z: -FLOOR_SCALE.z * 0.5 },
+    { x: FLOOR_SCALE.x * 0.5, y: 0.0, z: FLOOR_SCALE.z * 0.5 },
+  );
+
+  for (const platform of WORLD_PLATFORMS) {
+    addObstacleBox(platform);
+  }
+
+  addObstacleBox({
+    x: movingPlatform.position.x,
+    y: movingPlatform.position.y,
+    z: movingPlatform.position.z,
+    sx: movingPlatform.size.x,
+    sy: movingPlatform.size.y,
+    sz: movingPlatform.size.z,
+  });
+}
+
+export function drawCollectathonCourse({ mesh, floorMaterial, platformMaterial, movingPlatform }) {
+  aura.draw3d.drawMesh(mesh, floorMaterial, {
+    position: { x: 0, y: -0.5, z: 0 },
+    rotation: { x: 0, y: 0, z: 0 },
+    scale: FLOOR_SCALE,
+  });
+
+  for (const platform of WORLD_PLATFORMS) {
+    aura.draw3d.drawMesh(mesh, platformMaterial, {
+      position: { x: platform.x, y: platform.y, z: platform.z },
+      rotation: { x: 0, y: 0, z: 0 },
+      scale: { x: platform.sx, y: platform.sy, z: platform.sz },
+    });
+  }
+
+  aura.draw3d.drawMesh(mesh, platformMaterial, {
+    position: {
+      x: movingPlatform.position.x,
+      y: movingPlatform.position.y,
+      z: movingPlatform.position.z,
+    },
+    rotation: { x: 0, y: movingPlatform.t * 0.5, z: 0 },
+    scale: {
+      x: movingPlatform.size.x,
+      y: movingPlatform.size.y,
+      z: movingPlatform.size.z,
+    },
+  });
+}
+
+export default worldPrefab;

package/templates/create/3d-collectathon/scenes/boot.scene.js

@@ -0,0 +1,12 @@
+export function createBootScene() {
+  return {
+    id: 'boot',
+    template: '3d-collectathon',
+    nextSceneId: 'gameplay',
+    notes: [
+      'Use this scene for splash, loading, title flow, and session handoff.',
+      'Keep long-lived boot orchestration here instead of bloating src/main.js.',
+      'Keep checkpoint resume and route handoff in appState or scene data instead of ad hoc globals.',
+    ],
+  };
+}

package/templates/create/3d-collectathon/scenes/checkpoint.scene.js

@@ -0,0 +1,9 @@
+export function createCheckpointScene() {
+  return {
+    id: "checkpoint",
+    nextSceneId: "gameplay",
+    notes: [
+  "Use this for checkpoint route previews, timers, or recovery beats."
+],
+  };
+}