@auraindustry/aurajs 0.0.6 → 0.1.0

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

@@ -0,0 +1,80 @@
+function textColor(value) {
+  return aura.rgb(value.r, value.g, value.b);
+}
+
+function drawMetric(label, value, x, y, tone) {
+  aura.draw2d.text(label, x, y, {
+    size: 11,
+    color: aura.rgb(0.66, 0.72, 0.84),
+  });
+  aura.draw2d.text(String(value), x, y + 18, {
+    size: 16,
+    color: textColor(tone),
+  });
+}
+
+export function drawDeckbuilderHud(data = {}) {
+  const size = aura.window.getSize();
+
+  aura.draw2d.rectFill(0, 0, size.width, 106, aura.rgba(0.04, 0.05, 0.08, 0.94));
+  aura.draw2d.rectFill(0, 102, size.width, 4, aura.rgb(0.94, 0.8, 0.34));
+
+  aura.draw2d.text(data.title || '{{PROJECT_TITLE}}', 18, 14, {
+    size: 18,
+    color: aura.Color.WHITE,
+  });
+  aura.draw2d.text(data.subtitle || '', 18, 38, {
+    size: 13,
+    color: aura.rgb(0.74, 0.82, 0.94),
+  });
+  aura.draw2d.text(data.hint || '', 18, 60, {
+    size: 12,
+    color: aura.rgb(0.88, 0.82, 0.68),
+  });
+
+  drawMetric('SCENE', data.sceneLabel || 'BOOT', 520, 12, { r: 0.96, g: 0.86, b: 0.34 });
+  drawMetric('TURN', data.turn ?? '-', 650, 12, { r: 0.9, g: 0.92, b: 0.98 });
+  drawMetric('ENERGY', data.energy ?? '-', 760, 12, { r: 0.96, g: 0.82, b: 0.3 });
+  drawMetric('DRAW', data.drawPile ?? '-', 900, 12, { r: 0.64, g: 0.86, b: 0.98 });
+  drawMetric('DISCARD', data.discardPile ?? '-', 1010, 12, { r: 0.88, g: 0.78, b: 0.96 });
+  drawMetric('HAND', data.handSize ?? '-', 1140, 12, { r: 0.82, g: 0.92, b: 0.78 });
+
+  if (typeof data.playerHp !== 'undefined') {
+    aura.draw2d.text(`HP ${data.playerHp}  Block ${data.playerBlock || 0}`, 520, 60, {
+      size: 12,
+      color: aura.rgb(0.84, 0.92, 0.9),
+    });
+  }
+  if (typeof data.enemyHp !== 'undefined') {
+    aura.draw2d.text(`Enemy ${data.enemyHp}  Block ${data.enemyBlock || 0}`, 690, 60, {
+      size: 12,
+      color: aura.rgb(0.94, 0.8, 0.8),
+    });
+  }
+
+  if (data.outcome) {
+    aura.draw2d.text(data.outcome, 1130, 60, {
+      size: 16,
+      color: data.outcome === 'VICTORY' ? aura.rgb(0.96, 0.86, 0.34) : aura.rgb(0.94, 0.42, 0.36),
+    });
+  }
+
+  const lines = Array.isArray(data.logLines) ? data.logLines : [];
+  let lineY = 84;
+  for (const line of lines.slice(0, 2)) {
+    aura.draw2d.text(line, 18, lineY, {
+      size: 11,
+      color: aura.rgb(0.78, 0.84, 0.92),
+    });
+    lineY += 14;
+  }
+}
+
+const hudScreen = {
+  id: 'hud',
+  kind: 'ui-screen',
+  draw: drawDeckbuilderHud,
+  notes: ['Deckbuilder starter HUD draws from screen-shell state.'],
+};
+
+export default hudScreen;

package/templates/create/deckbuilder-2d/ui/pause.screen.js

@@ -0,0 +1,146 @@
+import { renderActionStrip } from '../src/runtime/ui-settings.js';
+
+const pauseScreen = {
+  id: 'pause',
+  kind: 'ui-screen',
+  role: 'modal',
+  draw: drawPauseScreen,
+  notes: [
+    'Stage 154 adds a retained pause/settings flow on top of the deckbuilder starter HUD.',
+    'Use this for resume, battle restart, boot return, and retained settings instead of direct escape-driven scene swaps.',
+  ],
+};
+
+function sizeOfWindow() {
+  return aura.window?.getSize?.() || { width: 1360, height: 820 };
+}
+
+export function createPauseScreen() {
+  return pauseScreen;
+}
+
+export function drawPauseScreen(data = {}, context = {}) {
+  const size = sizeOfWindow();
+  const panelWidth = Math.min(560, size.width - 72);
+  const panelHeight = Math.min(430, size.height - 88);
+  const panelX = Math.floor((size.width - panelWidth) * 0.5);
+  const panelY = Math.floor((size.height - panelHeight) * 0.5);
+
+  aura.draw2d.rect(0, 0, size.width, size.height, aura.rgba(0.02, 0.03, 0.06, 0.82));
+
+  aura.ui.beginView({
+    id: 'deckbuilder-pause-root',
+    x: panelX,
+    y: panelY,
+    width: panelWidth,
+    height: panelHeight,
+    gap: 14,
+    padding: 18,
+    clip: true,
+    background: '#08111b',
+    borderColor: '#32506c',
+  });
+
+  aura.ui.text('deckbuilder-pause-eyebrow', {
+    text: 'PAUSE MENU',
+    size: 12,
+    color: '#86c1f5',
+  });
+  aura.ui.text('deckbuilder-pause-title', {
+    text: 'Battle paused',
+    size: 28,
+    color: '#f4f8ff',
+  });
+  aura.ui.text('deckbuilder-pause-copy', {
+    text: 'Keep the current fight, restart the battle, return to boot, or adjust the retained UI preferences in place.',
+    size: 14,
+    color: '#c9d9ea',
+  });
+
+  aura.ui.beginRow({
+    id: 'deckbuilder-pause-shell',
+    gap: 16,
+    width: 'fill',
+  });
+
+  aura.ui.beginColumn({
+    id: 'deckbuilder-pause-summary',
+    width: 220,
+    gap: 10,
+    padding: 14,
+    background: '#0d1826',
+    borderColor: '#21384d',
+  });
+  aura.ui.text('deckbuilder-pause-summary-label', {
+    text: 'BATTLE SNAPSHOT',
+    size: 11,
+    color: '#7fb7ea',
+  });
+  aura.ui.text('deckbuilder-pause-turn', {
+    text: `Turn ${data.turn ?? 1}`,
+    size: 18,
+    color: '#eef5ff',
+  });
+  aura.ui.text('deckbuilder-pause-player', {
+    text: `Player HP ${data.playerHp ?? 0}`,
+    size: 14,
+    color: '#d1dfef',
+  });
+  aura.ui.text('deckbuilder-pause-enemy', {
+    text: `${data.enemyName || 'Enemy'} HP ${data.enemyHp ?? 0}`,
+    size: 14,
+    color: '#d1dfef',
+  });
+  aura.ui.text('deckbuilder-pause-outcome', {
+    text: data.outcome || 'Battle active',
+    size: 13,
+    color: '#f0cf79',
+  });
+  aura.ui.endColumn();
+
+  aura.ui.beginColumn({
+    id: 'deckbuilder-pause-actions-col',
+    width: 'fill',
+    gap: 12,
+    padding: 14,
+    background: '#0d1826',
+    borderColor: '#21384d',
+  });
+  aura.ui.text('deckbuilder-pause-actions-label', {
+    text: 'QUICK ACTIONS',
+    size: 11,
+    color: '#7fb7ea',
+  });
+  aura.ui.text('deckbuilder-pause-actions-copy', {
+    text: 'Settings edits appState.ui.preferences while the battle HUD remains mounted through screenShell.',
+    size: 13,
+    color: '#d1dfef',
+  });
+  const actions = renderActionStrip({
+    id: 'deckbuilder-pause-actions',
+    actions: [
+      { id: 'resume', label: 'Resume' },
+      { id: 'settings', label: 'Settings' },
+      { id: 'restart', label: 'Restart Battle' },
+      { id: 'boot', label: 'Back To Boot' },
+    ],
+  });
+  aura.ui.endColumn();
+
+  aura.ui.endRow();
+  aura.ui.endView();
+
+  if (actions.actionId === 'resume') {
+    context.popModalScreen?.({ action: 'resume' });
+  } else if (actions.actionId === 'settings') {
+    context.pushModalScreen?.('settings', { source: 'pause' });
+  } else if (actions.actionId === 'restart') {
+    context.popModalScreen?.({ action: 'restart' });
+    context.replaceScene?.('gameplay');
+  } else if (actions.actionId === 'boot') {
+    context.popModalScreen?.({ action: 'boot' });
+    context.swapScene?.('boot');
+  }
+}
+
+export default pauseScreen;

package/templates/create/deckbuilder-2d/ui/settings.screen.js

@@ -0,0 +1,342 @@
+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 gives the deckbuilder starter a retained settings flow next to its shell-owned HUD.',
+    'Canonical theme and UI preferences live in appState.ui.preferences.',
+  ],
+};
+
+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 ensureDeckbuilderUiState(context, appState) {
+  if (typeof context.ensureUiState === 'function') {
+    return context.ensureUiState('deckbuilderHud', {
+      showBattleHint: true,
+    });
+  }
+  if (!appState.ui || typeof appState.ui !== 'object' || Array.isArray(appState.ui)) {
+    appState.ui = {};
+  }
+  if (!appState.ui.deckbuilderHud || typeof appState.ui.deckbuilderHud !== 'object' || Array.isArray(appState.ui.deckbuilderHud)) {
+    appState.ui.deckbuilderHud = {
+      showBattleHint: true,
+    };
+  }
+  return appState.ui.deckbuilderHud;
+}
+
+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 clickedSegmentOption(controlId, optionId) {
+  const state = aura.ui.getViewState(`${controlId}-${optionId}`);
+  return state?.clicked === true || state?.activated === true;
+}
+
+export function createSettingsScreen() {
+  return settingsScreen;
+}
+
+export function drawSettingsScreen(_data = {}, context = {}) {
+  const appState = context.appState || {};
+  const settingsView = ensureSettingsView(context, appState);
+  const deckbuilderUiState = ensureDeckbuilderUiState(context, appState);
+  const preferences = currentPreferences(context, appState);
+  const themeState = currentThemeState(context, appState);
+  const size = sizeOfWindow();
+  const panelWidth = Math.min(960, size.width - 72);
+  const panelHeight = Math.min(620, size.height - 88);
+  const panelX = Math.floor((size.width - panelWidth) * 0.5);
+  const panelY = Math.floor((size.height - panelHeight) * 0.5);
+
+  aura.draw2d.rect(0, 0, size.width, size.height, aura.rgba(0.02, 0.03, 0.06, 0.82));
+
+  aura.ui.beginView({
+    id: 'deckbuilder-settings-root',
+    x: panelX,
+    y: panelY,
+    width: panelWidth,
+    height: panelHeight,
+    gap: 14,
+    padding: 18,
+    clip: true,
+    background: '#08111b',
+    borderColor: '#32506c',
+  });
+
+  aura.ui.text('deckbuilder-settings-eyebrow', {
+    text: 'SETTINGS',
+    size: 12,
+    color: '#86c1f5',
+  });
+  aura.ui.text('deckbuilder-settings-title', {
+    text: 'Retained deckbuilder settings',
+    size: 28,
+    color: '#f4f8ff',
+  });
+  aura.ui.text('deckbuilder-settings-copy', {
+    text: 'The battle HUD stays shell-owned while this modal owns the shared preferences and starter UI presentation toggles.',
+    size: 14,
+    color: '#c9d9ea',
+  });
+
+  aura.ui.beginRow({
+    id: 'deckbuilder-settings-shell',
+    gap: 16,
+    width: 'fill',
+    height: 'fill',
+  });
+
+  aura.ui.beginColumn({
+    id: 'deckbuilder-settings-summary',
+    width: 250,
+    gap: 10,
+    padding: 14,
+    background: '#0d1826',
+    borderColor: '#21384d',
+  });
+  aura.ui.text('deckbuilder-settings-summary-label', {
+    text: 'LIVE SNAPSHOT',
+    size: 11,
+    color: '#7fb7ea',
+  });
+  aura.ui.text('deckbuilder-settings-summary-theme', {
+    text: `Theme ${themeState?.presetLabel || 'Signal Dawn'}`,
+    size: 15,
+    color: '#eef5ff',
+  });
+  aura.ui.text('deckbuilder-settings-summary-density', {
+    text: `Density ${themeState?.density === 'compact' ? 'Compact' : 'Cozy'}`,
+    size: 15,
+    color: '#eef5ff',
+  });
+  aura.ui.text('deckbuilder-settings-summary-audio', {
+    text: `Music ${preferences.musicEnabled ? 'On' : 'Off'} · Volume ${formatPercentFromTenth(preferences.masterVolume)}`,
+    size: 14,
+    color: '#d1dfef',
+  });
+  aura.ui.text('deckbuilder-settings-summary-interface', {
+    text: `Battle hint ${deckbuilderUiState.showBattleHint !== false ? 'Shown' : 'Hidden'} · Subtitles ${preferences.subtitlesEnabled ? 'On' : 'Off'}`,
+    size: 14,
+    color: '#d1dfef',
+  });
+  aura.ui.endColumn();
+
+  aura.ui.beginColumn({
+    id: 'deckbuilder-settings-main',
+    width: 'fill',
+    gap: 12,
+  });
+
+  const sectionTabs = renderSegmentedControl({
+    id: 'deckbuilder-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;
+  }
+
+  aura.ui.beginColumn({
+    id: 'deckbuilder-settings-card',
+    gap: 12,
+    width: 'fill',
+    padding: 14,
+    background: '#0d1826',
+    borderColor: '#21384d',
+  });
+
+  if ((settingsView.activeSection || 'audio') === 'audio') {
+    aura.ui.text('deckbuilder-settings-audio-label', {
+      text: 'AUDIO',
+      size: 11,
+      color: '#7fb7ea',
+    });
+    aura.ui.toggle('deckbuilder-settings-music', {
+      label: 'Music playback',
+      value: preferences.musicEnabled === true,
+      width: 'fill',
+    });
+    aura.ui.slider('deckbuilder-settings-volume', {
+      label: `Master volume ${formatPercentFromTenth(preferences.masterVolume)}`,
+      min: 0,
+      max: 10,
+      step: 1,
+      value: preferences.masterVolume,
+      width: 'fill',
+    });
+  } else if (settingsView.activeSection === 'display') {
+    aura.ui.text('deckbuilder-settings-display-label', {
+      text: 'DISPLAY',
+      size: 11,
+      color: '#7fb7ea',
+    });
+    renderSegmentedControl({
+      id: 'deckbuilder-settings-theme',
+      label: 'Theme preset',
+      description: 'Starter-owned semantic presets from src/runtime/ui-theme.js.',
+      value: preferences.themeId,
+      options: listThemeSegmentOptions(),
+    });
+    renderSegmentedControl({
+      id: 'deckbuilder-settings-density',
+      label: 'Density',
+      value: preferences.density,
+      options: listDensitySegmentOptions(),
+    });
+    renderSegmentedControl({
+      id: 'deckbuilder-settings-contrast',
+      label: 'Contrast',
+      value: preferences.contrast,
+      options: listContrastSegmentOptions(),
+    });
+  } else {
+    aura.ui.text('deckbuilder-settings-interface-label', {
+      text: 'INTERFACE',
+      size: 11,
+      color: '#7fb7ea',
+    });
+    aura.ui.toggle('deckbuilder-settings-subtitles', {
+      label: 'Subtitles',
+      value: preferences.subtitlesEnabled === true,
+      width: 'fill',
+    });
+    aura.ui.toggle('deckbuilder-settings-reduce-motion', {
+      label: 'Reduce motion',
+      value: preferences.reduceMotion === true,
+      width: 'fill',
+    });
+    aura.ui.toggle('deckbuilder-settings-battle-hint', {
+      label: 'Show battle hint banner',
+      value: deckbuilderUiState.showBattleHint !== false,
+      width: 'fill',
+    });
+  }
+
+  aura.ui.endColumn();
+
+  const actions = renderActionStrip({
+    id: 'deckbuilder-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('deckbuilder-settings-music', preferences.musicEnabled);
+  const masterVolume = readNumberViewValue('deckbuilder-settings-volume', preferences.masterVolume);
+  const subtitlesEnabled = readBooleanViewValue('deckbuilder-settings-subtitles', preferences.subtitlesEnabled);
+  const reduceMotion = readBooleanViewValue('deckbuilder-settings-reduce-motion', preferences.reduceMotion);
+  const showBattleHint = readBooleanViewValue('deckbuilder-settings-battle-hint', deckbuilderUiState.showBattleHint !== 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;
+
+  for (const option of listThemeSegmentOptions()) {
+    if (clickedSegmentOption('deckbuilder-settings-theme', option.id)) {
+      patch.themeId = option.id;
+    }
+  }
+  for (const option of listDensitySegmentOptions()) {
+    if (clickedSegmentOption('deckbuilder-settings-density', option.id)) {
+      patch.density = option.id;
+    }
+  }
+  for (const option of listContrastSegmentOptions()) {
+    if (clickedSegmentOption('deckbuilder-settings-contrast', option.id)) {
+      patch.contrast = option.id;
+    }
+  }
+
+  if (showBattleHint !== (deckbuilderUiState.showBattleHint !== false)) {
+    deckbuilderUiState.showBattleHint = showBattleHint;
+  }
+  if (Object.keys(patch).length > 0) {
+    updatePreferences(context, appState, patch);
+  }
+  if (actions.actionId === 'restore') {
+    resetPreferences(context, appState);
+    deckbuilderUiState.showBattleHint = true;
+    settingsView.activeSection = 'audio';
+  } else if (actions.actionId === 'back') {
+    context.popModalScreen?.({ action: 'back' });
+  }
+}
+
+export default settingsScreen;

package/templates/create/local-multiplayer/aura.config.json

@@ -0,0 +1,40 @@
+{
+  "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": false,
+    "multiplayer": true,
+    "steam": false
+  },
+  "multiplayer": {
+    "roomCode": "AURA2P",
+    "roomName": "{{PROJECT_TITLE}} Room",
+    "mode": "local",
+    "relay": null,
+    "coordinatorUrl": null,
+    "relayUrl": null,
+    "showDiagnostics": true,
+    "chatEnabled": true,
+    "chatHistoryLimit": 6
+  }
+}

package/templates/create/local-multiplayer/config/gameplay/local-multiplayer.config.js

@@ -0,0 +1,26 @@
+export const LOCAL_MULTIPLAYER_CONFIG = Object.freeze({
+  port: 47000,
+  width: 960,
+  height: 540,
+  playerWidth: 36,
+  playerHeight: 22,
+  playerSpeed: 210,
+  hostFallbackSeconds: 0.4,
+  maxPlayers: 2,
+  tickRate: 20,
+  protocol: 'tcp',
+  // Project-level room + relay defaults now live in aura.config.json -> multiplayer.
+  // Keep this file for local gameplay tuning plus optional starter-local overrides.
+  // Easiest internet-backed setup: set multiplayer.relay in aura.config.json.
+  // Example:
+  //   "multiplayer": { "relay": "relay.aurajs.gg" }
+  // That keeps the same `npm run dev` + `npm run join -- CODE` flow and
+  // auto-promotes hosting to internet-backed "auto" mode. Set mode: 'relay'
+  // only when you want to skip direct UDP and force relay transport.
+  connectivity: Object.freeze({
+    mode: 'local',
+    relay: null,
+    coordinatorUrl: null,
+    relayUrl: null,
+  }),
+});

package/templates/create/local-multiplayer/content/gameplay/room-layout.js

@@ -0,0 +1,13 @@
+export const ROOM_LAYOUT = Object.freeze({
+  schema: 'aurajs.local-room-layout.v1',
+  roomCode: 'AURA2P',
+  roomName: '{{PROJECT_TITLE}} Local Room',
+  spawnSlots: [
+    { id: 'host', x: 180, y: 210, label: 'host' },
+    { id: 'guest', x: 744, y: 300, label: 'guest' },
+  ],
+});
+
+export function findSpawnSlot(slotId) {
+  return ROOM_LAYOUT.spawnSlots.find((slot) => slot.id === slotId) || null;
+}

package/templates/create/local-multiplayer/content/registries/.gitkeep

@@ -0,0 +1 @@
+

package/templates/create/local-multiplayer/docs/design/loop.md

@@ -0,0 +1,14 @@
+# Room-Code Multiplayer Loop
+
+- one local-first host in the current native dev loop by default
+- one join path from the same project through `npm run join -- AURA2P`
+- one authoritative room state through `aura.multiplayer`
+- one project-level multiplayer block in `aura.config.json`
+  when you want room code, diagnostics, and relay defaults in one place
+
+Keep this starter focused on the local-first dev slice of room-code
+multiplayer. The default template keeps hosting local-first, while the authored
+project config can promote the same `npm run dev` + `npm run join -- CODE`
+flow to internet-backed hosting by setting `aura.config.json -> multiplayer.relay`
+or the `AURA_MULTIPLAYER_RELAY_HOST` env var. Direct host/port joins and LAN
+discovery still stay outside this starter.