oriverse-engine 0.1.2 → 0.1.3

package/dist/weave_documentation.txt

@@ -1,7 +1,7 @@
 
 >>>>>>>>>>>>
 Weave World Description Language Documentation
- Version:29Jul26-18:08-41702
+ Version:29Jul26-23:56-13158
 >>>>>>>>>>>>
 
 <weave_language>
@@ -264,7 +264,7 @@ event OnTuneChanged {
   - RandomNumber/RandomPosition* are deterministic (seeded per tick + calling object + call index, so repeated or cross-object same-tick calls draw fresh values); inside player input events (key/mouse/action) all Random* calls are seeded by that input edge instead, so the predicted result matches the final one. RandomChancePercent outside input events returns false during client prediction, so there use it only for delay-tolerant side effects (e.g. drops), not moment-to-moment combat.
   - Don't rely on cross-object event ordering (OnSpawned order across objects is unspecified).
 - Lobby/session APIs:
-  - AdvertiseLobbySession/ListLobbySessionsForProject/JoinLobbySession are relay lobby discovery helpers for menus; sessions match only worlds with identical content (both sides run the same saved version).
+  - AdvertiseLobbySession()/ListLobbySessions()/JoinLobbySession are relay lobby discovery for menus; identity is automatic - sessions match only peers running this project with identical content (same saved version). LobbySessionStage(i) says which stage each session is on.
   - They do NOT create gameplay replication endpoints or change sim authority; once joined, the same shared deterministic simulation model applies.
   - Lobby UI lists real joined players via GetAllPlayers(); never simulate joins with a local counter/button.
 - AI players (bots): var bot = SpawnAIPlayer("Rival") spawns a real PlayerObject: '#class player' code + OnSpawned run for it, it appears in GetAllPlayers(), has physics/animations, but no user/camera/UI. The Name arg becomes the bot's object name and its GetPlayerName().
@@ -1350,14 +1350,10 @@ SetSunColor(Color: Vector) // Default: (1, 1, 1) white
 SetSunColor(R: Number, G: Number, B: Number)
 SetFogColor(Color: Vector)
 SetFogColor(R: Number, G: Number, B: Number)
-LoadWorldFile(File: Text) // First File arg must be a direct string literal so packaging/oripak dependency scan and project game_id detection can see it.
-LoadWorldFileWithInputs(File: Text, Input1: Number, Input2: Number) // First File arg must be a direct string literal so packaging/oripak dependency scan and project game_id detection can see it.
 LoadWorldTransferClear()
 LoadWorldTransferPush(Value: Number)
 LoadWorldTransferCount() -> Number
 LoadWorldTransferGet(Index: Number) -> Number
-GetWorldInput1() -> Number
-GetWorldInput2() -> Number
 GetVignetteStrength() -> Number
 GetVignetteRadius() -> Number
 GetVignetteSoftness() -> Number
@@ -1368,15 +1364,17 @@ PersistSetNumber(Player: Object, Key: Text, Value: Number)
 PersistAddNumber(Player: Object, Key: Text, Delta: Number)
 RefreshStaticBaseline() // Call once at the end of heavy static-scene init; non-moving objects then skip per-frame display CPU (a later manipulation opts that object out).
 RestartGame()
-AdvertiseLobbySession(Project: Text) // Advertise this relay as a joinable lobby session for Project (this project/world's file name); not a gameplay replication/server-authority API.
+AdvertiseLobbySession() // Advertise this relay as a joinable lobby session for the running project; not a gameplay replication/server-authority API.
 StopAdvertisingLobbySession() // Stop advertising this relay lobby session.
-ListLobbySessionsForProject(Project: Text) // Request discoverable relay lobby sessions for Project (this project/world's file name). Sessions match by a game id hashed from world content, so only content-identical worlds are found. Results update LobbySession* getters and fire OnLobbySessionListUpdated.
+ListLobbySessions() // Request discoverable lobby sessions of the running project (identity automatic, exact content version). Results update LobbySession* getters and fire OnLobbySessionListUpdated; state 2 with 0 sessions = nobody hosts this exact version.
 JoinLobbySession(RelayPubkey: Text) // Join a discovered relay lobby session by LobbySessionRelayPubkey; deterministic shared sim still applies after joining.
-LobbySessionCount() -> Number // Number of discovered relay lobby sessions from the latest ListLobbySessionsForProject result.
+LobbySessionCount() -> Number // Number of discovered relay lobby sessions from the latest ListLobbySessions result.
 LobbySessionRelayPubkey(Index: Number) -> Text // Relay pubkey for a discovered lobby session; pass to JoinLobbySession.
 LobbySessionConnectId(Index: Number) -> Text // Debug/connect id for a discovered relay lobby session; usually not needed for gameplay code.
 LobbySessionDisplayName(Index: Number) -> Text // Human display name for a discovered relay lobby session.
-LobbySessionRefreshState() -> Number // Latest lobby-session list state: 0 idle, 1 pending, 2 ok, 3 error (reason in the desktop client log, e.g. unresolvable LoadWorldFile deps).
+LobbySessionRefreshState() -> Number // Latest list state: 0 idle, 1 pending, 2 ok, 3 error (read LobbySessionErrorText).
+LobbySessionStage(Index: Number) -> Text // #stage name a discovered session is currently on (empty for stageless projects); show or filter it in the session browser.
+LobbySessionErrorText() -> Text // Reason for state 3 (empty otherwise), e.g. relay unreachable or no loaded world.
 AnyBasicType.NearestPlayerNonSpectator() -> Object
 SetSsrRoughnessFade(StartRoughness: Number, EndRoughness: Number) // Default: 0.68, 0.7
 SetSsrRayFade(NearFadePower: Number, FarFadePower: Number) // Default: 0.08, 0.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oriverse-engine",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Prebuilt Oriverse engine bundle (WebGPU wasm + js glue) for serverless single-player games authored as one game.html with inline Weave source. Compiled engine only - contains no source code.",
   "license": "SEE LICENSE IN LICENSE.md",
   "files": [