npm - nova64 - Versions diffs - 0.2.5 → 0.2.7 - Mend

nova64 0.2.5 → 0.2.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (185) hide show

package/README.md +25 -8
package/bin/nova64.js +165 -0
package/dist/assets/console-CY_kygm3.js +14 -0
package/dist/assets/console-CY_kygm3.js.map +1 -0
package/dist/assets/main-l0sNRNKZ.js.map +1 -0
package/dist/assets/sky/studio/nx.png +0 -0
package/dist/assets/sky/studio/ny.png +0 -0
package/dist/assets/sky/studio/nz.png +0 -0
package/dist/assets/sky/studio/px.png +0 -0
package/dist/assets/sky/studio/py.png +0 -0
package/dist/assets/sky/studio/pz.png +0 -0
package/dist/assets/vanilla-Dcuy32gi.js +2 -0
package/dist/assets/vanilla-Dcuy32gi.js.map +1 -0
package/dist/console.html +899 -0
package/dist/docs/BENCHMARK.md +77 -0
package/dist/docs/CHEATSHEET.md +255 -0
package/dist/docs/EFFECTS_API_GUIDE.md +577 -0
package/dist/docs/EFFECTS_QUICK_REFERENCE.md +331 -0
package/dist/docs/FONT_CHARACTER_REFERENCE.md +219 -0
package/dist/docs/FREE_GLB_ASSETS.md +330 -0
package/dist/docs/FULLSCREEN_BUTTON_FEATURE.md +296 -0
package/dist/docs/GAMEPAD_SUPPORT.md +348 -0
package/dist/docs/GAME_IMPROVEMENTS.md +278 -0
package/dist/docs/GAME_QUALITY_STATUS.md +300 -0
package/dist/docs/MIGRATION_GUIDE.md +553 -0
package/dist/docs/NOVA64_3D_API.md +356 -0
package/dist/docs/NOVA64_API_REFERENCE.md +1406 -0
package/dist/docs/NOVA64_UI_API.md +503 -0
package/dist/docs/UI_SYSTEM_SUMMARY.md +445 -0
package/dist/docs/VOXEL_ENGINE_GUIDE.md +662 -0
package/dist/docs/VOXEL_QUICK_REFERENCE.md +386 -0
package/dist/docs/api-3d.html +750 -0
package/dist/docs/api-effects.html +385 -0
package/dist/docs/api-improvements.md +121 -0
package/dist/docs/api-skybox.html +407 -0
package/dist/docs/api-sprites.html +321 -0
package/dist/docs/api-voxel.html +337 -0
package/dist/docs/api.html +543 -0
package/dist/docs/assets.html +306 -0
package/dist/docs/audio.html +340 -0
package/dist/docs/blogs.html +286 -0
package/dist/docs/collision.html +316 -0
package/dist/docs/console.html +247 -0
package/dist/docs/editor.html +297 -0
package/dist/docs/font.html +247 -0
package/dist/docs/framebuffer.html +247 -0
package/dist/docs/fullscreen-button.html +297 -0
package/dist/docs/gpu-systems.html +247 -0
package/dist/docs/index.html +580 -0
package/dist/docs/input.html +491 -0
package/dist/docs/physics.html +311 -0
package/dist/docs/screens.html +311 -0
package/dist/docs/storage.html +311 -0
package/dist/docs/textinput.html +332 -0
package/dist/docs/ui.html +488 -0
package/dist/examples/3d-advanced/code.js +695 -0
package/dist/examples/adventure-comic-3d/code.js +342 -0
package/dist/examples/audio-lab/code.js +150 -0
package/dist/examples/boids-flocking/code.js +270 -0
package/dist/examples/crystal-cathedral-3d/code.js +706 -0
package/dist/examples/cyberpunk-city-3d/code.js +1383 -0
package/dist/examples/demoscene/README.md +192 -0
package/dist/examples/demoscene/code.js +1081 -0
package/dist/examples/demoscene/meta.json +21 -0
package/dist/examples/dungeon-crawler-3d/code.js +1117 -0
package/dist/examples/f-zero-nova-3d/code.js +865 -0
package/dist/examples/f-zero-nova-3d/code_old.js +1555 -0
package/dist/examples/fps-demo-3d/code.js +744 -0
package/dist/examples/game-of-life-3d/code.js +338 -0
package/dist/examples/generative-art/code.js +632 -0
package/dist/examples/hello-3d/code.js +325 -0
package/dist/examples/hello-skybox/code.js +183 -0
package/dist/examples/hello-world/code.js +19 -0
package/dist/examples/input-showcase/code.js +109 -0
package/dist/examples/instancing-demo/code.js +315 -0
package/dist/examples/minecraft-demo/code.js +387 -0
package/dist/examples/model-viewer-3d/code.js +114 -0
package/dist/examples/mystical-realm-3d/code.js +1203 -0
package/dist/examples/nature-explorer-3d/code.js +1318 -0
package/dist/examples/particles-demo/code.js +522 -0
package/dist/examples/pbr-showcase/code.js +140 -0
package/dist/examples/physics-demo-3d/code.js +948 -0
package/dist/examples/screen-demo/code.js +267 -0
package/dist/examples/shooter-demo-3d/code.js +1286 -0
package/dist/examples/space-combat-3d/IMPLEMENTATION_SUMMARY.md +109 -0
package/dist/examples/space-combat-3d/README.md +135 -0
package/dist/examples/space-combat-3d/code.js +1332 -0
package/dist/examples/space-harrier-3d/code.js +923 -0
package/dist/examples/star-fox-nova-3d/code.js +1116 -0
package/dist/examples/star-fox-nova-3d/code_backup.js +410 -0
package/dist/examples/star-fox-nova-3d/code_broken.js +1821 -0
package/dist/examples/storage-quest/code.js +209 -0
package/dist/examples/strider-demo-3d/IMPROVEMENT_OPTIONS.md +285 -0
package/dist/examples/strider-demo-3d/cache-test.html +132 -0
package/dist/examples/strider-demo-3d/code-fixed.js +582 -0
package/dist/examples/strider-demo-3d/code-old.js +1537 -0
package/dist/examples/strider-demo-3d/code.js +1462 -0
package/dist/examples/strider-demo-3d/code.js.bak2 +1169 -0
package/dist/examples/strider-demo-3d/fix-game.sh +53 -0
package/dist/examples/super-plumber-64/README.md +128 -0
package/dist/examples/super-plumber-64/code.js +1185 -0
package/dist/examples/super-plumber-64/index.html +88 -0
package/dist/examples/test-2d-overlay/code.js +32 -0
package/dist/examples/test-font/code.js +51 -0
package/dist/examples/test-minimal/code.js +21 -0
package/dist/examples/ui-demo/code.js +306 -0
package/dist/examples/wing-commander-space/README.md +180 -0
package/dist/examples/wing-commander-space/code.js +1285 -0
package/dist/examples/wizardry-3d/CHANGELOG.md +366 -0
package/dist/examples/wizardry-3d/code.js +3928 -0
package/dist/index.html +666 -0
package/dist/os9-shell/assets/index-DIHfrTaW.css +1 -0
package/dist/os9-shell/assets/index-KchE_ngx.js +483 -0
package/dist/os9-shell/assets/index-KchE_ngx.js.map +1 -0
package/dist/os9-shell/index.html +23 -0
package/dist/os9-shell/nova-icon.svg +12 -0
package/dist/runtime/api-2d.js +1158 -0
package/dist/runtime/api-3d/camera.js +73 -0
package/dist/runtime/api-3d/instancing.js +180 -0
package/dist/runtime/api-3d/lights.js +51 -0
package/dist/runtime/api-3d/materials.js +47 -0
package/dist/runtime/api-3d/models.js +84 -0
package/dist/runtime/api-3d/particles.js +296 -0
package/dist/runtime/api-3d/pbr.js +113 -0
package/dist/runtime/api-3d/primitives.js +304 -0
package/dist/runtime/api-3d/scene.js +169 -0
package/dist/runtime/api-3d/transforms.js +161 -0
package/dist/runtime/api-3d.js +166 -0
package/dist/runtime/api-effects.js +840 -0
package/dist/runtime/api-gameutils.js +476 -0
package/dist/runtime/api-generative.js +610 -0
package/dist/runtime/api-presets.js +85 -0
package/dist/runtime/api-skybox.js +232 -0
package/dist/runtime/api-sprites.js +100 -0
package/dist/runtime/api-voxel.js +712 -0
package/dist/runtime/api.js +201 -0
package/dist/runtime/assets.js +27 -0
package/dist/runtime/audio.js +114 -0
package/dist/runtime/collision.js +47 -0
package/dist/runtime/console.js +101 -0
package/dist/runtime/editor.js +233 -0
package/dist/runtime/font.js +233 -0
package/dist/runtime/framebuffer.js +28 -0
package/dist/runtime/fullscreen-button.js +185 -0
package/dist/runtime/gpu-canvas2d.js +47 -0
package/dist/runtime/gpu-threejs.js +643 -0
package/dist/runtime/gpu-webgl2.js +310 -0
package/dist/runtime/index.d.ts +682 -0
package/dist/runtime/index.js +22 -0
package/dist/runtime/input.js +225 -0
package/dist/runtime/logger.js +60 -0
package/dist/runtime/physics.js +101 -0
package/dist/runtime/screens.js +213 -0
package/dist/runtime/storage.js +38 -0
package/dist/runtime/store.js +151 -0
package/dist/runtime/textinput.js +68 -0
package/dist/runtime/ui/buttons.js +124 -0
package/dist/runtime/ui/panels.js +105 -0
package/dist/runtime/ui/text.js +86 -0
package/dist/runtime/ui/widgets.js +141 -0
package/dist/runtime/ui.js +111 -0
package/index.html +6 -1
package/package.json +9 -2
package/public/assets/sky/studio/nx.png +0 -0
package/public/assets/sky/studio/ny.png +0 -0
package/public/assets/sky/studio/nz.png +0 -0
package/public/assets/sky/studio/px.png +0 -0
package/public/assets/sky/studio/py.png +0 -0
package/public/assets/sky/studio/pz.png +0 -0
package/public/os9-shell/assets/index-KchE_ngx.js +483 -0
package/public/os9-shell/assets/index-KchE_ngx.js.map +1 -0
package/public/os9-shell/index.html +10 -1
package/runtime/api-2d.js +301 -21
package/runtime/api-3d/pbr.js +45 -1
package/runtime/api-3d.js +1 -0
package/runtime/api-effects.js +90 -3
package/runtime/api-gameutils.js +476 -0
package/runtime/api-generative.js +610 -0
package/runtime/api-skybox.js +54 -0
package/runtime/api-voxel.js +139 -28
package/runtime/gpu-threejs.js +13 -9
package/runtime/ui.js +2 -2
package/src/main.js +20 -0
package/public/os9-shell/assets/index-B1Uvacma.js +0 -32825
package/public/os9-shell/assets/index-B1Uvacma.js.map +0 -1

package/public/os9-shell/index.html CHANGED Viewed

@@ -2,10 +2,19 @@
 <html lang="en">
   <head>
     <meta charset="UTF-8" />
+    <base href="/os9-shell/" />
     <link rel="icon" type="image/svg+xml" href="./nova-icon.svg" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>nova64 OS</title>
-    <script type="module" crossorigin src="./assets/index-B1Uvacma.js"></script>
+    <script type="importmap">
+    {
+      "imports": {
+        "three": "https://esm.sh/three@0.182.0",
+        "three/examples/jsm/": "https://esm.sh/three@0.182.0/examples/jsm/"
+      }
+    }
+    </script>
+    <script type="module" crossorigin src="./assets/index-KchE_ngx.js"></script>
     <link rel="stylesheet" crossorigin href="./assets/index-DIHfrTaW.css">
   </head>
   <body>

package/runtime/api-2d.js CHANGED Viewed

@@ -6,7 +6,7 @@
 //   printCentered, printRight, drawScanlines, drawNoise, drawProgressBar,
 //   drawGlowText, drawPixelBorder, drawCheckerboard, colorLerp, colorMix, hexColor,
 //   drawStarburst, drawDiamond, drawTriangle, drawWave, drawSpiral, scrollingText,
-//   drawPanel, drawHealthBar, drawMinimap, n64Palette
+//   drawPanel, drawHealthBar, createMinimap, drawMinimap, n64Palette
 import { rgba8 } from './api.js';
@@ -731,29 +731,272 @@ export function api2d(gpu) {
     }
   }
+  // ── Minimap System ─────────────────────────────────────────────────────────
   /**
-   * drawMinimap(x, y, size, entities, bgColor)
-   * entities: [{ x, y, color, worldW, worldH }]  — dot map for players/enemies/items.
-   * worldW/worldH are the world-space bounds to normalise against.
+   * createMinimap(opts) — create a reusable minimap configuration.
+   *
+   * opts:
+   *   x, y          — screen position (default: bottom-right corner)
+   *   width, height  — pixel dimensions (default: 80×80)
+   *   bgColor       — background fill (default: semi-transparent black)
+   *   borderLight, borderDark — border colours (null to disable border)
+   *   shape         — 'rect' | 'circle' (default: 'rect')
+   *   follow        — entity to center on (object with .x, .y in world coords)
+   *   worldW, worldH — world-space bounds for coordinate mapping
+   *   tileW, tileH  — if set, map is tile-based (grid cells)
+   *   tileScale     — pixels per tile (default: 2)
+   *   tiles         — fn(tx,ty)→color|null or 2D array; null/0 = skip
+   *   fogOfWar      — if set, only reveal tiles within this radius of follow entity
+   *   entities      — array of { x, y, color, size?, label? }
+   *   player        — shorthand for the player entity { x, y, color?, blink? }
+   *   sweep         — { speed, color } for animated radar sweep line
+   *   gridLines     — number of grid divisions (0 = none)
+   *   gridColor     — colour for grid lines
+   *
+   * Returns a minimap object you pass to drawMinimap().
+   * You can mutate its properties between frames (e.g. update entities).
    */
-  function drawMinimap(x, y, size, entities, bgColor) {
-    const bg = bgColor ?? rgba8(0, 0, 0, 180);
-    const bgc = _unpack(bg);
-    // Fill minimap bg
-    for (let py = y; py < y + size; py++)
-      for (let px = x; px < x + size; px++) _blend(px, py, bgc.r, bgc.g, bgc.b, bgc.a);
-    // Border
-    drawPixelBorder(x, y, size, size, rgba8(150, 150, 150), rgba8(50, 50, 50), 1);
-    // Dots
-    for (const e of entities) {
-      const ww = e.worldW ?? 100,
-        wh = e.worldH ?? 100;
-      const dx = (x + (e.x / ww) * size) | 0;
-      const dy = (y + (e.y / wh) * size) | 0;
+  function createMinimap(opts = {}) {
+    return {
+      x: opts.x ?? W - 90,
+      y: opts.y ?? 10,
+      width: opts.width ?? 80,
+      height: opts.height ?? 80,
+      bgColor: opts.bgColor ?? rgba8(0, 0, 0, 180),
+      borderLight: opts.borderLight !== undefined ? opts.borderLight : rgba8(150, 150, 150),
+      borderDark: opts.borderDark !== undefined ? opts.borderDark : rgba8(50, 50, 50),
+      shape: opts.shape ?? 'rect',
+      follow: opts.follow ?? null,
+      worldW: opts.worldW ?? 100,
+      worldH: opts.worldH ?? 100,
+      tileW: opts.tileW ?? 0,
+      tileH: opts.tileH ?? 0,
+      tileScale: opts.tileScale ?? 2,
+      tiles: opts.tiles ?? null,
+      fogOfWar: opts.fogOfWar ?? 0,
+      entities: opts.entities ?? [],
+      player: opts.player ?? null,
+      sweep: opts.sweep ?? null,
+      gridLines: opts.gridLines ?? 0,
+      gridColor: opts.gridColor ?? rgba8(40, 60, 40, 120),
+    };
+  }
+  /** Internal: check if pixel is inside a circle */
+  function _inCircle(px, py, cx, cy, r) {
+    const dx = px - cx,
+      dy = py - cy;
+    return dx * dx + dy * dy <= r * r;
+  }
+  /**
+   * drawMinimap(minimap, time?)
+   *
+   * Accepts EITHER a createMinimap() object, OR the legacy signature:
+   *   drawMinimap(x, y, size, entities, bgColor)
+   *
+   * time is optional — only needed for sweep animation and player blinking.
+   */
+  function drawMinimap(minimapOrX, timeOrY, sizeArg, entitiesArg, bgColorArg) {
+    // Legacy compat: drawMinimap(x, y, size, entities, bgColor)
+    let mm;
+    let time = 0;
+    if (typeof minimapOrX === 'number') {
+      mm = createMinimap({
+        x: minimapOrX,
+        y: timeOrY,
+        width: sizeArg,
+        height: sizeArg,
+        worldW: 100,
+        worldH: 100,
+        bgColor: bgColorArg,
+      });
+      // Convert legacy entities (they carry worldW/worldH per-entity)
+      if (Array.isArray(entitiesArg)) {
+        mm.entities = entitiesArg.map(e => ({
+          x: e.x,
+          y: e.y,
+          color: e.color ?? rgba8(255, 255, 255),
+          size: 2,
+        }));
+        // Use first entity's world bounds if provided
+        if (entitiesArg.length > 0) {
+          mm.worldW = entitiesArg[0].worldW ?? 100;
+          mm.worldH = entitiesArg[0].worldH ?? 100;
+        }
+      }
+    } else {
+      mm = minimapOrX;
+      time = timeOrY ?? 0;
+    }
+    const { x, y, width: mw, height: mh, shape } = mm;
+    const cx = x + mw / 2,
+      cy = y + mh / 2;
+    const isCircle = shape === 'circle';
+    const radius = Math.min(mw, mh) / 2;
+    // 1. Background fill
+    const bgc = _unpack(mm.bgColor);
+    for (let py = y; py < y + mh; py++) {
+      for (let px = x; px < x + mw; px++) {
+        if (isCircle && !_inCircle(px, py, cx, cy, radius)) continue;
+        _blend(px, py, bgc.r, bgc.g, bgc.b, bgc.a);
+      }
+    }
+    // 2. Tile map rendering
+    if (mm.tiles && mm.tileW > 0 && mm.tileH > 0) {
+      const ts = mm.tileScale;
+      const isFunc = typeof mm.tiles === 'function';
+      const followTX = mm.follow ? Math.floor(mm.follow.x) : 0;
+      const followTY = mm.follow ? Math.floor(mm.follow.y) : 0;
+      for (let ty = 0; ty < mm.tileH; ty++) {
+        for (let tx = 0; tx < mm.tileW; tx++) {
+          // Fog of war check
+          if (mm.fogOfWar > 0 && mm.follow) {
+            const dist = Math.abs(tx - followTX) + Math.abs(ty - followTY);
+            if (dist > mm.fogOfWar) continue;
+          }
+          const tileColor = isFunc ? mm.tiles(tx, ty) : mm.tiles[ty] ? mm.tiles[ty][tx] : null;
+          if (!tileColor) continue;
+          const tc = _unpack(tileColor);
+          const px0 = x + tx * ts;
+          const py0 = y + ty * ts;
+          for (let dy = 0; dy < ts; dy++) {
+            for (let dx = 0; dx < ts; dx++) {
+              const px = px0 + dx,
+                py = py0 + dy;
+              if (isCircle && !_inCircle(px, py, cx, cy, radius)) continue;
+              _blend(px, py, tc.r, tc.g, tc.b, tc.a);
+            }
+          }
+        }
+      }
+    }
+    // 3. Grid lines
+    if (mm.gridLines > 0) {
+      const gc = _unpack(mm.gridColor);
+      for (let i = 1; i < mm.gridLines; i++) {
+        // Vertical line
+        const gx = (x + (mw / mm.gridLines) * i) | 0;
+        for (let py2 = y; py2 < y + mh; py2++) {
+          if (isCircle && !_inCircle(gx, py2, cx, cy, radius)) continue;
+          _blend(gx, py2, gc.r, gc.g, gc.b, gc.a);
+        }
+        // Horizontal line
+        const gy = (y + (mh / mm.gridLines) * i) | 0;
+        for (let px2 = x; px2 < x + mw; px2++) {
+          if (isCircle && !_inCircle(px2, gy, cx, cy, radius)) continue;
+          _blend(px2, gy, gc.r, gc.g, gc.b, gc.a);
+        }
+      }
+    }
+    // 4. Radar sweep line
+    if (mm.sweep) {
+      const angle = time * (mm.sweep.speed ?? 2);
+      const sc = _unpack(mm.sweep.color ?? rgba8(0, 255, 0, 100));
+      const sx = Math.cos(angle) * radius;
+      const sy = Math.sin(angle) * radius;
+      // Bresenham-ish sweep from center
+      const steps = Math.max(Math.abs(sx), Math.abs(sy)) | 0;
+      if (steps > 0) {
+        for (let s = 0; s <= steps; s++) {
+          const t = s / steps;
+          const px = (cx + sx * t) | 0;
+          const py = (cy + sy * t) | 0;
+          if (px < x || px >= x + mw || py < y || py >= y + mh) continue;
+          if (isCircle && !_inCircle(px, py, cx, cy, radius)) continue;
+          _blend(px, py, sc.r, sc.g, sc.b, sc.a);
+        }
+      }
+    }
+    // Helper: convert world coords to screen pixel
+    function worldToScreen(wx, wy) {
+      if (mm.tiles && mm.tileW > 0) {
+        // Tile-based — wx/wy are tile coords
+        return [(x + wx * mm.tileScale) | 0, (y + wy * mm.tileScale) | 0];
+      }
+      // World-space normalised
+      let nx, ny;
+      if (mm.follow) {
+        // Center on follow entity
+        nx = 0.5 + (wx - mm.follow.x) / mm.worldW;
+        ny = 0.5 + (wy - mm.follow.y) / mm.worldH;
+      } else {
+        nx = wx / mm.worldW;
+        ny = wy / mm.worldH;
+      }
+      return [(x + nx * mw) | 0, (y + ny * mh) | 0];
+    }
+    // 5. Entity dots
+    for (const e of mm.entities) {
+      const [ex, ey] = worldToScreen(e.x, e.y);
+      const dotSize = e.size ?? 2;
+      if (ex < x - dotSize || ex >= x + mw + dotSize || ey < y - dotSize || ey >= y + mh + dotSize)
+        continue;
       const ec = _unpack(e.color ?? rgba8(255, 255, 255));
-      // 2x2 dot
-      for (let oy = 0; oy < 2; oy++)
-        for (let ox = 0; ox < 2; ox++) _blend(dx + ox, dy + oy, ec.r, ec.g, ec.b, ec.a);
+      const half = (dotSize / 2) | 0;
+      for (let dy = -half; dy < dotSize - half; dy++) {
+        for (let dx = -half; dx < dotSize - half; dx++) {
+          const px = ex + dx,
+            py = ey + dy;
+          if (px < x || px >= x + mw || py < y || py >= y + mh) continue;
+          if (isCircle && !_inCircle(px, py, cx, cy, radius)) continue;
+          _blend(px, py, ec.r, ec.g, ec.b, ec.a);
+        }
+      }
+    }
+    // 6. Player marker (with optional blink)
+    if (mm.player) {
+      const blink = mm.player.blink !== false;
+      const visible = !blink || Math.sin(time * 8) > 0;
+      if (visible) {
+        const [px, py] = worldToScreen(mm.player.x, mm.player.y);
+        const pc = _unpack(mm.player.color ?? rgba8(50, 150, 255));
+        const ps = mm.player.size ?? 3;
+        const half = (ps / 2) | 0;
+        for (let dy = -half; dy < ps - half; dy++) {
+          for (let dx = -half; dx < ps - half; dx++) {
+            const ppx = px + dx,
+              ppy = py + dy;
+            if (ppx < x || ppx >= x + mw || ppy < y || ppy >= y + mh) continue;
+            if (isCircle && !_inCircle(ppx, ppy, cx, cy, radius)) continue;
+            _blend(ppx, ppy, pc.r, pc.g, pc.b, pc.a);
+          }
+        }
+      }
+    }
+    // 7. Border
+    if (mm.borderLight !== null) {
+      if (isCircle) {
+        // Circle border — draw a ring
+        const bc = _unpack(mm.borderLight);
+        const r2inner = (radius - 1) * (radius - 1);
+        const r2outer = radius * radius;
+        for (let py = y; py < y + mh; py++) {
+          for (let px = x; px < x + mw; px++) {
+            const dx = px - cx,
+              dy = py - cy;
+            const d2 = dx * dx + dy * dy;
+            if (d2 >= r2inner && d2 <= r2outer) {
+              _blend(px, py, bc.r, bc.g, bc.b, bc.a);
+            }
+          }
+        }
+      } else {
+        drawPixelBorder(x, y, mw, mh, mm.borderLight, mm.borderDark, 1);
+      }
     }
   }
@@ -768,6 +1011,40 @@ export function api2d(gpu) {
     _print(text, x, y, color, scale);
   }
+  /**
+   * drawFloatingTexts(system, offsetX?, offsetY?)
+   * Render all active texts from a createFloatingTextSystem().
+   * offsetX/offsetY allow camera offset (for screen shake, etc.)
+   */
+  function drawFloatingTexts(system, offsetX = 0, offsetY = 0) {
+    const texts = system.getTexts();
+    for (const t of texts) {
+      const alpha = Math.min(255, Math.floor((t.timer / t.maxTimer) * 255));
+      const r = (t.color >> 16) & 0xff;
+      const g = (t.color >> 8) & 0xff;
+      const b = t.color & 0xff;
+      _print(t.text, (t.x + offsetX) | 0, (t.y + offsetY) | 0, rgba8(r, g, b, alpha), t.scale);
+    }
+  }
+  /**
+   * drawFloatingTexts3D(system, projectFn)
+   * Render 3D floating texts using a user-supplied projection function.
+   * projectFn(x, y, z) should return [screenX, screenY].
+   * Use with spawn(..., { z: worldZ }) for 3D world-space floating texts.
+   */
+  function drawFloatingTexts3D(system, projectFn) {
+    const texts = system.getTexts();
+    for (const t of texts) {
+      const [sx, sy] = projectFn(t.x, t.y, t.z ?? 0);
+      const alpha = Math.min(255, Math.floor((t.timer / t.maxTimer) * 255));
+      const r = (t.color >> 16) & 0xff;
+      const g = (t.color >> 8) & 0xff;
+      const b = t.color & 0xff;
+      _print(t.text, sx | 0, sy | 0, rgba8(r, g, b, alpha), t.scale);
+    }
+  }
   // ── Full-screen helpers ───────────────────────────────────────────────────────
   /** Full-screen vertical gradient — great for sky/title backgrounds */
@@ -870,7 +1147,10 @@ export function api2d(gpu) {
         drawPixelBorder,
         drawPanel,
         drawCrosshair,
+        createMinimap,
         drawMinimap,
+        drawFloatingTexts,
+        drawFloatingTexts3D,
         scrollingText,
       });
     },

package/runtime/api-3d/pbr.js CHANGED Viewed

@@ -65,5 +65,49 @@ export function pbrModule({ meshes }) {
     return true;
   }
-  return { loadNormalMap, setNormalMap, setPBRMaps };
+  /**
+   * Set PBR scalar properties on a mesh without requiring texture maps.
+   * Clones the material so the change only affects this specific mesh.
+   *
+   * @param {number} meshId - ID returned by createSphere / createCube etc.
+   * @param {object} [opts]
+   * @param {number} [opts.metalness]        - 0 (dielectric) → 1 (fully metallic)
+   * @param {number} [opts.roughness]        - 0 (mirror-smooth) → 1 (fully rough)
+   * @param {number} [opts.envMapIntensity]  - Strength of environment reflections
+   * @param {number} [opts.color]            - Override surface colour (hex)
+   * @returns {boolean} true on success
+   */
+  function setPBRProperties(meshId, opts = {}) {
+    const mesh = meshes.get(meshId);
+    if (!mesh) return false;
+    // Replace with a fresh MeshStandardMaterial so we own it exclusively
+    // (avoids mutating a shared cached material that other meshes may use)
+    const old = mesh.material;
+    mesh.material = new THREE.MeshStandardMaterial({
+      color:
+        opts.color !== undefined
+          ? new THREE.Color(opts.color)
+          : (old.color?.clone() ?? new THREE.Color(0xffffff)),
+      map: old.map ?? null,
+      metalness:
+        opts.metalness !== undefined
+          ? Math.max(0, Math.min(1, opts.metalness))
+          : (old.metalness ?? 0.0),
+      roughness:
+        opts.roughness !== undefined
+          ? Math.max(0, Math.min(1, opts.roughness))
+          : (old.roughness ?? 0.6),
+      envMapIntensity: opts.envMapIntensity ?? old.envMapIntensity ?? 1.0,
+      emissive: old.emissive?.clone() ?? new THREE.Color(0),
+      emissiveIntensity: old.emissiveIntensity ?? 0,
+      transparent: old.transparent ?? false,
+      opacity: old.opacity ?? 1.0,
+      side: old.side ?? THREE.FrontSide,
+    });
+    mesh.material.needsUpdate = true;
+    return true;
+  }
+  return { loadNormalMap, setNormalMap, setPBRMaps, setPBRProperties };
 }

package/runtime/api-3d.js CHANGED Viewed

@@ -139,6 +139,7 @@ export function threeDApi(gpu) {
         loadNormalMap: ctx.loadNormalMap,
         setNormalMap: ctx.setNormalMap,
         setPBRMaps: ctx.setPBRMaps,
+        setPBRProperties: ctx.setPBRProperties,
         // GPU particle system
         createParticleSystem: ctx.createParticleSystem,

package/runtime/api-effects.js CHANGED Viewed

@@ -37,6 +37,58 @@ const ChromaticAberrationShader = {
   `,
 };
+// Glitch/damage shader — scanline displacement, RGB split, block artifacts
+const GlitchShader = {
+  uniforms: {
+    tDiffuse: { value: null },
+    intensity: { value: 0.0 },
+    time: { value: 0.0 },
+  },
+  vertexShader: `
+    varying vec2 vUv;
+    void main() {
+      vUv = uv;
+      gl_Position = projectionMatrix * modelViewMatrix * vec4(position, 1.0);
+    }
+  `,
+  fragmentShader: `
+    uniform sampler2D tDiffuse;
+    uniform float intensity;
+    uniform float time;
+    varying vec2 vUv;
+    float rand(vec2 co) {
+      return fract(sin(dot(co, vec2(12.9898, 78.233))) * 43758.5453);
+    }
+    void main() {
+      vec2 uv = vUv;
+      // Scanline displacement — horizontal bands shift left/right
+      float scanJitter = step(0.99 - intensity * 0.3, rand(vec2(time * 1.3, floor(uv.y * 40.0))))
+                        * (rand(vec2(time, floor(uv.y * 40.0))) - 0.5) * intensity * 0.15;
+      uv.x += scanJitter;
+      // Block glitch — large rectangular regions shift
+      float blockY = floor(uv.y * 8.0);
+      float blockShift = step(0.97 - intensity * 0.15, rand(vec2(blockY, time * 0.7)))
+                        * (rand(vec2(blockY + 1.0, time)) - 0.5) * intensity * 0.1;
+      uv.x += blockShift;
+      // RGB channel split
+      float rgbShift = intensity * 0.012;
+      float r = texture2D(tDiffuse, vec2(uv.x + rgbShift, uv.y + rgbShift * 0.5)).r;
+      float g = texture2D(tDiffuse, uv).g;
+      float b = texture2D(tDiffuse, vec2(uv.x - rgbShift, uv.y - rgbShift * 0.3)).b;
+      // Color corruption — random bright pixels
+      float noise = step(0.995 - intensity * 0.05, rand(uv + time)) * intensity;
+      gl_FragColor = vec4(r + noise, g, b + noise * 0.5, 1.0);
+    }
+  `,
+};
 // Vignette shader
 const VignetteShader = {
   uniforms: {
@@ -81,9 +133,11 @@ export function effectsApi(gpu) {
   let fxaaPass = null;
   let chromaticAberrationPass = null;
   let vignettePass = null;
+  let glitchPass = null;
   // Effect states
   let effectsEnabled = false;
+  let glitchTime = 0;
   // Custom shader materials
   const customShaders = new Map();
@@ -102,7 +156,7 @@ export function effectsApi(gpu) {
   }
   // === BLOOM EFFECTS ===
-  function enableBloom(strength = 1.0, radius = 0.5, threshold = 0.85) {
+  function enableBloom(strength = 1.0, radius = 0.5, threshold = 0.6) {
     initPostProcessing();
     if (bloomPass) {
@@ -187,7 +241,7 @@ export function effectsApi(gpu) {
   }
   // === VIGNETTE ===
-  function enableVignette(darkness = 1.5, offset = 0.95) {
+  function enableVignette(darkness = 1.0, offset = 0.9) {
     initPostProcessing();
     if (vignettePass) {
       vignettePass.uniforms['darkness'].value = darkness;
@@ -207,6 +261,31 @@ export function effectsApi(gpu) {
     }
   }
+  // === GLITCH EFFECT ===
+  function enableGlitch(intensity = 0.5) {
+    initPostProcessing();
+    if (glitchPass) {
+      glitchPass.uniforms['intensity'].value = Math.max(0, Math.min(1, intensity));
+      return;
+    }
+    glitchPass = new ShaderPass(GlitchShader);
+    glitchPass.uniforms['intensity'].value = Math.max(0, Math.min(1, intensity));
+    composer.addPass(glitchPass);
+  }
+  function disableGlitch() {
+    if (glitchPass && composer) {
+      composer.removePass(glitchPass);
+      glitchPass = null;
+    }
+  }
+  function setGlitchIntensity(intensity) {
+    if (glitchPass) {
+      glitchPass.uniforms['intensity'].value = Math.max(0, Math.min(1, intensity));
+    }
+  }
   // === CUSTOM SHADERS ===
   // Holographic shader
@@ -651,7 +730,7 @@ export function effectsApi(gpu) {
     const bloom = opts.bloom !== undefined ? opts.bloom : {};
     if (bloom !== false) {
       const b = typeof bloom === 'object' ? bloom : {};
-      enableBloom(b.strength ?? 1.5, b.radius ?? 0.4, b.threshold ?? 0.1);
+      enableBloom(b.strength ?? 1.0, b.radius ?? 0.4, b.threshold ?? 0.6);
     }
     // FXAA
@@ -701,6 +780,11 @@ export function effectsApi(gpu) {
   // Update effects (called every frame)
   function updateEffects(deltaTime) {
     updateShaderTime(deltaTime);
+    // Animate glitch time uniform for randomness
+    if (glitchPass) {
+      glitchTime += deltaTime;
+      glitchPass.uniforms['time'].value = glitchTime;
+    }
   }
   // === EXPOSE API ===
@@ -719,6 +803,9 @@ export function effectsApi(gpu) {
         disableChromaticAberration: disableChromaticAberration,
         enableVignette: enableVignette,
         disableVignette: disableVignette,
+        enableGlitch: enableGlitch,
+        disableGlitch: disableGlitch,
+        setGlitchIntensity: setGlitchIntensity,
         // Convenience
         enableRetroEffects: enableRetroEffects,