@hytopia.com/examples 1.0.13 → 1.0.16

package/frontiers-rpg-game/assets/ui/scene-ui-templates/entity-nameplate.html

@@ -129,6 +129,16 @@
         else if (healthPercent > 0.33) healthBarFill.classList.add('health-medium');
         else healthBarFill.classList.add('health-low');
       }
+
+      if (state.type) {
+        // Remove any existing type classes
+        nameplate.classList.remove('boss');
+        
+        // Apply boss class if entity type is boss
+        if (state.type === 'boss') {
+          nameplate.classList.add('boss');
+        }
+      }
     });
 
     function showDamageNumber(amount, type) {
@@ -337,13 +347,7 @@
   .entity-nameplate-health-bar-fill.health-medium { background-color: #FFC107; }
   .entity-nameplate-health-bar-fill.health-low { background-color: #f44336; }
 
-  .entity-nameplate.elite .entity-nameplate-name {
-    font-size: 12px;
-    font-weight: 700;
-    background: linear-gradient(45deg, #ffd700, #ffed4e);
-    -webkit-background-clip: text;
-    -webkit-text-fill-color: transparent;
-    background-clip: text;
-    filter: drop-shadow(0 0 8px rgba(255,215,0,0.5)) drop-shadow(0 1px 3px rgba(0,0,0,0.9));
+  .entity-nameplate.boss .entity-nameplate-name {
+    color: #ef4444;
   }
 </style>

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

@@ -1,6 +1,6 @@
 import type GameRegion from './GameRegion';
 
-const CYCLE_CLOCK_INTERVAL_MS = 5000; // Update clock every 1 second
+const CYCLE_CLOCK_INTERVAL_MS = 5000; // Update clock every 5 second
 const CYCLE_CLOCK_OFFSET_HOURS = 7;
 const CYCLE_DAY_MAX_SKYBOX_INTENSITY = 1.2;
 const CYCLE_DURATION_MS = 24 * 60 * 1000; // Day/Night Cycle Every 24 minutes
@@ -49,9 +49,19 @@ export default class GameClock {
   private _updateRegionClockCycle(region: GameRegion): void {
     const world = region.world;
     
-    // Calculate sun position in circular path
+    // Calculate sun position with asymmetric day/night cycle (75% day, 25% night)
     const timeProgress = this._timeMs / CYCLE_DURATION_MS;
-    const sunAngle = timeProgress * 2 * Math.PI;
+    
+    // Create asymmetric sun angle: 75% of time for day, 25% for night
+    let sunAngle: number;
+    if (timeProgress < 0.75) {
+      // Day period: map first 75% of cycle to first half of sine wave (0 to π)
+      sunAngle = (timeProgress / 0.75) * Math.PI;
+    } else {
+      // Night period: map last 25% of cycle to second half of sine wave (π to 2π)
+      sunAngle = Math.PI + ((timeProgress - 0.75) / 0.25) * Math.PI;
+    }
+    
     const sunRadius = 300;
     const sunHeight = 100 + Math.sin(sunAngle) * 150;
     

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

@@ -7,6 +7,7 @@ import type GameRegion from './GameRegion';
 
 // Regions
 import ChitterForestRegion from './regions/chitter-forest/ChitterForestRegion';
+import HearthwildsRegion from './regions/hearthwilds/HearthwildsRegion';
 import RatkinNestRegion from './regions/ratkin-nest/RatkinNestRegion';
 import StalkhavenRegion from './regions/stalkhaven/StalkhavenRegion';
 import StalkhavenPortRegion from './regions/stalkhaven-port/StalkhavenPortRegion';
@@ -46,6 +47,11 @@ export default class GameManager {
     this._regions.set(chitterForestRegion.id, chitterForestRegion);
     GameClock.instance.addRegionClockCycle(chitterForestRegion);
 
+    // Hearthwilds
+    // const hearthwildsRegion = new HearthwildsRegion();
+    // this._regions.set(hearthwildsRegion.id, hearthwildsRegion);
+    // GameClock.instance.addRegionClockCycle(hearthwildsRegion);
+
     // Ratkin Nest
     const ratkinNestRegion = new RatkinNestRegion();
     this._regions.set(ratkinNestRegion.id, ratkinNestRegion);

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

@@ -359,6 +359,10 @@ export default class GamePlayer {
     this._spawnHeldItem();
   }
 
+  public onPlayerReconnected(): void {
+    this._loadUI();
+  }
+
   public removeEntityAlert(entityClass: typeof BaseEntity): void {
     if (!this._entityAlertClassNames.has(entityClass.name)) return;
 

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

@@ -19,8 +19,8 @@ import GamePlayerEntity from './GamePlayerEntity';
 
 const DEFAULT_MAX_AMBIENT_LIGHT_INTENSITY = 1.5;
 const DEFAULT_MAX_DIRECTIONAL_LIGHT_INTENSITY = 3.25;
-const DEFAULT_MIN_AMBIENT_LIGHT_INTENSITY = 0.4;
-const DEFAULT_MIN_DIRECTIONAL_LIGHT_INTENSITY = 0.3;
+const DEFAULT_MIN_AMBIENT_LIGHT_INTENSITY = 0.5;
+const DEFAULT_MIN_DIRECTIONAL_LIGHT_INTENSITY = 0.4;
 
 export enum GameRegionPlayerEvent {
   REACHED = 'GameRegion.REACHED',
@@ -86,6 +86,7 @@ export default class GameRegion {
     this._world.stop(); // Keep it in stopped state, when a player joins the world, we'll start it.
     this._world.on(PlayerEvent.JOINED_WORLD, ({ player }) => this.onPlayerJoin(player));
     this._world.on(PlayerEvent.LEFT_WORLD, ({ player }) => this.onPlayerLeave(player));
+    this._world.on(PlayerEvent.RECONNECTED_WORLD, ({ player }) => this.onPlayerReconnected(player));
 
     // temp
     // this._world.simulation.enableDebugRendering(true);
@@ -140,6 +141,7 @@ export default class GameRegion {
   }
 
   protected async onPlayerJoin(player: Player) {
+    console.log('onPlayerJoin', this.name);
     const gamePlayer = await GamePlayer.getOrCreate(player);
     
     // Set the current region for the player
@@ -189,4 +191,17 @@ export default class GameRegion {
       this._world.stop();
     }
   }
+
+  // The RECONNECTED_WORLD even is only emitted by the engine when the player disconnects and
+  // reconnects to the game with a known connectionId before the close connection timeout finishes
+  // which gives them 5 second window to reconnect after disconnecting. This event will fire such
+  // as if a player unintentionally refreshes the page, if their browser crashes but restarts quickly
+  // with the same connectionId in the URL, etc.
+  // The HYTOPIA SDK handles resynchronization of all persisted state back to the player client such as
+  // their entity, scene ui states, etc, but anything that uses ephemeral state (Such as UI) we need
+  // to handle reloading for them manually here.
+  protected async onPlayerReconnected(player: Player) { 
+    const gamePlayer = await GamePlayer.getOrCreate(player);
+    gamePlayer.onPlayerReconnected();
+  }
 }

package/frontiers-rpg-game/src/entities/BaseEntity.ts

@@ -56,6 +56,8 @@ export type BaseEntityItemDrop = {
   quantity?: number;
 }
 
+export type BaseEntityNameplateType = 'normal' | 'boss';
+
 export type BaseEntityOptions = {
   combatExperienceReward?: number;
   controller?: PathfindingEntityController;
@@ -75,6 +77,7 @@ export type BaseEntityOptions = {
   moveAnimationSpeed?: number;
   moveOptions?: MoveOptions;
   moveSpeed?: number;
+  nameplateType?: BaseEntityNameplateType;
   nameplateViewDistnace?: number;
   pathfindingOptions?: PathfindingOptions;
   pushable?: boolean;
@@ -103,6 +106,7 @@ export default class BaseEntity extends Entity implements IInteractable, IDamage
   private _moveOptions: MoveOptions | undefined;
   private _moveSpeed: number; 
   private _nameplateSceneUI: SceneUI;
+  private _nameplateType: BaseEntityNameplateType | undefined; 
   private _nameplateViewDistance: number | undefined;
   private _optionMap: Map<number, BaseEntityDialogueOption> = new Map();
   private _pathfindingOptions: PathfindingOptions | undefined;
@@ -135,6 +139,7 @@ export default class BaseEntity extends Entity implements IInteractable, IDamage
     this._moveOptions = options.moveOptions;
     this._moveSpeed = options.moveSpeed ?? 2;
     this._faceSpeed = options.faceSpeed ?? this._moveSpeed * 2;
+    this._nameplateType = options.nameplateType;
     this._nameplateViewDistance = options.nameplateViewDistnace;
     this._pathfindingOptions = options.pathfindingOptions;
     this._pushable = options.pushable ?? false;
@@ -367,6 +372,7 @@ export default class BaseEntity extends Entity implements IInteractable, IDamage
         interactable: this.isInteractable,
         interactActionText: this.interactActionText,
         maxHealth: this.maxHealth,
+        type: this._nameplateType,
       },
     });
   }

package/frontiers-rpg-game/src/entities/enemies/QueenWeaverEntity.ts

@@ -67,6 +67,7 @@ export default class QueenWeaverEntity extends BaseCombatEntity {
       faceSpeed: 4,
       health: 1000,
       idleAnimations: [ 'waiting' ],
+      nameplateType: 'boss',
       modelUri: 'models/enemies/weaver.gltf',
       modelScale: 1.3,
       moveAnimations: [ 'walking' ],

package/frontiers-rpg-game/src/items/BaseWeaponItem.ts

@@ -124,14 +124,14 @@ export default abstract class BaseWeaponItem extends BaseItem {
       attack.reach,
     );
 
-    if (target && !(target instanceof GamePlayerEntity)) { // change this for PVP support later.
+    if (target) {
       const damage = this.calculateDamageWithVariance(attack.damage, attack.damageVariance);
       this.dealDamage(target, damage, attackDirection, attack.knockbackForce);
     }
   }
 
   protected dealDamage(target: Entity, damage: number, knockbackDirection: Vector3Like, knockbackForce?: number): void {
-    if (!isDamageable(target)) {
+    if (!isDamageable(target) || target instanceof GamePlayerEntity) { // disabled instanceof for pvp support later.
       return;
     }
 

package/frontiers-rpg-game/src/regions/hearthwilds/HearthwildsRegion.ts

@@ -0,0 +1,25 @@
+import { Quaternion } from 'hytopia';
+import GameRegion from '../../GameRegion';
+import Spawner from '../../systems/Spawner';
+import PortalEntity from '../../entities/PortalEntity';
+import type { WanderOptions } from '../../entities/BaseEntity';
+
+import hearthwildsMap from '../../../assets/maps/hearthwilds.json';
+
+export default class HearthwildsRegion extends GameRegion {
+  public constructor() {
+    super({
+      id: 'hearthwilds',
+      name: 'Hearthwilds',
+      map: hearthwildsMap,
+      skyboxUri: 'skyboxes/partly-cloudy',
+      spawnPoint: { x: 200, y: 15, z: -75 },
+      ambientAudioUri: 'audio/music/jungle-theme-looping.mp3',
+    });
+  }
+
+  protected override setup(): void {
+    super.setup();
+
+  }
+}

package/frontiers-rpg-game/src/regions/stalkhaven/StalkhavenRegion.ts

@@ -1,7 +1,10 @@
 import { Quaternion } from 'hytopia';
 import GameRegion from '../../GameRegion';
+import Spawner from '../../systems/Spawner';
 import PortalEntity from '../../entities/PortalEntity';
+import type { WanderOptions } from '../../entities/BaseEntity';
 
+// NPCs
 import CapfolkVillagerEntity from '../../entities/npcs/CapfolkVillagerEntity';
 import CaptainSpornEntity from './npcs/CaptainSpornEntity';
 import CommanderMarkEntity from './npcs/CommanderMarkEntity';
@@ -28,6 +31,7 @@ export default class StalkhavenRegion extends GameRegion {
     super.setup();
     
     this._setupNPCs();
+    this._setupNPCSpawners();
     this._setupPortals();
   }
 
@@ -38,31 +42,38 @@ export default class StalkhavenRegion extends GameRegion {
     (new CommanderMarkEntity({ facingAngle: 180 })).spawn(this.world, { x: 3, y: 3, z: 12 });
     (new HealerMycelisEntity({ facingAngle: 180 })).spawn(this.world, { x: -13.5, y: 3, z: -30 });
     (new MerchantFinnEntity({ facingAngle: 90 })).spawn(this.world, { x: 13, y: 3, z: 26.5 });
+  }
 
-    // Wandering Villagers 
-    const villagerStartPositions = [
-      { x: -6, y: 3, z: 13 }, // town center
-      { x: 14, y: 3, z: 4 }, // town center
-      { x: -2, y: 3, z: -15 }, // town center
-      { x: 23, y: 3, z: 41 }, // well
-      { x: 26, y: 3, z: -22 }, // market
-      { x: 15, y: 3, z: -30 }, // market
-    ];
+  private _setupNPCSpawners(): void {
+    const wanderOptions: WanderOptions = {
+      idleMinMs: 5000,
+      idleMaxMs: 15000,
+      maxWanderRadius: 12,
+      moveOptions: {
+        moveCompletesWhenStuck: true,
+        moveStoppingDistance: 1,
+      }
+    }
 
-    for (const position of villagerStartPositions) {
-      const villager = new CapfolkVillagerEntity({ facingAngle: Math.random() * 360 });
-      villager.spawn(this.world, position);
-      villager.wander(villager.moveSpeed, {
-        idleMinMs: 5000,
-        idleMaxMs: 15000,
-        maxWanderRadius: 12,
-        moveOptions: {
-          moveCompletesWhenStuck: true,
-          moveStoppingDistance: 1,
+    const capfolkVillagerSpawner = new Spawner({
+      groundCheckDistance: 10,
+      maxSpawns: 10,
+      spawnables: [
+        { entityConstructor: CapfolkVillagerEntity, weight: 1, wanders: true, wanderOptions },
+      ],
+      spawnRegions: [
+        {
+          min: { x: -24, y: 2, z: -29 },
+          max: { x: 29, y: 12, z: 38 },
+          weight: 1,
         }
-      });
-    }
-  }
+      ],
+      spawnIntervalMs: 60000,
+      world: this.world,
+    });
+
+    capfolkVillagerSpawner.start(true);
+  } 
 
   private _setupPortals(): void {
     const chitterForestPortal = new PortalEntity({

package/package.json

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

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

@@ -1,140 +0,0 @@
-{
-  "health": 130,
-  "currentRegionId": "stalkhaven",
-  "skillExperience": [
-    [
-      "exploration",
-      375
-    ],
-    [
-      "agility",
-      79
-    ],
-    [
-      "combat",
-      320
-    ],
-    [
-      "foraging",
-      8
-    ]
-  ],
-  "backpack": {
-    "items": [
-      {
-        "position": 0,
-        "itemId": "common_mushroom",
-        "quantity": 3
-      },
-      {
-        "position": 1,
-        "itemId": "ratkin_tooth",
-        "quantity": 3
-      }
-    ]
-  },
-  "hotbar": {
-    "items": [
-      {
-        "position": 0,
-        "itemId": "dull_sword"
-      },
-      {
-        "position": 2,
-        "itemId": "toy_sword"
-      },
-      {
-        "position": 3,
-        "itemId": "gold",
-        "quantity": 147
-      },
-      {
-        "position": 1,
-        "itemId": "raw_hide",
-        "quantity": 2
-      },
-      {
-        "position": 4,
-        "itemId": "ratkin_eyes"
-      },
-      {
-        "position": 5,
-        "itemId": "ratkin_tail",
-        "quantity": 2
-      },
-      {
-        "position": 6,
-        "itemId": "ratkin_bones",
-        "quantity": 3
-      },
-      {
-        "position": 7,
-        "itemId": "common_seeds",
-        "quantity": 4
-      }
-    ]
-  },
-  "questLog": {
-    "quests": [
-      {
-        "questId": "welcome-to-stalkhaven",
-        "state": "completed",
-        "objectiveProgress": {
-          "talk-to-mark": 1
-        }
-      },
-      {
-        "questId": "exploring-stalkhaven",
-        "state": "completed",
-        "objectiveProgress": {
-          "talk-to-mycelis": 1,
-          "talk-to-finn": 1,
-          "talk-to-sporn": 1,
-          "talk-to-mark": 1
-        }
-      },
-      {
-        "questId": "tested-mettle",
-        "state": "completed",
-        "objectiveProgress": {
-          "kill-5-ratkin": 5,
-          "dodge-3-times": 3,
-          "talk-to-mark": 1
-        }
-      },
-      {
-        "questId": "hammers-and-crafting",
-        "state": "active",
-        "objectiveProgress": {
-          "gather-materials": 2,
-          "craft-item": 0,
-          "talk-to-arden": 0
-        }
-      },
-      {
-        "questId": "stalkhavens-outpost",
-        "state": "active",
-        "objectiveProgress": {
-          "talk-to-chanterelion": 0
-        }
-      }
-    ]
-  },
-  "storage": {
-    "items": []
-  },
-  "wearables": {
-    "items": [
-      {
-        "position": 1,
-        "itemId": "adventurer_tunic"
-      }
-    ]
-  },
-  "currentRegionSpawnFacingAngle": 0,
-  "currentRegionSpawnPoint": {
-    "x": 1,
-    "y": 2,
-    "z": 40
-  }
-}