@auraindustry/aurajs 0.0.7 → 0.1.1

package/templates/create/3d/ui/settings.screen.js

@@ -0,0 +1,387 @@
+import {
+  ensureUiPreferences,
+  inspectUiTheme,
+  resetUiPreferences,
+  updateUiPreferences,
+} from '../src/runtime/ui-theme.js';
+import {
+  formatPercentFromTenth,
+  listContrastSegmentOptions,
+  listDensitySegmentOptions,
+  listThemeSegmentOptions,
+  readBooleanViewValue,
+  readNumberViewValue,
+  renderActionStrip,
+  renderSegmentedControl,
+} from '../src/runtime/ui-settings.js';
+
+const settingsScreen = {
+  id: 'settings',
+  kind: 'ui-screen',
+  role: 'modal',
+  draw: drawSettingsScreen,
+  notes: [
+    'Stage 154 productizes the retained settings flow as a screenShell modal.',
+    'Canonical preferences live in appState.ui.preferences while this screen only renders and edits them.',
+  ],
+};
+
+function sizeOfWindow() {
+  return aura.window?.getSize?.() || { width: 1360, height: 820 };
+}
+
+function ensureSettingsView(context, appState) {
+  if (typeof context.ensureUiState === 'function') {
+    return context.ensureUiState('settingsView', {
+      activeSection: 'audio',
+    });
+  }
+  if (!appState.ui || typeof appState.ui !== 'object' || Array.isArray(appState.ui)) {
+    appState.ui = {};
+  }
+  if (!appState.ui.settingsView || typeof appState.ui.settingsView !== 'object' || Array.isArray(appState.ui.settingsView)) {
+    appState.ui.settingsView = {
+      activeSection: 'audio',
+    };
+  }
+  return appState.ui.settingsView;
+}
+
+function ensurePlatformerUiState(context, appState) {
+  if (typeof context.ensureUiState === 'function') {
+    return context.ensureUiState('platformerHud', {
+      showControlsHint: true,
+    });
+  }
+  if (!appState.ui || typeof appState.ui !== 'object' || Array.isArray(appState.ui)) {
+    appState.ui = {};
+  }
+  if (!appState.ui.platformerHud || typeof appState.ui.platformerHud !== 'object' || Array.isArray(appState.ui.platformerHud)) {
+    appState.ui.platformerHud = {
+      showControlsHint: true,
+    };
+  }
+  return appState.ui.platformerHud;
+}
+
+function currentPreferences(context, appState) {
+  if (typeof context.getUiPreferences === 'function') {
+    return context.getUiPreferences();
+  }
+  return ensureUiPreferences(appState);
+}
+
+function currentThemeState(context, appState) {
+  if (typeof context.getUiThemeState === 'function') {
+    return context.getUiThemeState();
+  }
+  return inspectUiTheme(appState);
+}
+
+function updatePreferences(context, appState, patch) {
+  if (typeof context.updateUiPreferences === 'function') {
+    return context.updateUiPreferences(patch);
+  }
+  return updateUiPreferences(appState, patch);
+}
+
+function resetPreferences(context, appState) {
+  if (typeof context.resetUiPreferences === 'function') {
+    return context.resetUiPreferences();
+  }
+  return resetUiPreferences(appState);
+}
+
+function themeSummaryLines(themeState) {
+  return [
+    `Preset ${themeState?.presetLabel || 'Signal Dawn'}`,
+    `Density ${themeState?.density === 'compact' ? 'Compact' : 'Cozy'}`,
+    `Contrast ${themeState?.contrast === 'high' ? 'High' : 'Standard'}`,
+  ];
+}
+
+function clickedSegmentOption(controlId, optionId) {
+  const state = aura.ui.getViewState(`${controlId}-${optionId}`);
+  return state?.clicked === true || state?.activated === true;
+}
+
+function renderAudioSection(preferences) {
+  aura.ui.beginColumn({
+    id: 'platformer-settings-audio',
+    gap: 12,
+    width: 'fill',
+    padding: 14,
+    background: '#0d1826',
+    borderColor: '#21384d',
+  });
+  aura.ui.text('platformer-settings-audio-label', {
+    text: 'AUDIO',
+    size: 11,
+    color: '#7fb7ea',
+  });
+  aura.ui.toggle('platformer-settings-music', {
+    label: 'Music playback',
+    value: preferences.musicEnabled === true,
+    width: 'fill',
+  });
+  aura.ui.slider('platformer-settings-volume', {
+    label: `Master volume ${formatPercentFromTenth(preferences.masterVolume)}`,
+    min: 0,
+    max: 10,
+    step: 1,
+    value: preferences.masterVolume,
+    width: 'fill',
+  });
+  aura.ui.text('platformer-settings-audio-note', {
+    text: 'The starter treats these values as the canonical shared pause/settings audio seam.',
+    size: 12,
+    color: '#9db2cb',
+  });
+  aura.ui.endColumn();
+}
+
+function renderDisplaySection(preferences) {
+  aura.ui.beginColumn({
+    id: 'platformer-settings-display',
+    gap: 12,
+    width: 'fill',
+    padding: 14,
+    background: '#0d1826',
+    borderColor: '#21384d',
+  });
+  aura.ui.text('platformer-settings-display-label', {
+    text: 'DISPLAY',
+    size: 11,
+    color: '#7fb7ea',
+  });
+  renderSegmentedControl({
+    id: 'platformer-settings-theme',
+    label: 'Theme preset',
+    description: 'Starter-owned semantic presets from src/runtime/ui-theme.js.',
+    value: preferences.themeId,
+    options: listThemeSegmentOptions(),
+  });
+  renderSegmentedControl({
+    id: 'platformer-settings-density',
+    label: 'Density',
+    value: preferences.density,
+    options: listDensitySegmentOptions(),
+  });
+  renderSegmentedControl({
+    id: 'platformer-settings-contrast',
+    label: 'Contrast',
+    value: preferences.contrast,
+    options: listContrastSegmentOptions(),
+  });
+  aura.ui.endColumn();
+}
+
+function renderInterfaceSection(preferences, platformerUiState) {
+  aura.ui.beginColumn({
+    id: 'platformer-settings-interface',
+    gap: 12,
+    width: 'fill',
+    padding: 14,
+    background: '#0d1826',
+    borderColor: '#21384d',
+  });
+  aura.ui.text('platformer-settings-interface-label', {
+    text: 'INTERFACE',
+    size: 11,
+    color: '#7fb7ea',
+  });
+  aura.ui.toggle('platformer-settings-subtitles', {
+    label: 'Subtitles',
+    value: preferences.subtitlesEnabled === true,
+    width: 'fill',
+  });
+  aura.ui.toggle('platformer-settings-reduce-motion', {
+    label: 'Reduce motion',
+    value: preferences.reduceMotion === true,
+    width: 'fill',
+  });
+  aura.ui.toggle('platformer-settings-controls-hint', {
+    label: 'Show controls hint on restart',
+    value: platformerUiState.showControlsHint !== false,
+    width: 'fill',
+  });
+  aura.ui.endColumn();
+}
+
+export function createSettingsScreen() {
+  return settingsScreen;
+}
+
+export function drawSettingsScreen(_data = {}, context = {}) {
+  const appState = context.appState || {};
+  const settingsView = ensureSettingsView(context, appState);
+  const platformerUiState = ensurePlatformerUiState(context, appState);
+  const preferences = currentPreferences(context, appState);
+  const themeState = currentThemeState(context, appState);
+  const size = sizeOfWindow();
+  const panelWidth = Math.min(980, size.width - 72);
+  const panelHeight = Math.min(640, size.height - 88);
+  const panelX = Math.floor((size.width - panelWidth) * 0.5);
+  const panelY = Math.floor((size.height - panelHeight) * 0.5);
+  const themeLines = themeSummaryLines(themeState);
+
+  aura.draw2d.rect(0, 0, size.width, size.height, aura.rgba(0.02, 0.03, 0.06, 0.82));
+
+  aura.ui.beginView({
+    id: 'platformer-settings-root',
+    x: panelX,
+    y: panelY,
+    width: panelWidth,
+    height: panelHeight,
+    gap: 14,
+    padding: 18,
+    clip: true,
+    background: '#08111b',
+    borderColor: '#32506c',
+  });
+
+  aura.ui.text('platformer-settings-eyebrow', {
+    text: 'SETTINGS',
+    size: 12,
+    color: '#86c1f5',
+  });
+  aura.ui.text('platformer-settings-title', {
+    text: 'Retained UI preferences',
+    size: 28,
+    color: '#f4f8ff',
+  });
+  aura.ui.text('platformer-settings-copy', {
+    text: 'These controls write into appState.ui.preferences and the active theme is applied through src/runtime/ui-theme.js.',
+    size: 14,
+    color: '#c9d9ea',
+  });
+
+  aura.ui.beginRow({
+    id: 'platformer-settings-shell',
+    gap: 16,
+    width: 'fill',
+    height: 'fill',
+  });
+
+  aura.ui.beginColumn({
+    id: 'platformer-settings-summary',
+    width: 250,
+    gap: 10,
+    padding: 14,
+    background: '#0d1826',
+    borderColor: '#21384d',
+  });
+  aura.ui.text('platformer-settings-summary-label', {
+    text: 'LIVE SNAPSHOT',
+    size: 11,
+    color: '#7fb7ea',
+  });
+  for (let index = 0; index < themeLines.length; index += 1) {
+    aura.ui.text(`platformer-settings-summary-${index}`, {
+      text: themeLines[index],
+      size: 15,
+      color: '#eef5ff',
+    });
+  }
+  aura.ui.text('platformer-settings-summary-audio', {
+    text: `Music ${preferences.musicEnabled ? 'On' : 'Off'} · Volume ${formatPercentFromTenth(preferences.masterVolume)}`,
+    size: 14,
+    color: '#d1dfef',
+  });
+  aura.ui.text('platformer-settings-summary-interface', {
+    text: `Hints ${platformerUiState.showControlsHint !== false ? 'Shown' : 'Hidden'} · Subtitles ${preferences.subtitlesEnabled ? 'On' : 'Off'}`,
+    size: 14,
+    color: '#d1dfef',
+  });
+  aura.ui.text('platformer-settings-summary-note', {
+    text: 'The selected section state lives in appState.ui.settingsView while widget focus remains runtime-owned inside aura.ui.',
+    size: 12,
+    color: '#9db2cb',
+  });
+  aura.ui.endColumn();
+
+  aura.ui.beginColumn({
+    id: 'platformer-settings-main',
+    width: 'fill',
+    gap: 12,
+  });
+
+  const sectionTabs = renderSegmentedControl({
+    id: 'platformer-settings-sections',
+    label: 'Section',
+    value: settingsView.activeSection || 'audio',
+    options: [
+      { id: 'audio', label: 'Audio' },
+      { id: 'display', label: 'Display' },
+      { id: 'interface', label: 'Interface' },
+    ],
+  });
+  if (sectionTabs.changed) {
+    settingsView.activeSection = sectionTabs.value;
+  }
+
+  if ((settingsView.activeSection || 'audio') === 'audio') {
+    renderAudioSection(preferences);
+  } else if (settingsView.activeSection === 'display') {
+    renderDisplaySection(preferences);
+  } else {
+    renderInterfaceSection(preferences, platformerUiState);
+  }
+
+  const actions = renderActionStrip({
+    id: 'platformer-settings-actions',
+    actions: [
+      { id: 'restore', label: 'Restore Defaults' },
+      { id: 'back', label: 'Back' },
+    ],
+  });
+
+  aura.ui.endColumn();
+  aura.ui.endRow();
+  aura.ui.endView();
+
+  const patch = {};
+  const musicEnabled = readBooleanViewValue('platformer-settings-music', preferences.musicEnabled);
+  const masterVolume = readNumberViewValue('platformer-settings-volume', preferences.masterVolume);
+  const subtitlesEnabled = readBooleanViewValue('platformer-settings-subtitles', preferences.subtitlesEnabled);
+  const reduceMotion = readBooleanViewValue('platformer-settings-reduce-motion', preferences.reduceMotion);
+  const controlsHint = readBooleanViewValue('platformer-settings-controls-hint', platformerUiState.showControlsHint !== false);
+
+  if (musicEnabled !== preferences.musicEnabled) patch.musicEnabled = musicEnabled;
+  if (masterVolume !== preferences.masterVolume) patch.masterVolume = masterVolume;
+  if (subtitlesEnabled !== preferences.subtitlesEnabled) patch.subtitlesEnabled = subtitlesEnabled;
+  if (reduceMotion !== preferences.reduceMotion) patch.reduceMotion = reduceMotion;
+
+  const themeButtons = listThemeSegmentOptions();
+  for (const option of themeButtons) {
+    if (clickedSegmentOption('platformer-settings-theme', option.id)) {
+      patch.themeId = option.id;
+    }
+  }
+  for (const option of listDensitySegmentOptions()) {
+    if (clickedSegmentOption('platformer-settings-density', option.id)) {
+      patch.density = option.id;
+    }
+  }
+  for (const option of listContrastSegmentOptions()) {
+    if (clickedSegmentOption('platformer-settings-contrast', option.id)) {
+      patch.contrast = option.id;
+    }
+  }
+
+  if (controlsHint !== (platformerUiState.showControlsHint !== false)) {
+    platformerUiState.showControlsHint = controlsHint;
+  }
+  if (Object.keys(patch).length > 0) {
+    updatePreferences(context, appState, patch);
+  }
+  if (actions.actionId === 'restore') {
+    resetPreferences(context, appState);
+    platformerUiState.showControlsHint = true;
+    settingsView.activeSection = 'audio';
+  } else if (actions.actionId === 'back') {
+    context.popModalScreen?.({ action: 'back' });
+  }
+}
+
+export default settingsScreen;

package/templates/create/3d-adventure/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-adventure/aura.config.json

@@ -0,0 +1,28 @@
+{
+  "identity": {
+    "name": "{{PROJECT_TITLE}}",
+    "version": "{{PROJECT_VERSION}}",
+    "executable": "{{PROJECT_BIN_NAME}}",
+    "icon": null
+  },
+  "window": {
+    "title": "{{PROJECT_TITLE}}",
+    "width": 1280,
+    "height": 720,
+    "resizable": true,
+    "fullscreen": false,
+    "vsync": true,
+    "hidpi": true
+  },
+  "build": {
+    "entry": "src/main.js",
+    "outDir": "build",
+    "assetDir": "assets",
+    "assetMode": "embed"
+  },
+  "modules": {
+    "physics": false,
+    "network": true,
+    "steam": false
+  }
+}

package/templates/create/3d-adventure/config/gameplay/adventure.config.js

@@ -0,0 +1,9 @@
+export const ADVENTURE3D_CONFIG = {
+  relicRadius: 0.42,
+  beaconPromptRadius: 1.5,
+  goalPromptRadius: 1.4,
+};
+
+export const ADVENTURE3D_TEXT = {
+  started: '{{PROJECT_TITLE}} started (3D adventure template)',
+};

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

@@ -0,0 +1,62 @@
+export const PLAYER_HALF = { x: 0.45, y: 0.55, z: 0.45 };
+export const MOVE_SPEED = 5.7;
+export const JUMP_SPEED = 8.5;
+export const WORLD_LIMIT = 10.2;
+
+export const FLOOR_SCALE = { x: 28, y: 1, z: 28 };
+export const PLAYER_SPAWN = { x: 0, y: 1.1, z: 6.2 };
+export const CAMERA_OFFSET = { x: 7.8, y: 6.4, z: 8.8 };
+export const CAMERA_LOOK_OFFSET = { x: 0, y: 0.2, z: 0 };
+
+export const WORLD_PLATFORMS = [
+  { x: -3.8, y: 1.8, z: 3.0, sx: 3.6, sy: 0.5, sz: 2.6 },
+  { x: 1.1, y: 2.6, z: 1.0, sx: 2.8, sy: 0.5, sz: 2.2 },
+  { x: 4.8, y: 3.7, z: -1.8, sx: 3.0, sy: 0.5, sz: 2.0 },
+  { x: -1.2, y: 4.7, z: -3.6, sx: 3.2, sy: 0.5, sz: 2.3 },
+  { x: 4.9, y: 5.5, z: -5.6, sx: 2.8, sy: 0.5, sz: 1.9 },
+];
+
+export const CHECKPOINTS = [
+  { x: 0.0, y: 1.1, z: 6.2, radius: 1.4 },
+  { x: -3.8, y: 2.4, z: 3.0, radius: 1.2 },
+  { x: 1.1, y: 3.2, z: 1.0, radius: 1.2 },
+  { x: -1.2, y: 5.2, z: -3.6, radius: 1.25 },
+  { x: 4.9, y: 6.1, z: -5.6, radius: 1.25 },
+];
+
+export const RELIC_SPAWNS = [
+  { id: 'anchor-relay', label: 'Anchor Relay', x: -3.8, y: 2.5, z: 3.0, radius: 0.42 },
+  { id: 'glass-map', label: 'Glass Map', x: 1.1, y: 3.4, z: 1.0, radius: 0.42 },
+  { id: 'pulse-key', label: 'Pulse Key', x: 4.8, y: 4.3, z: -1.8, radius: 0.42 },
+  { id: 'sky-spindle', label: 'Sky Spindle', x: -1.2, y: 5.3, z: -3.6, radius: 0.42 },
+];
+
+export const BEACON_SITES = [
+  {
+    id: 'cliff-beacon',
+    label: 'Cliff Beacon',
+    x: -3.2,
+    y: 2.15,
+    z: 2.2,
+    radius: 0.72,
+    requiredRelics: 2,
+  },
+  {
+    id: 'summit-beacon',
+    label: 'Summit Beacon',
+    x: 4.9,
+    y: 5.95,
+    z: -5.0,
+    radius: 0.72,
+    requiredRelics: 4,
+  },
+];
+
+export const MOVING_PLATFORM = {
+  from: { x: 0.5, y: 3.0, z: -0.8 },
+  to: { x: 3.0, y: 4.2, z: -2.4 },
+  size: { x: 2.3, y: 0.4, z: 1.8 },
+  periodSeconds: 3.2,
+};
+
+export const GOAL_ZONE = { x: 5.4, y: 6.2, z: -5.9, radius: 1.0 };

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

@@ -0,0 +1 @@
+

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

@@ -0,0 +1,5 @@
+# 3D Adventure Loop
+
+1. Traverse the route, recover four relics, then light both beacons before leaving through the signal arch.
+1. Keep traversal and prompt tuning in `config/gameplay/adventure.config.js` and authored route nouns in `content/gameplay/course.js`.
+1. Extend from here with richer routes, glTF set dressing, and authored encounter beats instead of adding more ad hoc scene constants.