@auraindustry/aurajs 0.1.1 → 0.1.5

package/templates/create/2d-adventure/src/runtime/capabilities.js

@@ -9,12 +9,28 @@ function failWithReason(reasonCode, message) {
 export function assertRuntimeCapabilities() {
   const missing = [];
   if (!hasMethod(aura.window, 'getFPS')) missing.push('aura.window.getFPS');
+  if (!hasMethod(aura.window, 'getSize')) missing.push('aura.window.getSize');
   if (!hasMethod(aura.input, 'isKeyDown')) missing.push('aura.input.isKeyDown');
   if (!hasMethod(aura.input, 'isKeyPressed')) missing.push('aura.input.isKeyPressed');
   if (!hasMethod(aura.draw2d, 'clear')) missing.push('aura.draw2d.clear');
   if (!hasMethod(aura.draw2d, 'rect')) missing.push('aura.draw2d.rect');
   if (!hasMethod(aura.draw2d, 'text')) missing.push('aura.draw2d.text');
   if (!hasMethod(aura.draw2d, 'measureText')) missing.push('aura.draw2d.measureText');
+  if (!hasMethod(aura.tilemap, 'import')) missing.push('aura.tilemap.import');
+  if (!hasMethod(aura.tilemap, 'draw')) missing.push('aura.tilemap.draw');
+  if (!hasMethod(aura.tilemap, 'getInfo')) missing.push('aura.tilemap.getInfo');
+  if (!hasMethod(aura.tilemap, 'queryAABB')) missing.push('aura.tilemap.queryAABB');
+  if (!hasMethod(aura.tilemap, 'queryObjects')) missing.push('aura.tilemap.queryObjects');
+  if (!hasMethod(aura.tilemap, 'unload')) missing.push('aura.tilemap.unload');
+  if (!hasMethod(aura.ui, 'beginView')) missing.push('aura.ui.beginView');
+  if (!hasMethod(aura.ui, 'endView')) missing.push('aura.ui.endView');
+  if (!hasMethod(aura.ui, 'beginRow')) missing.push('aura.ui.beginRow');
+  if (!hasMethod(aura.ui, 'endRow')) missing.push('aura.ui.endRow');
+  if (!hasMethod(aura.ui, 'beginColumn')) missing.push('aura.ui.beginColumn');
+  if (!hasMethod(aura.ui, 'endColumn')) missing.push('aura.ui.endColumn');
+  if (!hasMethod(aura.ui, 'button')) missing.push('aura.ui.button');
+  if (!hasMethod(aura.ui, 'text')) missing.push('aura.ui.text');
+  if (!hasMethod(aura.ui, 'getViewState')) missing.push('aura.ui.getViewState');
   if (typeof aura.rgb !== 'function') missing.push('aura.rgb');
   if (typeof aura.rgba !== 'function') missing.push('aura.rgba');
   if (!aura.Color || !aura.Color.WHITE) missing.push('aura.Color.WHITE');

package/templates/create/2d-adventure/ui/hud.screen.js

@@ -1,3 +1,5 @@
+import { renderCollectionList, renderTabBar } from '../src/runtime/ui-forms.js';
+
 const hudScreen = {
   id: 'hud',
   kind: 'ui-screen',
@@ -10,10 +12,167 @@ export function createHudScreen() {
   return hudScreen;
 }
 
-export function drawAdventureHud(data = {}) {
+function createAdventureHudUiSeed() {
+  return {
+    showControlsHint: true,
+    showInventory: false,
+    showJournal: false,
+    inventorySelectedCategoryId: null,
+    inventorySelectedItemId: null,
+    journalSelectedCategoryId: null,
+    journalSelectedEntryId: null,
+    dialogueSelectedChoiceId: null,
+  };
+}
+
+function ensureAdventureHudUiState(context = {}) {
+  if (typeof context.ensureUiState === 'function') {
+    return context.ensureUiState('adventureHud', createAdventureHudUiSeed());
+  }
+  const appState = context.appState && typeof context.appState === 'object' ? context.appState : (context.appState = {});
+  if (!appState.ui || typeof appState.ui !== 'object' || Array.isArray(appState.ui)) {
+    appState.ui = {};
+  }
+  if (!appState.ui.adventureHud || typeof appState.ui.adventureHud !== 'object' || Array.isArray(appState.ui.adventureHud)) {
+    appState.ui.adventureHud = createAdventureHudUiSeed();
+  }
+  return appState.ui.adventureHud;
+}
+
+function drawInventoryPanel(data = {}, context = {}) {
+  if (data.showInventory !== true) return;
+  const hudUiState = ensureAdventureHudUiState(context);
+  const inventory = data.inventory || {};
+  const size = aura.window?.getSize?.() || { width: 1280, height: 720 };
+  const panelWidth = Math.min(420, size.width - 36);
+  const panelHeight = Math.min(430, size.height - 34);
+  const panelX = size.width - panelWidth - 18;
+  const panelY = 16;
+
+  if (!hudUiState.inventorySelectedCategoryId && inventory.selectedCategoryId) {
+    hudUiState.inventorySelectedCategoryId = inventory.selectedCategoryId;
+  }
+  if (!hudUiState.inventorySelectedItemId && inventory.selectedItemId) {
+    hudUiState.inventorySelectedItemId = inventory.selectedItemId;
+  }
+
+  aura.ui.beginView({
+    id: 'adventure-inventory-root',
+    x: panelX,
+    y: panelY,
+    width: panelWidth,
+    height: panelHeight,
+    gap: 12,
+    padding: 16,
+    clip: true,
+    background: '#091117',
+    borderColor: '#34506d',
+  });
+
+  aura.ui.text('adventure-inventory-eyebrow', {
+    text: 'FIELD KIT',
+    size: 12,
+    color: '#7ec8ff',
+  });
+  aura.ui.text('adventure-inventory-title', {
+    text: 'Recovered Inventory',
+    size: 26,
+    color: '#eef7ff',
+  });
+  aura.ui.text('adventure-inventory-copy', {
+    text: data.inventoryHint || 'Inventory state is shared with the route HUD.',
+    size: 13,
+    color: '#c8d8e7',
+  });
+
+  const tabs = renderTabBar({
+    id: 'adventure-inventory-tabs',
+    value: hudUiState.inventorySelectedCategoryId || inventory.selectedCategoryId,
+    tabs: Array.isArray(inventory.categories)
+      ? inventory.categories.map((entry) => ({
+        id: entry.id,
+        label: `${entry.label} ${entry.count}`,
+      }))
+      : [],
+  });
+  if (tabs.ok && tabs.value) {
+    hudUiState.inventorySelectedCategoryId = tabs.value;
+  }
+
+  aura.ui.beginRow({
+    id: 'adventure-inventory-layout',
+    gap: 12,
+    width: 'fill',
+  });
+
+  aura.ui.beginColumn({
+    id: 'adventure-inventory-list-col',
+    width: 220,
+    gap: 10,
+  });
+  const list = renderCollectionList({
+    id: 'adventure-inventory-list',
+    value: hudUiState.inventorySelectedItemId || inventory.selectedItemId,
+    items: Array.isArray(inventory.items) ? inventory.items : [],
+    emptyText: 'Nothing recovered for this category yet.',
+  });
+  if (list.ok && list.value) {
+    hudUiState.inventorySelectedItemId = list.value;
+  }
+  aura.ui.endColumn();
+
+  const selectedItemId = hudUiState.inventorySelectedItemId || inventory.selectedItemId;
+  const selectedItem = (Array.isArray(inventory.items) ? inventory.items : []).find((entry) => entry.id === selectedItemId)
+    || (Array.isArray(inventory.items) ? inventory.items[0] : null)
+    || null;
+
+  aura.ui.beginColumn({
+    id: 'adventure-inventory-detail-col',
+    width: 'fill',
+    gap: 10,
+    padding: 12,
+    background: '#10202c',
+    borderColor: '#213a50',
+  });
+  aura.ui.text('adventure-inventory-detail-label', {
+    text: 'DETAIL',
+    size: 11,
+    color: '#84c3ef',
+  });
+  aura.ui.text('adventure-inventory-detail-title', {
+    text: selectedItem?.label || 'No item selected',
+    size: 18,
+    color: '#f4f8ff',
+  });
+  aura.ui.text('adventure-inventory-detail-badge', {
+    text: selectedItem?.badge ? `${selectedItem.badge}${selectedItem.quantity > 1 ? ` · x${selectedItem.quantity}` : ''}` : 'Starter-owned inventory view',
+    size: 12,
+    color: '#f0cf79',
+  });
+  aura.ui.text('adventure-inventory-detail-copy', {
+    text: selectedItem?.description || 'Pickups, keys, and field notes now travel through one shared collection lane.',
+    size: 13,
+    color: '#d5e1ee',
+  });
+  if (selectedItem?.detail) {
+    aura.ui.text('adventure-inventory-detail-note', {
+      text: selectedItem.detail,
+      size: 12,
+      color: '#a7bacd',
+    });
+  }
+  aura.ui.endColumn();
+
+  aura.ui.endRow();
+  aura.ui.endView();
+}
+
+export function drawAdventureHud(data = {}, context = {}) {
+  drawInventoryPanel(data, context);
+
   let nextY = 12;
   if (data.showControlsHint !== false) {
-    aura.draw2d.text('Move: Arrows/WASD  Interact: E or Enter', 12, nextY, {
+    aura.draw2d.text('Move: Arrows/WASD  Interact: E or Enter  Inventory: I or Tab  Journal: J', 12, nextY, {
       color: aura.Color.WHITE,
       size: 14,
       align: 'left',
@@ -27,12 +186,20 @@ export function drawAdventureHud(data = {}) {
     align: 'left',
   });
   nextY += 22;
-  aura.draw2d.text(`Beacons ${data.beaconCount ?? 0}/${data.beaconTarget ?? 0}  FPS ${data.fps ?? '0'}`, 12, nextY, {
+  aura.draw2d.text(`${data.zoneLabel || 'Moon Archive'}  Checkpoint ${data.checkpointLabel || 'Route Entry'}  FPS ${data.fps ?? '0'}`, 12, nextY, {
     color: aura.Color.WHITE,
     size: 14,
     align: 'left',
   });
   nextY += 22;
+  if (data.objectiveText) {
+    aura.draw2d.text(data.objectiveText, 12, nextY, {
+      color: aura.rgb(0.76, 0.88, 1.0),
+      size: 13,
+      align: 'left',
+    });
+    nextY += 22;
+  }
 
   if (data.promptText) {
     aura.draw2d.text(data.promptText, 12, nextY, {
@@ -43,9 +210,25 @@ export function drawAdventureHud(data = {}) {
     nextY += 24;
   }
 
+  if (data.dialogueActive === true) {
+    aura.draw2d.text('Archive link active. Follow the overlay prompt to continue the conversation.', 12, nextY, {
+      color: aura.rgb(0.9, 0.86, 0.54),
+      size: 13,
+      align: 'left',
+    });
+    nextY += 22;
+  } else if (data.showJournal === true) {
+    aura.draw2d.text(data.journalHint || 'Journal open. Route intel is mirrored through the overlay screen.', 12, nextY, {
+      color: aura.rgb(0.78, 0.9, 1.0),
+      size: 13,
+      align: 'left',
+    });
+    nextY += 22;
+  }
+
   if (data.runComplete !== true) return;
 
-  aura.draw2d.text('RUINS SURVEY COMPLETE', 12, nextY, {
+  aura.draw2d.text('ARCHIVE ROUTE SECURED', 12, nextY, {
     color: aura.rgb(0.58, 1.0, 0.74),
     size: 24,
     align: 'left',

package/templates/create/2d-adventure/ui/journal.screen.js

@@ -0,0 +1,183 @@
+import { renderDialoguePanel, renderJournalPane, renderTabBar } from '../src/runtime/ui-forms.js';
+
+const journalScreen = {
+  id: 'journal',
+  kind: 'ui-screen',
+  role: 'overlay',
+  draw: drawAdventureJournalOverlay,
+  notes: ['This overlay proves the shared dialogue panel and shared journal pane without widening the starter scene list.'],
+};
+
+export function createJournalScreen() {
+  return journalScreen;
+}
+
+function createAdventureHudUiSeed() {
+  return {
+    showControlsHint: true,
+    showInventory: false,
+    showJournal: false,
+    inventorySelectedCategoryId: null,
+    inventorySelectedItemId: null,
+    journalSelectedCategoryId: null,
+    journalSelectedEntryId: null,
+    dialogueSelectedChoiceId: null,
+  };
+}
+
+function ensureAdventureHudUiState(context = {}) {
+  if (typeof context.ensureUiState === 'function') {
+    return context.ensureUiState('adventureHud', createAdventureHudUiSeed());
+  }
+  const appState = context.appState && typeof context.appState === 'object' ? context.appState : (context.appState = {});
+  if (!appState.ui || typeof appState.ui !== 'object' || Array.isArray(appState.ui)) {
+    appState.ui = {};
+  }
+  if (!appState.ui.adventureHud || typeof appState.ui.adventureHud !== 'object' || Array.isArray(appState.ui.adventureHud)) {
+    appState.ui.adventureHud = createAdventureHudUiSeed();
+  }
+  return appState.ui.adventureHud;
+}
+
+function beginOverlayView(id, size) {
+  aura.ui.beginView({
+    id,
+    x: 18,
+    y: 18,
+    width: Math.max(320, size.width - 36),
+    height: Math.max(280, size.height - 36),
+    gap: 12,
+    padding: 16,
+    clip: true,
+    background: '#071118',
+    borderColor: '#34506d',
+  });
+}
+
+function drawDialogueOverlay(data = {}, context = {}) {
+  const hudUiState = ensureAdventureHudUiState(context);
+  const size = aura.window?.getSize?.() || { width: 1280, height: 720 };
+  const dialogue = data.dialogue || {};
+  const line = dialogue.line || {};
+
+  beginOverlayView('adventure-dialogue-overlay', size);
+  aura.ui.text('adventure-dialogue-eyebrow', {
+    text: data.zoneLabel || 'Moon Archive',
+    size: 11,
+    color: '#7ec8ff',
+  });
+  aura.ui.text('adventure-dialogue-title', {
+    text: data.title || dialogue.title || 'Dialogue',
+    size: 24,
+    color: '#eef7ff',
+  });
+  if (data.controlsText) {
+    aura.ui.text('adventure-dialogue-controls', {
+      text: data.controlsText,
+      size: 12,
+      color: '#c8d8e7',
+    });
+  }
+
+  const panel = renderDialoguePanel({
+    id: 'adventure-dialogue-panel',
+    label: 'CONVERSATION',
+    speaker: line.speaker || 'Archive Link',
+    title: dialogue.nodeLabel || dialogue.title || 'Dialogue',
+    text: line.text || 'Connection established.',
+    note: dialogue.awaitingChoice === true
+      ? 'Choose a response to continue the route briefing.'
+      : 'Advance the briefing to continue.',
+    value: hudUiState.dialogueSelectedChoiceId || dialogue.selectedChoiceId || null,
+    choices: Array.isArray(dialogue.choices)
+      ? dialogue.choices.map((entry) => ({
+        id: entry.id,
+        label: entry.label,
+        description: entry.detail,
+        disabled: entry.disabled === true,
+      }))
+      : [],
+    emptyText: 'Press E, Enter, or Space to continue.',
+  });
+  if (panel.ok && panel.value) {
+    hudUiState.dialogueSelectedChoiceId = panel.value;
+  }
+  aura.ui.endView();
+}
+
+function drawJournalOverlay(data = {}, context = {}) {
+  const hudUiState = ensureAdventureHudUiState(context);
+  const size = aura.window?.getSize?.() || { width: 1280, height: 720 };
+  const journal = data.journal || {};
+
+  beginOverlayView('adventure-journal-overlay', size);
+  aura.ui.text('adventure-journal-eyebrow', {
+    text: data.zoneLabel || 'Moon Archive',
+    size: 11,
+    color: '#7ec8ff',
+  });
+  aura.ui.text('adventure-journal-title', {
+    text: 'Route Journal',
+    size: 24,
+    color: '#eef7ff',
+  });
+  if (data.objectiveText) {
+    aura.ui.text('adventure-journal-objective', {
+      text: data.objectiveText,
+      size: 13,
+      color: '#c8d8e7',
+    });
+  }
+  if (data.controlsText) {
+    aura.ui.text('adventure-journal-controls', {
+      text: data.controlsText,
+      size: 12,
+      color: '#9db2cb',
+    });
+  }
+
+  if (!hudUiState.journalSelectedCategoryId && journal.selectedCategoryId) {
+    hudUiState.journalSelectedCategoryId = journal.selectedCategoryId;
+  }
+  if (!hudUiState.journalSelectedEntryId && journal.selectedEntryId) {
+    hudUiState.journalSelectedEntryId = journal.selectedEntryId;
+  }
+
+  const tabs = renderTabBar({
+    id: 'adventure-journal-tabs',
+    value: hudUiState.journalSelectedCategoryId || journal.selectedCategoryId,
+    tabs: Array.isArray(journal.categories)
+      ? journal.categories.map((entry) => ({
+        id: entry.id,
+        label: `${entry.label} ${entry.count}`,
+      }))
+      : [],
+  });
+  if (tabs.ok && tabs.value) {
+    hudUiState.journalSelectedCategoryId = tabs.value;
+  }
+
+  const pane = renderJournalPane({
+    id: 'adventure-journal-pane',
+    label: 'ROUTE RECORD',
+    description: 'Shared starter-owned journal state now tracks route notes and archive intel.',
+    value: hudUiState.journalSelectedEntryId || journal.selectedEntryId,
+    entries: Array.isArray(journal.activeEntries) ? journal.activeEntries : [],
+    emptyText: 'No route entries are active for this section yet.',
+    detailEmptyText: 'Select a route record to inspect its current state.',
+  });
+  if (pane.ok && pane.value) {
+    hudUiState.journalSelectedEntryId = pane.value;
+  }
+  aura.ui.endView();
+}
+
+export function drawAdventureJournalOverlay(data = {}, context = {}) {
+  if (data.mode === 'dialogue') {
+    drawDialogueOverlay(data, context);
+    return;
+  }
+  drawJournalOverlay(data, context);
+}
+
+export default journalScreen;

package/templates/create/2d-survivor/src/runtime/app.js

@@ -1,6 +1,7 @@
 import { createSceneRegistry } from './scene-registry.js';
 import { createProjectInspector } from './project-inspector.js';
 import { assertRuntimeCapabilities } from './capabilities.js';
+import { initSplash, updateSplash, drawSplash, isSplashActive } from './splash.js';
 
 export function createApp() {
   const sceneRegistry = createSceneRegistry({
@@ -26,13 +27,16 @@ export function createApp() {
     },
     setup() {
       assertRuntimeCapabilities();
+      initSplash();
       activeScene()?.setup?.();
     },
     update(dt) {
+      if (isSplashActive()) { updateSplash(dt); return; }
       projectInspector.syncInput(globalThis.aura?.input || null);
       activeScene()?.update?.(dt);
     },
     draw() {
+      if (isSplashActive()) { drawSplash(); return; }
       activeScene()?.draw?.();
       projectInspector.draw({ activeSceneId });
     },

package/templates/create/3d/scenes/gameplay.scene.js

@@ -82,6 +82,34 @@ export function createGameplayScene(context = {}) {
   let playerVisual = null;
   let sceneState = createPlatformerRunState();
 
+  function configureSceneLook() {
+    aura.light.ambient({ r: 0.92, g: 0.96, b: 1.0 }, 0.16);
+    aura.light.hemisphere(
+      { r: 0.42, g: 0.56, b: 0.78 },
+      { r: 0.14, g: 0.11, b: 0.08 },
+      0.3,
+      { x: 0, y: 1, z: 0 },
+    );
+    aura.light.directional({ x: 0.58, y: -1.0, z: -0.32 }, { r: 1.0, g: 0.97, b: 0.9 }, 1.05);
+    aura.light.spot(
+      { x: 8.5, y: 6.5, z: 8.5 },
+      { x: -0.45, y: -1.0, z: -0.25 },
+      { r: 0.45, g: 0.78, b: 1.0 },
+      1.35,
+      28,
+      0.72,
+    );
+    aura.draw3d.setFog({
+      mode: 'exp2',
+      color: { r: 0.06, g: 0.09, b: 0.13 },
+      density: 0.018,
+    });
+    aura.draw3d.setOcclusionCulling({ enabled: true, conservative: true });
+    aura.draw3d.setPostFXPass('bloom', { strength: 0.28, radius: 0.5, threshold: 0.74 });
+    aura.draw3d.setPostFXPass('vignette', { strength: 0.12, radius: 0.94 });
+    aura.draw3d.setPostFXPass('fxaa', { strength: 1.0 });
+  }
+
   function syncSessionState() {
     platformerSession.lastSceneId = 'gameplay';
     platformerSession.bestScore = Math.max(Number(platformerSession.bestScore || 0), sceneState.score);
@@ -230,8 +258,7 @@ export function createGameplayScene(context = {}) {
       materials = createPlatformerMaterials();
       playerVisual = loadPlayerAvatarVisual();
 
-      aura.light.ambient({ r: 1, g: 1, b: 1 }, 0.22);
-      aura.light.directional({ x: 0.6, y: -1.0, z: -0.4 }, { r: 1, g: 1, b: 1 }, 1.0);
+      configureSceneLook();
       aura.camera3d.perspective(62, 0.1, 140);
 
       resetRun();
@@ -273,7 +300,7 @@ export function createGameplayScene(context = {}) {
       context.clearHudScreen?.();
     },
     draw() {
-      aura.draw3d.clear3d({ r: 0.06, g: 0.08, b: 0.12 });
+      aura.draw3d.clear3d({ r: 0.045, g: 0.06, b: 0.09 });
       drawPlatformerCourse({
         mesh: boxMesh,
         floorMaterial: materials.floor,

package/templates/create/3d/src/runtime/app.js

@@ -1,6 +1,7 @@
 import { createSceneRegistry } from './scene-registry.js';
 import { createProjectInspector } from './project-inspector.js';
 import { assertRuntimeCapabilities } from './capabilities.js';
+import { initSplash, updateSplash, drawSplash, isSplashActive } from './splash.js';
 
 export function createApp() {
   const sceneRegistry = createSceneRegistry({
@@ -26,13 +27,16 @@ export function createApp() {
     },
     setup() {
       assertRuntimeCapabilities();
+      initSplash();
       activeScene()?.setup?.();
     },
     update(dt) {
+      if (isSplashActive()) { updateSplash(dt); return; }
       projectInspector.syncInput(globalThis.aura?.input || null);
       activeScene()?.update?.(dt);
     },
     draw() {
+      if (isSplashActive()) { drawSplash(); return; }
       activeScene()?.draw?.();
       projectInspector.draw({ activeSceneId });
     },

package/templates/create/3d/src/runtime/capabilities.js

@@ -11,7 +11,9 @@ export function assertRuntimeCapabilities() {
   if (!hasMethod(aura.mesh, 'createBox')) missing.push('aura.mesh.createBox');
   if (!hasMethod(aura.material, 'create')) missing.push('aura.material.create');
   if (!hasMethod(aura.light, 'ambient')) missing.push('aura.light.ambient');
+  if (!hasMethod(aura.light, 'hemisphere')) missing.push('aura.light.hemisphere');
   if (!hasMethod(aura.light, 'directional')) missing.push('aura.light.directional');
+  if (!hasMethod(aura.light, 'spot')) missing.push('aura.light.spot');
   if (!hasMethod(aura.camera3d, 'perspective')) missing.push('aura.camera3d.perspective');
   if (!hasMethod(aura.camera3d, 'setPosition')) missing.push('aura.camera3d.setPosition');
   if (!hasMethod(aura.camera3d, 'lookAt')) missing.push('aura.camera3d.lookAt');
@@ -33,6 +35,9 @@ export function assertRuntimeCapabilities() {
   if (!hasMethod(aura.scene3d, 'submitRenderBindings')) missing.push('aura.scene3d.submitRenderBindings');
   if (!hasMethod(aura.draw3d, 'clear3d')) missing.push('aura.draw3d.clear3d');
   if (!hasMethod(aura.draw3d, 'drawMesh')) missing.push('aura.draw3d.drawMesh');
+  if (!hasMethod(aura.draw3d, 'setFog')) missing.push('aura.draw3d.setFog');
+  if (!hasMethod(aura.draw3d, 'setOcclusionCulling')) missing.push('aura.draw3d.setOcclusionCulling');
+  if (!hasMethod(aura.draw3d, 'setPostFXPass')) missing.push('aura.draw3d.setPostFXPass');
   if (!hasMethod(aura.draw2d, 'text')) missing.push('aura.draw2d.text');
   if (!hasMethod(aura.draw2d, 'measureText')) missing.push('aura.draw2d.measureText');
   if (typeof aura.rgb !== 'function') missing.push('aura.rgb');

package/templates/create/3d/src/runtime/materials.js

@@ -12,23 +12,33 @@ export function createPlatformerMaterials() {
     }),
     player: aura.material.create({
       color: { r: 0.98, g: 0.52, b: 0.26, a: 1.0 },
+      emissive: { r: 0.08, g: 0.03, b: 0.01 },
       metallic: 0.25,
       roughness: 0.35,
+      sheenColor: { r: 0.16, g: 0.1, b: 0.08 },
+      sheenRoughness: 0.46,
     }),
     pickup: aura.material.create({
       color: { r: 0.95, g: 0.9, b: 0.3, a: 1.0 },
+      emissive: { r: 0.42, g: 0.34, b: 0.08 },
       metallic: 0.65,
       roughness: 0.25,
     }),
     checkpoint: aura.material.create({
       color: { r: 0.36, g: 0.9, b: 1.0, a: 1.0 },
+      emissive: { r: 0.05, g: 0.22, b: 0.26 },
       metallic: 0.45,
       roughness: 0.28,
+      sheenColor: { r: 0.14, g: 0.2, b: 0.24 },
+      sheenRoughness: 0.22,
     }),
     goal: aura.material.create({
       color: { r: 0.5, g: 1.0, b: 0.64, a: 1.0 },
+      emissive: { r: 0.08, g: 0.24, b: 0.12 },
       metallic: 0.35,
       roughness: 0.35,
+      sheenColor: { r: 0.16, g: 0.22, b: 0.18 },
+      sheenRoughness: 0.28,
     }),
   };
 }

package/templates/create/3d-adventure/scenes/gameplay.scene.js

@@ -110,6 +110,34 @@ export function createGameplayScene(context = {}) {
   let playerVisual = null;
   let sceneState = createAdventureRunState();
 
+  function configureSceneLook() {
+    aura.light.ambient({ r: 0.9, g: 0.95, b: 1.0 }, 0.14);
+    aura.light.hemisphere(
+      { r: 0.26, g: 0.38, b: 0.56 },
+      { r: 0.08, g: 0.07, b: 0.06 },
+      0.34,
+      { x: 0, y: 1, z: 0 },
+    );
+    aura.light.directional({ x: 0.42, y: -1.0, z: -0.24 }, { r: 1.0, g: 0.95, b: 0.9 }, 0.96);
+    aura.light.spot(
+      { x: 0.5, y: 8.5, z: 7.5 },
+      { x: -0.08, y: -1.0, z: -0.34 },
+      { r: 0.54, g: 0.92, b: 1.0 },
+      1.4,
+      34,
+      0.7,
+    );
+    aura.draw3d.setFog({
+      mode: 'exp2',
+      color: { r: 0.035, g: 0.05, b: 0.075 },
+      density: 0.021,
+    });
+    aura.draw3d.setOcclusionCulling({ enabled: true, conservative: true });
+    aura.draw3d.setPostFXPass('bloom', { strength: 0.34, radius: 0.56, threshold: 0.7 });
+    aura.draw3d.setPostFXPass('vignette', { strength: 0.18, radius: 0.9 });
+    aura.draw3d.setPostFXPass('fxaa', { strength: 1.0 });
+  }
+
   function relicCount() {
     return countCompletedObjectives(sceneState.relics);
   }
@@ -280,8 +308,7 @@ export function createGameplayScene(context = {}) {
       materials = createAdventureMaterials();
       playerVisual = loadPlayerAvatarVisual();
 
-      aura.light.ambient({ r: 1, g: 1, b: 1 }, 0.23);
-      aura.light.directional({ x: 0.55, y: -1.0, z: -0.35 }, { r: 1, g: 1, b: 1 }, 1.0);
+      configureSceneLook();
       aura.camera3d.perspective(62, 0.1, 160);
 
       resetRun();
@@ -332,7 +359,7 @@ export function createGameplayScene(context = {}) {
     },
 
     draw() {
-      aura.draw3d.clear3d({ r: 0.05, g: 0.07, b: 0.11 });
+      aura.draw3d.clear3d({ r: 0.03, g: 0.045, b: 0.07 });
       drawAdventureCourse({
         mesh: boxMesh,
         floorMaterial: materials.floor,

package/templates/create/3d-adventure/src/runtime/capabilities.js

@@ -12,7 +12,9 @@ export function assertRuntimeCapabilities() {
   if (!hasMethod(aura.mesh, 'createBox')) missing.push('aura.mesh.createBox');
   if (!hasMethod(aura.material, 'create')) missing.push('aura.material.create');
   if (!hasMethod(aura.light, 'ambient')) missing.push('aura.light.ambient');
+  if (!hasMethod(aura.light, 'hemisphere')) missing.push('aura.light.hemisphere');
   if (!hasMethod(aura.light, 'directional')) missing.push('aura.light.directional');
+  if (!hasMethod(aura.light, 'spot')) missing.push('aura.light.spot');
   if (!hasMethod(aura.camera3d, 'perspective')) missing.push('aura.camera3d.perspective');
   if (!hasMethod(aura.camera3d, 'setPosition')) missing.push('aura.camera3d.setPosition');
   if (!hasMethod(aura.camera3d, 'lookAt')) missing.push('aura.camera3d.lookAt');
@@ -34,6 +36,9 @@ export function assertRuntimeCapabilities() {
   if (!hasMethod(aura.scene3d, 'submitRenderBindings')) missing.push('aura.scene3d.submitRenderBindings');
   if (!hasMethod(aura.draw3d, 'clear3d')) missing.push('aura.draw3d.clear3d');
   if (!hasMethod(aura.draw3d, 'drawMesh')) missing.push('aura.draw3d.drawMesh');
+  if (!hasMethod(aura.draw3d, 'setFog')) missing.push('aura.draw3d.setFog');
+  if (!hasMethod(aura.draw3d, 'setOcclusionCulling')) missing.push('aura.draw3d.setOcclusionCulling');
+  if (!hasMethod(aura.draw3d, 'setPostFXPass')) missing.push('aura.draw3d.setPostFXPass');
   if (!hasMethod(aura.draw2d, 'rect')) missing.push('aura.draw2d.rect');
   if (!hasMethod(aura.draw2d, 'text')) missing.push('aura.draw2d.text');
   if (!hasMethod(aura.draw2d, 'measureText')) missing.push('aura.draw2d.measureText');