npm - oriverse-engine - Versions diffs - 0.1.1 - Mend

oriverse-engine 0.1.1

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 (26) hide show

package/LICENSE.md +30 -0
package/README.md +76 -0
package/dist/AGENT_ONBOARDING.md +74 -0
package/dist/CODEX_PROMPT.md +108 -0
package/dist/GAME_AUTHORING.md +512 -0
package/dist/examples/coin_collector.weave +70 -0
package/dist/examples/dodge_blocks.weave +70 -0
package/dist/examples/target_range.weave +82 -0
package/dist/ktx_bridge.js +121 -0
package/dist/ktx_lib.js +5236 -0
package/dist/ktx_lib.wasm +0 -0
package/dist/oriverse_wgpu.d.ts +174 -0
package/dist/oriverse_wgpu.js +3361 -0
package/dist/oriverse_wgpu_bg.wasm +0 -0
package/dist/oriverse_wgpu_bg.wasm.d.ts +73 -0
package/dist/snippets/oriverse_market_client-0cd3013288f3c49c/inline0.js +30 -0
package/dist/snippets/oriverse_networking_shared-e43478064e11e46c/inline0.js +18 -0
package/dist/snippets/oriverse_wgpu-255445ce6d9a0851/inline0.js +60 -0
package/dist/snippets/oriverse_wgpu-255445ce6d9a0851/inline1.js +21 -0
package/dist/starter/AGENTS.md +32 -0
package/dist/starter/CLAUDE.md +32 -0
package/dist/starter/game.html +64 -0
package/dist/templates/game.html +63 -0
package/dist/templates/game_cdn.html +64 -0
package/dist/weave_documentation.txt +6258 -0
package/package.json +18 -0

package/LICENSE.md ADDED Viewed

@@ -0,0 +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.

package/README.md ADDED Viewed

@@ -0,0 +1,76 @@
+# oriverse-engine
+Prebuilt **Oriverse engine** bundle for serverless single-player games: a WebGPU
+wasm engine you use three.js-style from a CDN, with your whole game authored as
+**one `game.html`** containing inline [Weave](https://oriverse.io) source.
+This package is the **compiled engine bundle only** (js glue + wasm + KTX texture
+transcoder + docs). It contains no engine source code and has zero npm dependencies.
+Everything runs client-side: no server, no SharedArrayBuffer, no workers, no
+COOP/COEP headers, no network calls after the engine files load.
+## Quickstart (script-tag flow)
+Create a single `game.html`:
+```html
+<!DOCTYPE html>
+<html lang="en">
+<head><meta charset="UTF-8"><title>my game</title>
+<style>html, body { margin: 0; background: #141313; }</style></head>
+<body>
+  <!-- Your game: inline Weave world source (procedural content only) -->
+  <script type="text/weave" id="oriverse-weave">
+object Ground { model = "cube" position = (0, 0, -50) size = (4000, 4000, 100) color = (0.35, 0.47, 0.35) }
+object Box { model = "cube" position = (0, 300, 100) size = (100, 100, 100) color = (0.86, 0.47, 0.23) }
+  </script>
+  <!-- Pinned engine version: bump @0.1.1 together on new releases -->
+  <script src="https://unpkg.com/oriverse-engine@0.1.1/dist/ktx_lib.js"></script>
+  <script src="https://unpkg.com/oriverse-engine@0.1.1/dist/ktx_bridge.js"></script>
+  <script type="module">
+    import initOriverse from "https://unpkg.com/oriverse-engine@0.1.1/dist/oriverse_wgpu.js";
+    await initOriverse({ module_or_path: "https://unpkg.com/oriverse-engine@0.1.1/dist/oriverse_wgpu_bg.wasm" });
+  </script>
+</body>
+</html>
+```
+Serve it with any static file server (`python -m http.server`) or any host — no
+special headers needed — and open it in a WebGPU-capable browser (Chrome/Edge).
+A ready-made version of this file with error reporting is at
+`dist/templates/game_cdn.html`; a fully offline variant (engine files served
+next to the html) is `dist/templates/game.html`.
+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.1/dist/oriverse_wgpu.js";
+await initOriverse({ module_or_path: "https://unpkg.com/oriverse-engine@0.1.1/dist/oriverse_wgpu_bg.wasm" });
+await bootOriverseArtifact(weaveSource);
+```
+## Starter folder (for AI coding agents)
+`dist/starter/` is a drop-in project folder: a wired-up `game.html` plus `AGENTS.md` /
+`CLAUDE.md` instructions that Codex and Claude Code read automatically. Copy it,
+point an agent at it, and say "make a game".
+## Authoring
+- Game authoring guide with 3 complete engine-tested example games:
+  `dist/GAME_AUTHORING.md` (examples also as raw Weave under `dist/examples/`).
+- The game boots straight into play mode; WASD + mouse move the player
+  (override by defining your own `#class player`).
+- 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.1/dist/weave_documentation.txt`).
+- Package/runtime onboarding: `dist/AGENT_ONBOARDING.md`.
+- Copy-paste prompt for AI coding agents: `dist/CODEX_PROMPT.md`.
+## License
+Proprietary; royalty-free use and unmodified redistribution permitted.
+See `LICENSE.md`.

package/dist/AGENT_ONBOARDING.md ADDED Viewed

@@ -0,0 +1,74 @@
+# Oriverse artifact package — agent onboarding
+This folder is a self-contained, offline, single-player build of the Oriverse engine.
+It runs without SharedArrayBuffer, web workers, or any network access, so it can be
+served by any dumb static file server — no COOP/COEP headers needed.
+## Quick start
+1. Serve this folder:
+```bash
+python -m http.server 8000
+```
+2. Open `http://localhost:8000/game.html` in a WebGPU-capable browser (Chrome/Edge,
+   or iOS Safari with the WebGPU feature flag enabled).
+No server at all: `oriverse_single_game.html` is the same engine + world in ONE
+self-contained file (wasm embedded as base64, zero fetches) — double-click it to run
+via `file://` (a secure context in Chrome, so WebGPU works there too).
+## Authoring a game
+Edit `game.html` and replace the Weave source inside:
+```html
+<script type="text/weave" id="oriverse-weave"> ...your world... </script>
+```
+(Alternatives: set `window.ORIVERSE_ARTIFACT_WEAVE` to a string before the module
+script runs, or omit the tag entirely and call the typed export
+`bootOriverseArtifact(weaveSource)` once after `initOriverse(...)` resolves — with no
+inline Weave present the engine waits for that call instead of auto-booting.)
+For game-making patterns and three complete engine-tested example games, read
+`GAME_AUTHORING.md` (npm package `dist/`; examples also under `dist/examples/`).
+Rules for artifact worlds:
+- Content must be fully procedural. Allowed: primitive models (`"cube"`, `"sphere"`, ...),
+  `#mesh` clauses (procedural mesh DSL), `#texture` clauses (procedural texture DSL,
+  `baked.*` urls), `#particles` clauses, and triplanar materials.
+- `color = (r, g, b)` channels are 0-1 floats (or `#RRGGBB` hex). Values above 1 clamp
+  to 1.0 per channel, so 0-255 style colors silently render as untinted white.
+- The game boots directly into play mode (no editor). WASD moves the player: if your
+  world has no `#class player ... #end` block, the engine injects the default
+  third-person controller (camera-relative move + Space jump). Define `#class player`
+  yourself to override movement/camera (see `weave_documentation.txt`).
+- Market assets (`Ori.model.*`, `Ori.image.*`, fonts from the network, ...) are NOT
+  available. Any runtime HTTP request hard-errors with `[artifact][zero-fetch]`.
+- The world is built once at boot from the inline Weave; a load error is fatal and shows
+  in the status banner / browser console.
+The Weave language reference is in `weave_documentation.txt` in this folder.
+## Package contents
+- `game.html` — template page with inline Weave (this is the file you author). The default
+  world is injected from `default_world.weave` at packaging time and compile-tested natively.
+- `oriverse_single_game.html` — single-file variant of the same game (edit the same
+  `#oriverse-weave` block inside it); runs from `file://` or any static server.
+- `oriverse_wgpu.js` / `oriverse_wgpu_bg.wasm` — engine glue + wasm (single-threaded,
+  non-shared memory).
+- `ktx_lib.js` / `ktx_lib.wasm` / `ktx_bridge.js` — KTX2 texture transcoder sidecar
+  (loaded as classic scripts; the one non-module exception).
+- `weave_documentation.txt` — Weave language + API reference.
+## How it works (for the curious)
+The engine runs its normal deterministic client simulation, but instead of a network
+relay it talks to an in-process loopback relay: your inputs are packed into real relay
+wire packets, merged one frame per tick, and fed back through the production frame
+reader. The whole sim runs on the browser main thread (fixed-step accumulator inside
+requestAnimationFrame, with a small catch-up cap).

package/dist/CODEX_PROMPT.md ADDED Viewed

@@ -0,0 +1,108 @@
+# Make a game with Oriverse — prompt for AI coding agents
+Paste everything below the line into an AI coding agent (Codex / Claude Code / Cursor)
+to have it author an Oriverse game as a single `game.html`. Everything the agent needs
+is inline — it works even if the agent has no network access beyond serving the file.
+---
+Create a playable 3D game as a single `game.html` built on the Oriverse engine
+(WebGPU wasm, loaded from a CDN — nothing to download or bundle).
+## Step 1: copy this file EXACTLY as your `game.html`
+Copy the entire HTML below verbatim. ONLY edit the contents of the
+`<script type="text/weave" id="oriverse-weave">` block — that Weave block IS the game
+(world + logic). Do not touch the loader scripts, the URLs, or anything else.
+```html
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover">
+  <title>oriverse game</title>
+  <link rel="icon" href="data:image/svg+xml,%3Csvg%20xmlns='http://www.w3.org/2000/svg'%20viewBox='0%200%2016%2016'%3E%3Crect%20width='16'%20height='16'%20rx='3'%20fill='%23453a6b'/%3E%3C/svg%3E">
+  <style>
+    html, body { margin: 0; padding: 0; background-color: rgb(20, 19, 19); }
+  </style>
+</head>
+<body>
+  <div id="oriverse-status-banner" style="position:fixed;left:0;right:0;top:0;z-index:9999;background:rgba(0,0,0,0.85);color:#fff;font-family:system-ui,sans-serif;font-size:14px;line-height:1.4;padding:10px 12px;white-space:pre-wrap;pointer-events:none;">Oriverse: fetching engine from CDN...</div>
+  <!-- ==== EDIT ONLY THIS BLOCK: your game, as inline Weave source. ==== -->
+  <script type="text/weave" id="oriverse-weave">
+object Ground {
+    model = "cube"
+    position = (0, 0, -50)
+    size = (4000, 4000, 100)
+    color = (0.35, 0.47, 0.35)
+}
+object OrangeCube {
+    model = "cube"
+    position = (0, 300, 100)
+    size = (100, 100, 100)
+    color = (0.86, 0.47, 0.23)
+}
+object BlueCube {
+    model = "cube"
+    position = (300, 600, 60)
+    size = (120, 120, 120)
+    color = (0.31, 0.51, 0.86)
+}
+  </script>
+  <!-- ==== END OF EDITABLE BLOCK ==== -->
+  <script src="https://unpkg.com/oriverse-engine@0.1.1/dist/ktx_lib.js"></script>
+  <script src="https://unpkg.com/oriverse-engine@0.1.1/dist/ktx_bridge.js"></script>
+  <script type="module">
+    import initOriverse from "https://unpkg.com/oriverse-engine@0.1.1/dist/oriverse_wgpu.js";
+    const setBoot = (t) => { const b = document.getElementById('oriverse-status-banner'); if (b) b.textContent = t; };
+    (async () => {
+      try {
+        setBoot('instantiating wasm...');
+        await initOriverse({ module_or_path: "https://unpkg.com/oriverse-engine@0.1.1/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);
+      }
+    })();
+  </script>
+</body>
+</html>
+```
+The engine auto-boots from the `#oriverse-weave` tag. (Programmatic alternative: remove
+the tag and call `bootOriverseArtifact(weaveSource)` — exported by `oriverse_wgpu.js` —
+once after `initOriverse(...)` resolves.)
+## Step 2: write the Weave game (replace the demo world in the block)
+Rules — the engine hard-errors if you break the first two:
+- ALL content must be procedural. Allowed models: `"cube"`, `"sphere"`, `"cylinder"`,
+  `"capsule"`, `"cone"`, `"wedge"`, plus `#mesh` clauses (procedural mesh DSL) and
+  `#texture` clauses (procedural material DSL). Market/network assets (`Ori.model.*`,
+  image/sound URLs, ...) are NOT available.
+- No network access at runtime: no fetches, no external files, everything inline.
+- Units: 1 unit = 1 cm, Z is up. Player is 180 cm tall. Base cube is 100x100x100 at
+  bottom-center pivot (an object at z=0 stands on the ground).
+- `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.
+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://unpkg.com/oriverse-engine@0.1.1/dist/GAME_AUTHORING.md  <- game patterns + 3 full example games
+- https://unpkg.com/oriverse-engine@0.1.1/dist/weave_documentation.txt  <- full language + API reference
+- https://unpkg.com/oriverse-engine@0.1.1/dist/examples/coin_collector.weave (also dodge_blocks / target_range)
+## Step 3: test
+Serve the folder containing `game.html` with any static server
+(`python -m http.server 8000`) and open it in a WebGPU browser (Chrome/Edge). Boot
+errors appear in the status banner and the browser console. Weave load errors are shown
+with line numbers; fix and reload.