oriverse-engine 0.1.8 → 0.1.9

package/LICENSE.md

@@ -1,30 +1,30 @@
-# Oriverse Artifact Bundle License
-
-> PLACEHOLDER — review with legal counsel before the first `npm publish`.
-
-Copyright (c) 2026 Oriverse. All rights reserved.
-
-This package contains a compiled, proprietary build of the Oriverse engine
-("the Bundle"). No source code is included or licensed.
-
-Permission is hereby granted, free of charge and royalty-free, to any person
-obtaining a copy of the Bundle to:
-
-1. Use the Bundle to run and serve games and applications, commercial or
-   non-commercial.
-2. Redistribute the Bundle **unmodified** (including via CDNs such as unpkg,
-   bundlers, or by copying the `dist/` files alongside your game), provided this
-   license file accompanies any standalone redistribution of the Bundle.
-
-The following are NOT permitted:
-
-- Modifying, decompiling, disassembling, or reverse-engineering the Bundle,
-  except to the extent such restriction is prohibited by applicable law.
-- Redistributing modified versions of the Bundle.
-- Representing the Bundle as your own work or removing copyright notices.
-
-THE BUNDLE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY ARISING FROM THE USE OF THE BUNDLE.
+# Oriverse Artifact Bundle License
+
+> PLACEHOLDER — review with legal counsel before the first `npm publish`.
+
+Copyright (c) 2026 Oriverse. All rights reserved.
+
+This package contains a compiled, proprietary build of the Oriverse engine
+("the Bundle"). No source code is included or licensed.
+
+Permission is hereby granted, free of charge and royalty-free, to any person
+obtaining a copy of the Bundle to:
+
+1. Use the Bundle to run and serve games and applications, commercial or
+   non-commercial.
+2. Redistribute the Bundle **unmodified** (including via CDNs such as unpkg,
+   bundlers, or by copying the `dist/` files alongside your game), provided this
+   license file accompanies any standalone redistribution of the Bundle.
+
+The following are NOT permitted:
+
+- Modifying, decompiling, disassembling, or reverse-engineering the Bundle,
+  except to the extent such restriction is prohibited by applicable law.
+- Redistributing modified versions of the Bundle.
+- Representing the Bundle as your own work or removing copyright notices.
+
+THE BUNDLE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY ARISING FROM THE USE OF THE BUNDLE.

package/README.md

@@ -29,11 +29,11 @@ object Box { model = "cube" position = (0, 300, 100) size = (100, 100, 100) colo
   </script>
 
   <!-- Pinned engine version: bump @0.1.2 together on new releases -->
-  <script src="https://unpkg.com/oriverse-engine@0.1.8/dist/ktx_lib.js"></script>
-  <script src="https://unpkg.com/oriverse-engine@0.1.8/dist/ktx_bridge.js"></script>
+  <script src="https://unpkg.com/oriverse-engine@0.1.9/dist/ktx_lib.js"></script>
+  <script src="https://unpkg.com/oriverse-engine@0.1.9/dist/ktx_bridge.js"></script>
   <script type="module">
-    import initOriverse from "https://unpkg.com/oriverse-engine@0.1.8/dist/oriverse_wgpu.js";
-    await initOriverse({ module_or_path: "https://unpkg.com/oriverse-engine@0.1.8/dist/oriverse_wgpu_bg.wasm" });
+    import initOriverse from "https://unpkg.com/oriverse-engine@0.1.9/dist/oriverse_wgpu.js";
+    await initOriverse({ module_or_path: "https://unpkg.com/oriverse-engine@0.1.9/dist/oriverse_wgpu_bg.wasm" });
   </script>
 </body>
 </html>
@@ -49,8 +49,8 @@ The engine auto-boots from the `#oriverse-weave` tag. To boot programmatically
 instead, omit the tag and call the typed export once after init:
 
 ```js
-import initOriverse, { bootOriverseArtifact } from "https://unpkg.com/oriverse-engine@0.1.8/dist/oriverse_wgpu.js";
-await initOriverse({ module_or_path: "https://unpkg.com/oriverse-engine@0.1.8/dist/oriverse_wgpu_bg.wasm" });
+import initOriverse, { bootOriverseArtifact } from "https://unpkg.com/oriverse-engine@0.1.9/dist/oriverse_wgpu.js";
+await initOriverse({ module_or_path: "https://unpkg.com/oriverse-engine@0.1.9/dist/oriverse_wgpu_bg.wasm" });
 await bootOriverseArtifact(weaveSource);
 ```
 
@@ -69,7 +69,7 @@ point an agent at it, and say "make a game".
 - Content must be fully procedural: primitive models, `#mesh`, `#texture`,
   `#particles`. Market/network assets are unavailable and hard-error.
 - Weave language + API reference: `dist/weave_documentation.txt`
-  (also at `https://unpkg.com/oriverse-engine@0.1.8/dist/weave_documentation.txt`).
+  (also at `https://unpkg.com/oriverse-engine@0.1.9/dist/weave_documentation.txt`).
 - Package/runtime onboarding: `dist/AGENT_ONBOARDING.md`.
 - Copy-paste prompt for AI coding agents: `dist/CODEX_PROMPT.md`.
 

package/dist/CODEX_PROMPT.md

@@ -53,15 +53,15 @@ object BlueCube {
   </script>
   <!-- ==== END OF EDITABLE BLOCK ==== -->
 
-  <script src="https://cdn.jsdelivr.net/npm/oriverse-engine@0.1.7/dist/ktx_lib.js"></script>
-  <script src="https://cdn.jsdelivr.net/npm/oriverse-engine@0.1.7/dist/ktx_bridge.js"></script>
+  <script src="https://cdn.jsdelivr.net/npm/oriverse-engine@0.1.9/dist/ktx_lib.js"></script>
+  <script src="https://cdn.jsdelivr.net/npm/oriverse-engine@0.1.9/dist/ktx_bridge.js"></script>
   <script type="module">
-    import initOriverse from "https://cdn.jsdelivr.net/npm/oriverse-engine@0.1.7/dist/oriverse_wgpu.js";
+    import initOriverse from "https://cdn.jsdelivr.net/npm/oriverse-engine@0.1.9/dist/oriverse_wgpu.js";
     const setBoot = (t) => { const b = document.getElementById('oriverse-status-banner'); if (b) b.textContent = t; };
     (async () => {
       try {
         setBoot('starting engine…');
-        await initOriverse({ module_or_path: "https://cdn.jsdelivr.net/npm/oriverse-engine@0.1.7/dist/oriverse_wgpu_bg.wasm" });
+        await initOriverse({ module_or_path: "https://cdn.jsdelivr.net/npm/oriverse-engine@0.1.9/dist/oriverse_wgpu_bg.wasm" });
       } catch (e) {
         setBoot('WASM init failed:\n' + ((e && e.stack) ? e.stack : String(e)));
         console.error('[wasm_boot] initOriverse failed:', e);
@@ -90,15 +90,15 @@ Rules — the engine hard-errors if you break the first two:
 - `color = (r, g, b)` uses 0-1 floats (or `#RRGGBB`). 0-255 values clamp to WHITE.
 - The game boots straight into play mode. WASD + mouse + Space jump already work via a
   default player controller; define `#class player ... #end` only for custom movement.
-- Give the world a ground object, a HUD (`screenCanvas`), a win or lose condition, and
-  `event KeyboardDown[R] { RestartGame() }` to replay.
+- Give the world a ground object, a HUD (`screenCanvas`), a win or lose condition, and a
+  Restart `button` whose `ClickButton` handler calls `RestartGame()` to replay.
 
 Authoritative references, served next to the engine (fetch if you can — the authoring
 guide contains three complete tested example games to pattern-match from):
 
-- https://cdn.jsdelivr.net/npm/oriverse-engine@0.1.7/dist/GAME_AUTHORING.md  <- game patterns + 3 full example games
-- https://cdn.jsdelivr.net/npm/oriverse-engine@0.1.7/dist/weave_documentation.txt  <- full language + API reference
-- https://cdn.jsdelivr.net/npm/oriverse-engine@0.1.7/dist/examples/coin_collector.weave (also dodge_blocks / target_range)
+- https://cdn.jsdelivr.net/npm/oriverse-engine@0.1.9/dist/GAME_AUTHORING.md  <- game patterns + 3 full example games
+- https://cdn.jsdelivr.net/npm/oriverse-engine@0.1.9/dist/weave_documentation.txt  <- full language + API reference
+- https://cdn.jsdelivr.net/npm/oriverse-engine@0.1.9/dist/examples/coin_collector.weave (also dodge_blocks / target_range)
 
 ## Step 3: test
 

package/dist/GAME_AUTHORING.md

@@ -72,8 +72,8 @@ event OnSpawned {             // main entry; runs once when the object spawns
         }
     }
 }
-event KeyboardDown[R] {       // any player pressed R (use ...ByThisPlayer only in #class player)
-    RestartGame()
+event ClickButton {           // any player clicked any UI button
+    if Event.ClickedButton == ResolveObjectByNameOnce("RestartBtn") { RestartGame() }
 }
 #end
 ```
@@ -206,7 +206,7 @@ The manager pattern (used by all three examples):
 - Keep `var GameOver = false` (or `RoundOver`) on the tagged manager.
 - Losing conditions write it cross-object: `NearestObjectWithTag(Tag.Manager).GameOver = true`.
 - The manager's `forever` loop shows the banner and freezes scoring when set.
-- `event KeyboardDown[R] { RestartGame() }` reloads the whole world (fresh state).
+- Replay: a Restart `button` shown at game over; its `ClickButton` handler calls `RestartGame()`.
 
 ## 9. Procedural textures and meshes (quickstarts)
 
@@ -269,7 +269,7 @@ Collect 10 spinning coins; HUD counter; win banner + R to restart. Demonstrates:
 objects + runtime spawning, tags, proximity pickup, default player controller.
 
 ```text
-// Coin Collector — walk into the 10 spinning coins to collect them all. Press R to replay.
+// Coin Collector — walk into the 10 spinning coins to collect them all. Click Restart to replay.
 // Demonstrates: saved objects + runtime spawning, tags, proximity pickup, HUD score text,
 // win + restart flow. Movement uses the engine's default player controller (no #class player).
 
@@ -299,6 +299,7 @@ event OnSpawned {
     }
     var scoreLabel = ResolveObjectByNameOnce("ScoreText")
     var midLabel = ResolveObjectByNameOnce("MidText")
+    var restartBtn = ResolveObjectByNameOnce("RestartBtn")
     forever {
         // Spawned coins register their tag on the next tick, so wait until the census
         // has seen at least one coin before treating "0 left" as a win.
@@ -306,7 +307,8 @@ event OnSpawned {
         var collected = TotalCoins - left
         scoreLabel.SetText("Coins: " + collected + " / " + TotalCoins)
         if left == 0 and collected == TotalCoins and SeenCoins {
-            midLabel.SetText("YOU WIN!  Press R to play again")
+            midLabel.SetText("YOU WIN!")
+            restartBtn.SetVisible(true)
         } else {
             midLabel.SetText("")
         }
@@ -315,8 +317,8 @@ event OnSpawned {
         }
     }
 }
-event KeyboardDown[R] {
-    RestartGame()
+event ClickButton {
+    if Event.ClickedButton == ResolveObjectByNameOnce("RestartBtn") { RestartGame() }
 }
 #end
 
@@ -338,6 +340,7 @@ display manager : GameManager { visible = false }
 screenCanvas HUD {
     textLabel ScoreText { offset = (20, 20) text = "Coins: 0 / 10" color = (1, 1, 0.85) }
     textLabel MidText { align = (center, center) text = "" color = (1, 1, 0.3) }
+    button RestartBtn { anchor = (center, center) offset = (0, 70) size = (220, 52) text = "Restart" corner_radius = 8 color = #B98A20 visible = false }
 }
 ```
 
@@ -348,7 +351,7 @@ Demonstrates: timed spawner, dynamic physics objects, cross-object state writes,
 lose + restart flow.
 
 ```text
-// Dodge the Falling Blocks — red cubes rain down; touching one ends the run. Press R to retry.
+// Dodge the Falling Blocks — red cubes rain down; touching one ends the run. Click Restart to retry.
 // Demonstrates: a hidden manager object, timed spawning with Timer, dynamic physics objects,
 // cross-object variable writes (block -> manager), survival-seconds score, lose + restart flow.
 // Movement uses the engine's default player controller (no #class player).
@@ -380,9 +383,11 @@ event OnSpawned {
     var dropTmr = Timer()
     var scoreLabel = ResolveObjectByNameOnce("ScoreText")
     var midLabel = ResolveObjectByNameOnce("MidText")
+    var restartBtn = ResolveObjectByNameOnce("RestartBtn")
     forever {
         if GameOver {
-            midLabel.SetText("GAME OVER — survived " + Score + " s. Press R to retry")
+            midLabel.SetText("GAME OVER — survived " + Score + " s")
+            restartBtn.SetVisible(true)
             continue
         }
         if secondTmr.IsDone() {
@@ -397,8 +402,8 @@ event OnSpawned {
         }
     }
 }
-event KeyboardDown[R] {
-    RestartGame()
+event ClickButton {
+    if Event.ClickedButton == ResolveObjectByNameOnce("RestartBtn") { RestartGame() }
 }
 #end
 
@@ -417,6 +422,7 @@ display manager : GameManager { visible = false }
 screenCanvas HUD {
     textLabel ScoreText { offset = (20, 20) text = "Survived: 0 s" color = (1, 1, 1) }
     textLabel MidText { align = (center, center) text = "" color = (1, 0.45, 0.35) }
+    button RestartBtn { anchor = (center, center) offset = (0, 70) size = (220, 52) text = "Restart" corner_radius = 8 color = #B03A2E visible = false }
 }
 ```
 
@@ -427,7 +433,7 @@ Click the floating spheres through the crosshair; 30-second round. Demonstrates:
 called cross-object, TeleportTo respawn, countdown timer.
 
 ```text
-// Target Range — aim at the floating spheres and left-click to score. 30-second round, R restarts.
+// Target Range — aim at the floating spheres and left-click to score. 30-second round, click Restart to replay.
 // Demonstrates: a custom #class player (movement + jump + click-to-shoot with the crosshair ray),
 // user-defined funcs called cross-object, TeleportTo respawn, countdown round timer, HUD score.
 
@@ -474,6 +480,7 @@ event OnSpawned {
     secondTmr.StartCountDown(1)
     var scoreLabel = ResolveObjectByNameOnce("ScoreText")
     var midLabel = ResolveObjectByNameOnce("MidText")
+    var restartBtn = ResolveObjectByNameOnce("RestartBtn")
     forever {
         scoreLabel.SetText("Hits: " + Hits + "   Time: " + TimeLeft)
         if RoundOver {
@@ -484,13 +491,14 @@ event OnSpawned {
             TimeLeft -= 1
             if TimeLeft <= 0 {
                 RoundOver = true
-                midLabel.SetText("TIME!  Final score: " + Hits + " — press R to retry")
+                midLabel.SetText("TIME!  Final score: " + Hits)
+                restartBtn.SetVisible(true)
             }
         }
     }
 }
-event KeyboardDown[R] {
-    RestartGame()
+event ClickButton {
+    if Event.ClickedButton == ResolveObjectByNameOnce("RestartBtn") { RestartGame() }
 }
 #end
 
@@ -508,5 +516,6 @@ display manager : GameManager { visible = false }
 screenCanvas HUD {
     textLabel ScoreText { offset = (20, 20) text = "Hits: 0   Time: 30" color = (1, 1, 0.85) }
     textLabel MidText { align = (center, center) text = "" color = (0.4, 1, 0.5) }
+    button RestartBtn { anchor = (center, center) offset = (0, 70) size = (220, 52) text = "Restart" corner_radius = 8 color = #2E8B57 visible = false }
 }
 ```

package/dist/examples/coin_collector.weave

@@ -1,70 +1,73 @@
-// Coin Collector — walk into the 10 spinning coins to collect them all. Press R to replay.
-// Demonstrates: saved objects + runtime spawning, tags, proximity pickup, HUD score text,
-// win + restart flow. Movement uses the engine's default player controller (no #class player).
-
-#class Coin
-event OnPreSpawn {
-    AddTag(Tag.Coin)
-}
-event OnSpawned {
-    forever {
-        RotateLeftInstantly(4)
-        var p = NearestPlayer()
-        if p.Exists() and SurfaceGapTo(p) < 70 {
-            p.SpawnFloatingText("+1", Vector(1, 0.9, 0.2))
-            Destroy()
-        }
-    }
-}
-#end
-
-#class GameManager
-var TotalCoins = 10
-var SeenCoins = false
-event OnSpawned {
-    for i in 0..TotalCoins {
-        var pos = Position(RandomNumber(-1400, 1400), RandomNumber(-1400, 1400), 80)
-        SpawnObject(SavedObject.coin, pos)
-    }
-    var scoreLabel = ResolveObjectByNameOnce("ScoreText")
-    var midLabel = ResolveObjectByNameOnce("MidText")
-    forever {
-        // Spawned coins register their tag on the next tick, so wait until the census
-        // has seen at least one coin before treating "0 left" as a win.
-        var left = GetAllObjectsWithTag(Tag.Coin).Count()
-        var collected = TotalCoins - left
-        scoreLabel.SetText("Coins: " + collected + " / " + TotalCoins)
-        if left == 0 and collected == TotalCoins and SeenCoins {
-            midLabel.SetText("YOU WIN!  Press R to play again")
-        } else {
-            midLabel.SetText("")
-        }
-        if left > 0 {
-            SeenCoins = true
-        }
-    }
-}
-event KeyboardDown[R] {
-    RestartGame()
-}
-#end
-
-saved coin {
-    display coin : Coin { model = "cylinder" size = (60, 60, 12) rotation = (90, 0, 0) color = (1, 0.85, 0.2) }
-}
-
-object Ground {
-    model = "cube"
-    position = (0, 0, -50)
-    size = (4000, 4000, 100)
-    color = (0.32, 0.5, 0.34)
-}
-object PillarA { position = (400, 400, 150) size = (100, 100, 300) color = (0.62, 0.58, 0.52) }
-object PillarB { position = (-600, 300, 150) size = (100, 100, 300) color = (0.62, 0.58, 0.52) }
-object PillarC { position = (200, -700, 150) size = (100, 100, 300) color = (0.62, 0.58, 0.52) }
-display manager : GameManager { visible = false }
-
-screenCanvas HUD {
-    textLabel ScoreText { offset = (20, 20) text = "Coins: 0 / 10" color = (1, 1, 0.85) }
-    textLabel MidText { align = (center, center) text = "" color = (1, 1, 0.3) }
-}
+// Coin Collector — walk into the 10 spinning coins to collect them all. Click Restart to replay.
+// Demonstrates: saved objects + runtime spawning, tags, proximity pickup, HUD score text,
+// win + restart flow. Movement uses the engine's default player controller (no #class player).
+
+#class Coin
+event OnPreSpawn {
+    AddTag(Tag.Coin)
+}
+event OnSpawned {
+    forever {
+        RotateLeftInstantly(4)
+        var p = NearestPlayer()
+        if p.Exists() and SurfaceGapTo(p) < 70 {
+            p.SpawnFloatingText("+1", Vector(1, 0.9, 0.2))
+            Destroy()
+        }
+    }
+}
+#end
+
+#class GameManager
+var TotalCoins = 10
+var SeenCoins = false
+event OnSpawned {
+    for i in 0..TotalCoins {
+        var pos = Position(RandomNumber(-1400, 1400), RandomNumber(-1400, 1400), 80)
+        SpawnObject(SavedObject.coin, pos)
+    }
+    var scoreLabel = ResolveObjectByNameOnce("ScoreText")
+    var midLabel = ResolveObjectByNameOnce("MidText")
+    var restartBtn = ResolveObjectByNameOnce("RestartBtn")
+    forever {
+        // Spawned coins register their tag on the next tick, so wait until the census
+        // has seen at least one coin before treating "0 left" as a win.
+        var left = GetAllObjectsWithTag(Tag.Coin).Count()
+        var collected = TotalCoins - left
+        scoreLabel.SetText("Coins: " + collected + " / " + TotalCoins)
+        if left == 0 and collected == TotalCoins and SeenCoins {
+            midLabel.SetText("YOU WIN!")
+            restartBtn.SetVisible(true)
+        } else {
+            midLabel.SetText("")
+        }
+        if left > 0 {
+            SeenCoins = true
+        }
+    }
+}
+event ClickButton {
+    if Event.ClickedButton == ResolveObjectByNameOnce("RestartBtn") { RestartGame() }
+}
+#end
+
+saved coin {
+    display coin : Coin { model = "cylinder" size = (60, 60, 12) rotation = (90, 0, 0) color = (1, 0.85, 0.2) }
+}
+
+object Ground {
+    model = "cube"
+    position = (0, 0, -50)
+    size = (4000, 4000, 100)
+    color = (0.32, 0.5, 0.34)
+}
+object PillarA { position = (400, 400, 150) size = (100, 100, 300) color = (0.62, 0.58, 0.52) }
+object PillarB { position = (-600, 300, 150) size = (100, 100, 300) color = (0.62, 0.58, 0.52) }
+object PillarC { position = (200, -700, 150) size = (100, 100, 300) color = (0.62, 0.58, 0.52) }
+display manager : GameManager { visible = false }
+
+screenCanvas HUD {
+    textLabel ScoreText { offset = (20, 20) text = "Coins: 0 / 10" color = (1, 1, 0.85) }
+    textLabel MidText { align = (center, center) text = "" color = (1, 1, 0.3) }
+    button RestartBtn { anchor = (center, center) offset = (0, 70) size = (220, 52) text = "Restart" corner_radius = 8 color = #B98A20 visible = false }
+}

package/dist/examples/dodge_blocks.weave

@@ -1,70 +1,73 @@
-// Dodge the Falling Blocks — red cubes rain down; touching one ends the run. Press R to retry.
-// Demonstrates: a hidden manager object, timed spawning with Timer, dynamic physics objects,
-// cross-object variable writes (block -> manager), survival-seconds score, lose + restart flow.
-// Movement uses the engine's default player controller (no #class player).
-
-#class FallingBlock
-var LifeTmr : Timer
-event OnSpawned {
-    LifeTmr.StartCountDown(8) // despawn landed blocks so the arena stays playable
-    forever {
-        if LifeTmr.IsDone() {
-            Destroy()
-        }
-        var p = NearestPlayer()
-        if p.Exists() and SurfaceGapTo(p) < 5 {
-            NearestObjectWithTag(Tag.Manager).GameOver = true
-        }
-    }
-}
-#end
-
-#class GameManager
-var GameOver = false
-var Score = 0
-event OnPreSpawn {
-    AddTag(Tag.Manager)
-}
-event OnSpawned {
-    var secondTmr = Timer()
-    var dropTmr = Timer()
-    var scoreLabel = ResolveObjectByNameOnce("ScoreText")
-    var midLabel = ResolveObjectByNameOnce("MidText")
-    forever {
-        if GameOver {
-            midLabel.SetText("GAME OVER — survived " + Score + " s. Press R to retry")
-            continue
-        }
-        if secondTmr.IsDone() {
-            secondTmr.StartCountDown(1)
-            Score += 1
-            scoreLabel.SetText("Survived: " + Score + " s")
-        }
-        if dropTmr.IsDone() {
-            dropTmr.StartCountDown(0.35)
-            var pos = Position(RandomNumber(-900, 900), RandomNumber(-900, 900), 1300)
-            SpawnObject(SavedObject.block, pos)
-        }
-    }
-}
-event KeyboardDown[R] {
-    RestartGame()
-}
-#end
-
-saved block {
-    physics block : FallingBlock { model = "cube" size = (120, 120, 120) color = (0.85, 0.25, 0.2) }
-}
-
-object Ground {
-    model = "cube"
-    position = (0, 0, -50)
-    size = (2200, 2200, 100)
-    color = (0.4, 0.42, 0.5)
-}
-display manager : GameManager { visible = false }
-
-screenCanvas HUD {
-    textLabel ScoreText { offset = (20, 20) text = "Survived: 0 s" color = (1, 1, 1) }
-    textLabel MidText { align = (center, center) text = "" color = (1, 0.45, 0.35) }
-}
+// Dodge the Falling Blocks — red cubes rain down; touching one ends the run. Click Restart to retry.
+// Demonstrates: a hidden manager object, timed spawning with Timer, dynamic physics objects,
+// cross-object variable writes (block -> manager), survival-seconds score, lose + restart flow.
+// Movement uses the engine's default player controller (no #class player).
+
+#class FallingBlock
+var LifeTmr : Timer
+event OnSpawned {
+    LifeTmr.StartCountDown(8) // despawn landed blocks so the arena stays playable
+    forever {
+        if LifeTmr.IsDone() {
+            Destroy()
+        }
+        var p = NearestPlayer()
+        if p.Exists() and SurfaceGapTo(p) < 5 {
+            NearestObjectWithTag(Tag.Manager).GameOver = true
+        }
+    }
+}
+#end
+
+#class GameManager
+var GameOver = false
+var Score = 0
+event OnPreSpawn {
+    AddTag(Tag.Manager)
+}
+event OnSpawned {
+    var secondTmr = Timer()
+    var dropTmr = Timer()
+    var scoreLabel = ResolveObjectByNameOnce("ScoreText")
+    var midLabel = ResolveObjectByNameOnce("MidText")
+    var restartBtn = ResolveObjectByNameOnce("RestartBtn")
+    forever {
+        if GameOver {
+            midLabel.SetText("GAME OVER — survived " + Score + " s")
+            restartBtn.SetVisible(true)
+            continue
+        }
+        if secondTmr.IsDone() {
+            secondTmr.StartCountDown(1)
+            Score += 1
+            scoreLabel.SetText("Survived: " + Score + " s")
+        }
+        if dropTmr.IsDone() {
+            dropTmr.StartCountDown(0.35)
+            var pos = Position(RandomNumber(-900, 900), RandomNumber(-900, 900), 1300)
+            SpawnObject(SavedObject.block, pos)
+        }
+    }
+}
+event ClickButton {
+    if Event.ClickedButton == ResolveObjectByNameOnce("RestartBtn") { RestartGame() }
+}
+#end
+
+saved block {
+    physics block : FallingBlock { model = "cube" size = (120, 120, 120) color = (0.85, 0.25, 0.2) }
+}
+
+object Ground {
+    model = "cube"
+    position = (0, 0, -50)
+    size = (2200, 2200, 100)
+    color = (0.4, 0.42, 0.5)
+}
+display manager : GameManager { visible = false }
+
+screenCanvas HUD {
+    textLabel ScoreText { offset = (20, 20) text = "Survived: 0 s" color = (1, 1, 1) }
+    textLabel MidText { align = (center, center) text = "" color = (1, 0.45, 0.35) }
+    button RestartBtn { anchor = (center, center) offset = (0, 70) size = (220, 52) text = "Restart" corner_radius = 8 color = #B03A2E visible = false }
+}