@hytopia.com/examples 1.0.57 → 1.0.59

package/frontiers-rpg-game/dev/persistence/player-player-1.json

@@ -1 +1 @@
-{"health":1,"currentRegionId":"stalkhaven","currentRegionSpawnFacingAngle":90,"currentRegionSpawnPoint":{"x":32,"y":2,"z":1},"skillExperience":[["agility",21]],"backpack":{"items":[]},"hotbar":{"items":[{"position":0,"itemId":"toy_sword"}]},"questLog":{"quests":[]},"storage":{"items":[]},"wearables":{"items":[]},"__version":281}
+{"health":58,"currentRegionId":"stalkhaven","currentRegionSpawnFacingAngle":0,"currentRegionSpawnPoint":{"x":1,"y":2,"z":40},"skillExperience":[["agility",29]],"backpack":{"items":[]},"hotbar":{"items":[{"position":0,"itemId":"toy_sword"}]},"questLog":{"quests":[]},"storage":{"items":[]},"wearables":{"items":[]},"__version":471}

package/frontiers-rpg-game/dev/persistence/player-player-11.json

@@ -1,31 +1 @@
-{
-  "health": 100,
-  "currentRegionId": "stalkhaven",
-  "currentRegionSpawnFacingAngle": 90,
-  "currentRegionSpawnPoint": {
-    "x": 32,
-    "y": 2,
-    "z": 1
-  },
-  "skillExperience": [],
-  "backpack": {
-    "items": []
-  },
-  "hotbar": {
-    "items": [
-      {
-        "position": 0,
-        "itemId": "toy_sword"
-      }
-    ]
-  },
-  "questLog": {
-    "quests": []
-  },
-  "storage": {
-    "items": []
-  },
-  "wearables": {
-    "items": []
-  }
-}
+{"health":30,"currentRegionId":"stalkhaven","currentRegionSpawnFacingAngle":0,"currentRegionSpawnPoint":{"x":1,"y":2,"z":40},"skillExperience":[],"backpack":{"items":[]},"hotbar":{"items":[{"position":0,"itemId":"toy_sword"}]},"questLog":{"quests":[]},"storage":{"items":[]},"wearables":{"items":[]},"__version":21}

package/frontiers-rpg-game/dev/persistence/player-player-2.json

@@ -1 +1 @@
-{"health":63,"currentRegionId":"hearthwilds","currentRegionSpawnFacingAngle":90,"currentRegionSpawnPoint":{"x":249,"y":22,"z":-89},"skillExperience":[],"backpack":{"items":[]},"hotbar":{"items":[{"position":0,"itemId":"toy_sword"}]},"questLog":{"quests":[]},"storage":{"items":[]},"wearables":{"items":[]},"__version":61}
+{"health":63,"currentRegionId":"chitter-forest","currentRegionSpawnFacingAngle":120,"currentRegionSpawnPoint":{"x":145,"y":2,"z":-14},"skillExperience":[],"backpack":{"items":[]},"hotbar":{"items":[{"position":0,"itemId":"toy_sword"}]},"questLog":{"quests":[]},"storage":{"items":[]},"wearables":{"items":[]},"__version":71}

package/frontiers-rpg-game/dev/persistence/player-player-3.json

@@ -1 +1 @@
-{"__version":31,"health":100,"currentRegionId":"hearthwilds","currentRegionSpawnFacingAngle":90,"currentRegionSpawnPoint":{"x":249,"y":22,"z":-89},"skillExperience":[],"backpack":{"items":[]},"hotbar":{"items":[{"position":0,"itemId":"toy_sword"}]},"questLog":{"quests":[]},"storage":{"items":[]},"wearables":{"items":[]}}
+{"__version":61,"health":61,"currentRegionId":"chitter-forest","currentRegionSpawnFacingAngle":120,"currentRegionSpawnPoint":{"x":145,"y":2,"z":-14},"skillExperience":[],"backpack":{"items":[]},"hotbar":{"items":[{"position":0,"itemId":"toy_sword"}]},"questLog":{"quests":[]},"storage":{"items":[]},"wearables":{"items":[]}}

package/frontiers-rpg-game/dev/persistence/player-player-4.json

@@ -0,0 +1 @@
+{"__version":31,"health":85,"currentRegionId":"ratkin-nest","currentRegionSpawnFacingAngle":180,"currentRegionSpawnPoint":{"x":-31,"y":23,"z":-67},"skillExperience":[],"backpack":{"items":[]},"hotbar":{"items":[{"position":0,"itemId":"toy_sword"}]},"questLog":{"quests":[]},"storage":{"items":[]},"wearables":{"items":[]}}

package/frontiers-rpg-game/dev/persistence/player-player-42.json

@@ -0,0 +1 @@
+{"__version":11,"health":100,"currentRegionId":"stalkhaven","currentRegionSpawnFacingAngle":90,"currentRegionSpawnPoint":{"x":32,"y":2,"z":1},"skillExperience":[],"backpack":{"items":[]},"hotbar":{"items":[{"position":0,"itemId":"toy_sword"}]},"questLog":{"quests":[]},"storage":{"items":[]},"wearables":{"items":[]}}

package/frontiers-rpg-game/dev/persistence/player-player-5.json

@@ -0,0 +1 @@
+{"__version":21,"health":100,"currentRegionId":"stalkhaven-port","currentRegionSpawnFacingAngle":180,"currentRegionSpawnPoint":{"x":-6,"y":8,"z":-28},"skillExperience":[],"backpack":{"items":[]},"hotbar":{"items":[{"position":0,"itemId":"toy_sword"}]},"questLog":{"quests":[]},"storage":{"items":[]},"wearables":{"items":[]}}

package/frontiers-rpg-game/dev/persistence/player-player-56.json

@@ -0,0 +1 @@
+{"__version":11,"health":100,"currentRegionId":"stalkhaven","currentRegionSpawnFacingAngle":90,"currentRegionSpawnPoint":{"x":32,"y":2,"z":1},"skillExperience":[],"backpack":{"items":[]},"hotbar":{"items":[{"position":0,"itemId":"toy_sword"}]},"questLog":{"quests":[]},"storage":{"items":[]},"wearables":{"items":[]}}

package/frontiers-rpg-game/dev/persistence/player-player-6.json

@@ -1,31 +1 @@
-{
-  "health": 52,
-  "currentRegionId": "hearthwilds",
-  "currentRegionSpawnFacingAngle": 90,
-  "currentRegionSpawnPoint": {
-    "x": 249,
-    "y": 22,
-    "z": -89
-  },
-  "skillExperience": [],
-  "backpack": {
-    "items": []
-  },
-  "hotbar": {
-    "items": [
-      {
-        "position": 0,
-        "itemId": "toy_sword"
-      }
-    ]
-  },
-  "questLog": {
-    "quests": []
-  },
-  "storage": {
-    "items": []
-  },
-  "wearables": {
-    "items": []
-  }
-}
+{"health":52,"currentRegionId":"chitter-forest","currentRegionSpawnFacingAngle":120,"currentRegionSpawnPoint":{"x":145,"y":2,"z":-14},"skillExperience":[],"backpack":{"items":[]},"hotbar":{"items":[{"position":0,"itemId":"toy_sword"}]},"questLog":{"quests":[]},"storage":{"items":[]},"wearables":{"items":[]},"__version":11}

package/frontiers-rpg-game/dev/persistence/player-player-9.json

@@ -1,31 +1 @@
-{
-  "health": 100,
-  "currentRegionId": "stalkhaven",
-  "currentRegionSpawnFacingAngle": 90,
-  "currentRegionSpawnPoint": {
-    "x": 32,
-    "y": 2,
-    "z": 1
-  },
-  "skillExperience": [],
-  "backpack": {
-    "items": []
-  },
-  "hotbar": {
-    "items": [
-      {
-        "position": 0,
-        "itemId": "toy_sword"
-      }
-    ]
-  },
-  "questLog": {
-    "quests": []
-  },
-  "storage": {
-    "items": []
-  },
-  "wearables": {
-    "items": []
-  }
-}
+{"health":100,"currentRegionId":"stalkhaven-port","currentRegionSpawnFacingAngle":180,"currentRegionSpawnPoint":{"x":-6,"y":8,"z":-28},"skillExperience":[],"backpack":{"items":[]},"hotbar":{"items":[{"position":0,"itemId":"toy_sword"}]},"questLog":{"quests":[]},"storage":{"items":[]},"wearables":{"items":[]},"__version":11}

package/frontiers-rpg-game/src/GamePlayer.ts

@@ -329,7 +329,11 @@ export default class GamePlayer {
     this.setCurrentRegion(region);
     this.setCurrentRegionSpawnFacingAngle(facingAngle);
     this.setCurrentRegionSpawnPoint(spawnPoint);              
-    this.save();
+    // IMPORTANT:
+    // World switching triggers PLAYER.LEFT_WORLD and our GameRegion handler currently drops the in-memory
+    // GamePlayer instance. The destination world then reconstructs GamePlayer from persisted data.
+    // If we debounce saves here, the persisted spawn point can be stale, causing "random" teleports.
+    this.flushSave();
     this.player.joinWorld(region.world);
   }
 
@@ -437,6 +441,17 @@ export default class GamePlayer {
     }, 500);
   }
 
+  /**
+   * Immediately persists player state, bypassing the debounce used by {@link save}.
+   *
+   * This is critical before operations that might recreate the player state
+   * (e.g. switching worlds/regions) to prevent stale region spawn data.
+   */
+  public flushSave(): void {
+    clearTimeout(this._saveTimeout);
+    this.player.setPersistedData(this._serialize());
+  }
+
   public showNotification(message: string, notificationType: NotificationType): void {
     this.player.ui.sendData({
       type: 'showNotification',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hytopia.com/examples",
-  "version": "1.0.57",
+  "version": "1.0.59",
   "description": "",
   "license": "ISC",
   "author": "",

package/tutorial-arrows/README.md

@@ -0,0 +1,3 @@
+# tutorial arrows
+
+A simple demonstration of using UI helpers to create per-player tutorial arrows.