@hytopia.com/examples 1.0.3 → 1.0.5

package/frontiers-rpg-game/src/regions/stalkhaven/npcs/HealerMycelisEntity.ts

@@ -0,0 +1,161 @@
+import BaseEntity, { BaseEntityOptions } from '../../../entities/BaseEntity';
+
+export default class HealerMycelisEntity extends BaseEntity {
+  public constructor(options?: BaseEntityOptions) {
+    super({
+      idleAnimations: [ 'idle' ],
+      modelUri: 'models/npcs/mushroom-elder.gltf',
+      modelScale: 0.55,
+      name: 'Healer Mycelis',
+      dialogue: {
+        avatarImageUri: 'avatars/capfolk-elder.png',
+        title: 'Capfolk Elder',
+        dialogue: {
+          text: `Greetings, traveler. I am Mycelis, a healer who fled the fog. My spores can mend your wounds if you need aid.`,
+          options: [
+            {
+              text: `Heal me, please.`,
+              onSelect: (interactor) => {
+                interactor.adjustHealth(interactor.maxHealth);
+              },
+              nextDialogue: {
+                text: `Of course, child. Breathe deeply as my healing spores mend your wounds and restore your strength. There... you should feel much better now.`,
+                options: [
+                  {
+                    text: `Thank you for the healing.`,
+                    dismiss: true,
+                    pureExit: true,
+                  },
+                ]
+              }
+            },
+            {
+              text: `Tell me about your journey here.`,
+              nextDialogue: {
+                text: `I fled Sporewick when the fog consumed my village. Watched my people transform into twisted creatures. Barely escaped alive.`,
+                options: [
+                  {
+                    text: `What happened when the fog arrived?`,
+                    nextDialogue: {
+                      text: `Came at dawn like a living thing. Our mushroom circles glowed with sickly light. My people breathed corrupted spores and... changed.`,
+                      options: [
+                        {
+                          text: `How did you escape?`,
+                          nextDialogue: {
+                            text: `Sealed myself in the healing chambers for three days. The ventilation kept pure air flowing. Then I fled with what I could carry.`,
+                            options: [
+                              {
+                                text: `You're brave to have survived.`,
+                                dismiss: true,
+                                pureExit: true,
+                              },
+                            ]
+                          }
+                        },
+                        {
+                          text: `Any other survivors?`,
+                          nextDialogue: {
+                            text: `Two others made it out from Sporewick. They're at a refugee camp beyond the eastern hills. The fog claimed most in minutes.`,
+                            options: [
+                              {
+                                text: `Maybe you can rebuild someday.`,
+                                dismiss: true,
+                                pureExit: true,
+                              },
+                            ]
+                          }
+                        },
+                      ]
+                    }
+                  },
+                  {
+                    text: `What was Sporewick like before?`,
+                    nextDialogue: {
+                      text: `Underground chambers filled with glowing fungi. We cultivated healing spores for The Frontier. It was beautiful... now it's gone.`,
+                      options: [
+                        {
+                          text: `Your knowledge lives on.`,
+                          dismiss: true,
+                          pureExit: true,
+                        },
+                      ]
+                    }
+                  },
+                ]
+              }
+            },
+            {
+              text: `Tell me about The Frontier's history.`,
+              nextDialogue: {
+                text: `Once untamed wilderness, we built a network of settlements over centuries. Humans, Capfolk, Ratkin - all cooperating peacefully.`,
+                options: [
+                  {
+                    text: `What made it special?`,
+                    nextDialogue: {
+                      text: `Each settlement specialized - Stalkhaven for trade, Sporewick for healing. Three centuries of prosperity until the fog destroyed it all.`,
+                      options: [
+                        {
+                          text: `Can it be rebuilt?`,
+                          nextDialogue: {
+                            text: `Maybe, if we stop the fog. But it'll take generations to restore what was lost.`,
+                            options: [
+                              {
+                                text: `At least some remember.`,
+                                dismiss: true,
+                                pureExit: true,
+                              },
+                            ]
+                          }
+                        },
+                        {
+                          text: `What about before the settlements?`,
+                          nextDialogue: {
+                            text: `Ancient peoples left stone circles and burial mounds. Maybe they faced something like this fog before.`,
+                            options: [
+                              {
+                                text: `That could be important.`,
+                                dismiss: true,
+                                pureExit: true,
+                              },
+                            ]
+                          }
+                        },
+                      ]
+                    }
+                  },
+                  {
+                    text: `Were there always monsters?`,
+                    nextDialogue: {
+                      text: `Some, but they kept to deep forests. Most creatures were peaceful - even Ratkin were traders. The fog corrupted everything.`,
+                      options: [
+                        {
+                          text: `We need to find its source.`,
+                          dismiss: true,
+                          pureExit: true,
+                        },
+                      ]
+                    }
+                  },
+                ]
+              }
+            },
+            {
+              text: `I should continue on my journey.`,
+              nextDialogue: {
+                text: `Travel safely, friend. Carry pure water and breathe through cloth in fog-touched lands. Stay vigilant.`,
+                options: [
+                  {
+                    text: `Thank you for the advice.`,
+                    dismiss: true,
+                    pureExit: true,
+                  },
+                ]
+              }
+            },
+          ],
+        }
+      },
+      ...options,
+    });
+  }
+}

package/frontiers-rpg-game/src/regions/stalkhaven/npcs/MerchantFinnEntity.ts

@@ -0,0 +1,38 @@
+import BaseMerchantEntity, { BaseMerchantEntityOptions } from '../../../entities/BaseMerchantEntity';
+
+import AdventurerBootsItem from '../../../items/wearables/AdventurerBootsItem';
+import AdventurerGlovesItem from '../../../items/wearables/AdventurerGlovesItem';
+import AdventurerHoodItem from '../../../items/wearables/AdventurerHoodItem';
+import AdventurerLeggingsItem from '../../../items/wearables/AdventurerLeggingsItem';
+import AdventurerTunicItem from '../../../items/wearables/AdventurerTunicItem';
+import DullSwordItem from '../../../items/weapons/DullSwordItem';
+import CommonMushroomItem from '../../../items/consumables/CommonMushroomItem';
+import IronDaggerItem from '../../../items/weapons/IronDaggerItem';
+import IronLongSwordItem from '../../../items/weapons/IronLongSwordItem';
+import MinorHealingPotionItem from '../../../items/consumables/MinorHealingPotionItem';
+
+export default class MerchantFinnEntity extends BaseMerchantEntity {
+  public constructor(options?: Partial<BaseMerchantEntityOptions>) {
+    super({
+      buyableItemClasses: [
+        AdventurerHoodItem,
+        AdventurerTunicItem,
+        AdventurerGlovesItem,
+        AdventurerLeggingsItem,
+        AdventurerBootsItem,
+        DullSwordItem,
+        IronDaggerItem,
+        IronLongSwordItem,
+        MinorHealingPotionItem,
+        CommonMushroomItem,
+      ],
+      dialogueAvatarImageUri: 'avatars/merchant.png',
+      dialogueTitle: 'Goods Vendor',
+      idleAnimations: [ 'idle' ],
+      modelUri: 'models/npcs/merchant.gltf',
+      modelScale: 0.75,
+      name: 'Merchant Finn',
+      ...options,
+    });
+  }
+}

package/frontiers-rpg-game/src/regions/stalkhaven-port/StalkhavenPortRegion.ts

@@ -0,0 +1,42 @@
+import GameRegion from '../../GameRegion';
+import PortalEntity from '../../entities/PortalEntity';
+
+import BoatRepairmanSidEntity from './npcs/BoatRepairmanSidEntity';
+import PirateCaptainShroudEntity from './npcs/PirateCaptainShroudEntity';
+
+import stalkhavenPortMap from '../../../assets/maps/stalkhaven-port.json';
+
+export default class StalkhavenRegion extends GameRegion {
+  public constructor() {
+    super({
+      id: 'stalkhaven-port',
+      name: 'Stalkhaven Port',
+      map: stalkhavenPortMap,
+      skyboxUri: 'skyboxes/partly-cloudy',
+      spawnPoint: { x: -5, y: 8, z: 11 },
+      ambientAudioUri: 'audio/music/hytopia-main-theme.mp3',
+    });
+  }
+
+  protected override setup(): void {
+    super.setup();
+
+    this._setupNPCs();
+    this._setupPortals();
+  }
+
+  private _setupNPCs(): void {
+    (new BoatRepairmanSidEntity({ facingAngle: 155 })).spawn(this.world, { x: 2.5, y: 8, z: 3 });
+    (new PirateCaptainShroudEntity({ facingAngle: 270 })).spawn(this.world, { x: -8.5, y: 8, z: 10.5 });
+  }
+
+  private _setupPortals(): void {
+    const stalkhavenPortal = new PortalEntity({
+      destinationRegionId: 'stalkhaven',
+      destinationRegionPosition: { x: 32, y: 2, z: 1 },
+      destinationRegionFacingAngle: 90,
+      modelScale: 2,
+    });
+    stalkhavenPortal.spawn(this.world, { x: -6, y: 9.5, z: -31 });
+  }
+}

package/frontiers-rpg-game/src/regions/stalkhaven-port/npcs/BoatRepairmanSidEntity.ts

@@ -0,0 +1,90 @@
+import BaseEntity, { BaseEntityOptions } from '../../../entities/BaseEntity';
+
+export default class BoatRepairmanSidEntity extends BaseEntity {
+  public constructor(options?: BaseEntityOptions) {
+    super({
+      idleAnimations: [ 'idle' ],
+      modelUri: 'models/npcs/mechanic.gltf',
+      modelScale: 0.75,
+      name: 'Sid',
+      dialogue: {
+        avatarImageUri: 'avatars/mechanic.png',
+        title: 'Boat Repairman',
+        dialogue: {
+          text: `Welcome to Stalkhaven Port, brave soul! You picked a hell of a time to visit The Frontier. Takes real guts to sail here with those pirates - they're the only ones still making the crossing since the fog hit.`,
+          options: [
+            {
+              text: `What's this fog everyone mentions?`,
+              nextDialogue: {
+                text: `Appeared two months back, turning everything it touches into monsters. Corrupted the seas, the forests, even peaceful folk. Most settlements are gone.`,
+                options: [
+                  {
+                    text: `Where should I go to learn more?`,
+                    nextDialogue: {
+                      text: `Head into town and find Commander Mark - he'll give you the full picture. Just follow the main road up from the docks.`,
+                      options: [
+                        {
+                          text: `Thanks for the directions.`,
+                          dismiss: true,
+                          pureExit: true,
+                        },
+                      ]
+                    }
+                  },
+                  {
+                    text: `Is anywhere safe?`,
+                    nextDialogue: {
+                      text: `Stalkhaven's holding strong for now. Good walls, good people. But the fog's always creeping closer.`,
+                      options: [
+                        {
+                          text: `I'll help however I can.`,
+                          dismiss: true,
+                          pureExit: true,
+                        },
+                      ]
+                    }
+                  },
+                ]
+              }
+            },
+            {
+              text: `Why are only pirates still sailing?`,
+              nextDialogue: {
+                text: `Sea monsters patrol these waters now - twisted things with too many teeth. Regular merchants won't risk it, but pirates? They're crazy enough to try anything for coin.`,
+                options: [
+                  {
+                    text: `Glad they brought me here safely.`,
+                    nextDialogue: {
+                      text: `Count yourself lucky. Half the ships that attempt the crossing don't make it back. Now get into town before dark - Commander Mark can tell you more.`,
+                      options: [
+                        {
+                          text: `I'll head there now.`,
+                          dismiss: true,
+                          pureExit: true,
+                        },
+                      ]
+                    }
+                  },
+                ]
+              }
+            },
+            {
+              text: `I need to get into town.`,
+              nextDialogue: {
+                text: `Smart thinking. Follow the main road straight up from here - can't miss it. Find Commander Mark at the garrison, he'll catch you up on everything.`,
+                options: [
+                  {
+                    text: `Thanks, I'll find him.`,
+                    dismiss: true,
+                    pureExit: true,
+                  },
+                ]
+              }
+            },
+          ],
+        }
+      },
+      ...options,
+    });
+  }
+}

package/frontiers-rpg-game/src/regions/stalkhaven-port/npcs/PirateCaptainShroudEntity.ts

@@ -0,0 +1,74 @@
+import BaseEntity, { BaseEntityOptions } from '../../../entities/BaseEntity';
+
+export default class PirateCaptainShroudEntity extends BaseEntity {
+  public constructor(options?: BaseEntityOptions) {
+    super({
+      idleAnimations: [ 'idle' ],
+      modelUri: 'models/npcs/hunter.gltf',
+      modelScale: 0.75,
+      name: 'Captain Shroud',
+      dialogue: {
+        avatarImageUri: 'avatars/hunter.png',
+        title: 'Pirate Captain',
+        dialogue: {
+          text: `Arr, we made it through them cursed waters! Lucky for ye, my crew knows these seas better than any. The fog-twisted beasts gave us a proper fight, but here ye be - safe in Stalkhaven Port.`,
+          options: [
+            {
+              text: `That was quite the journey.`,
+              nextDialogue: {
+                text: `Aye, rougher than usual. Sea monsters getting bolder every week. Most captains won't even try the crossing anymore - but not Captain Shroud!`,
+                options: [
+                  {
+                    text: `Will you be sailing anywhere else?`,
+                    nextDialogue: {
+                      text: `Wherever the coin flows, mate! Bring me enough gold and I'll sail ye to the ends of the earth. Just find me at the docks when ye need passage.`,
+                      options: [
+                        {
+                          text: `I'll remember that.`,
+                          dismiss: true,
+                          pureExit: true,
+                        },
+                      ]
+                    }
+                  },
+                  {
+                    text: `Thanks for getting me here safely.`,
+                    dismiss: true,
+                    pureExit: true,
+                  },
+                ]
+              }
+            },
+            {
+              text: `How much for future voyages?`,
+              nextDialogue: {
+                text: `Depends where ye want to go, savvy? More dangerous the waters, higher the price. But I guarantee safe passage - Captain Shroud's never lost a paying customer!`,
+                options: [
+                  {
+                    text: `I'll keep you in mind.`,
+                    dismiss: true,
+                    pureExit: true,
+                  },
+                ]
+              }
+            },
+            {
+              text: `I need to get going.`,
+              nextDialogue: {
+                text: `Off with ye then! Explore this cursed frontier, but remember - when ye need real passage across dangerous waters, Captain Shroud's yer man!`,
+                options: [
+                  {
+                    text: `Fair winds, Captain.`,
+                    dismiss: true,
+                    pureExit: true,
+                  },
+                ]
+              }
+            },
+          ],
+        }
+      },
+      ...options,
+    });
+  }
+}

package/frontiers-rpg-game/src/regions/weavers-hollow/WeaversHollowRegion.ts

@@ -0,0 +1,41 @@
+import GameRegion from '../../GameRegion';
+import Spawner from '../../systems/Spawner';
+import PortalEntity from '../../entities/PortalEntity';
+import type { WanderOptions } from '../../entities/BaseEntity';
+
+import weaversHollowMap from '../../../assets/maps/weavers-hollow.json';
+
+import SpiderWebEntity from '../../entities/environmental/SpiderWebEntity';
+
+export default class WeaversHollowRegion extends GameRegion {
+  public constructor() {
+    super({
+      id: 'weavers-hollow',
+      name: `Weaver's Hollow`,
+      map: weaversHollowMap,
+      maxAmbientLightIntensity: 0.075,
+      maxDirectionalLightIntensity: 0.4,
+      minAmbientLightIntensity: 0.055,
+      minDirectionalLightIntensity: 0.2,
+      skyboxUri: 'skyboxes/black',
+      spawnPoint: { x: 10, y: 2, z: 13 },
+      ambientAudioUri: 'audio/music/cave-theme-looping.mp3',
+    });
+  }
+
+  protected override setup(): void {
+    super.setup();
+
+    this._setupEnemySpawners();
+    this._setupPortals();
+  }
+
+  private _setupEnemySpawners(): void {
+    const spiderWeb = new SpiderWebEntity();
+    spiderWeb.spawn(this.world, { x: 6, y: 5, z: 8 });
+  }
+
+  private _setupPortals(): void {
+    
+  }
+}

package/frontiers-rpg-game/src/systems/Backpack.ts

@@ -0,0 +1,20 @@
+import { Player } from 'hytopia';
+import BaseItem from '../items/BaseItem';
+import ItemInventory from './ItemInventory';
+import type GamePlayer from '../GamePlayer';
+
+const BACKPACK_SIZE = 21;
+const BACKPACK_GRID_WIDTH = 7;
+
+export default class Backpack extends ItemInventory {
+  private _owner: GamePlayer;
+
+  public constructor(owner: GamePlayer) {
+    super(BACKPACK_SIZE, BACKPACK_GRID_WIDTH, 'backpack');
+    this._owner = owner;
+  }
+
+  protected override onSlotChanged(position: number, item: BaseItem | null): void {
+    this.syncUIUpdate(this._owner.player, position, item);
+  }
+}

package/frontiers-rpg-game/src/systems/Hotbar.ts

@@ -0,0 +1,96 @@
+import { Player } from 'hytopia';
+import BaseItem from '../items/BaseItem';
+import ItemInventory from './ItemInventory';
+import type GamePlayer from '../GamePlayer';
+
+const HOTBAR_SIZE = 8;
+
+export default class Hotbar extends ItemInventory {
+  public onSelectedItemChanged: (selectedItem: BaseItem | null, lastItem: BaseItem | null) => void = () => {};
+  private _owner: GamePlayer;
+  private _selectedIndex: number = 0;
+
+  public constructor(owner: GamePlayer) {
+    super(HOTBAR_SIZE, HOTBAR_SIZE, 'hotbar');
+    this._owner = owner;
+  }
+
+  public get selectedIndex(): number { return this._selectedIndex; }
+  public get selectedItem(): BaseItem | null { return this.getItemAt(this._selectedIndex); }
+
+  public setSelectedIndex(index: number): boolean {
+    if (index < 0 || index >= HOTBAR_SIZE) {
+      return false;
+    }
+
+    if (this._selectedIndex === index) {
+      return true;
+    }
+
+    const lastItem = this.selectedItem;
+    this._selectedIndex = index;
+    const newItem = this.selectedItem;
+
+    if (lastItem !== newItem) {
+      this.onSelectedItemChanged(newItem, lastItem);
+    }
+
+    return true;
+  }
+
+  public override addItem(item: BaseItem, position?: number): boolean {
+    const lastSelectedItem = this.selectedItem;
+    const result = super.addItem(item, position);
+    
+    if (result) {
+      const newSelectedItem = this.selectedItem;
+      if (lastSelectedItem !== newSelectedItem) {
+        this.onSelectedItemChanged(newSelectedItem, lastSelectedItem);
+      }
+    }
+    
+    return result;
+  }
+
+  public override moveItem(fromPosition: number, toPosition: number): boolean {
+    const lastSelectedItem = this.selectedItem;
+    const result = super.moveItem(fromPosition, toPosition);
+    
+    if (result) {
+      const newSelectedItem = this.selectedItem;
+      if (lastSelectedItem !== newSelectedItem) {
+        this.onSelectedItemChanged(newSelectedItem, lastSelectedItem);
+      }
+    }
+    
+    return result;
+  }
+
+  public override removeItem(position: number): BaseItem | null {
+    const lastSelectedItem = this.selectedItem;
+    const result = super.removeItem(position);
+    
+    if (result) {
+      const newSelectedItem = this.selectedItem;
+      if (lastSelectedItem !== newSelectedItem) {
+        this.onSelectedItemChanged(newSelectedItem, lastSelectedItem);
+      }
+    }
+    
+    return result;
+  }
+
+  public wouldAddAtSelectedIndex(item: BaseItem): boolean {
+    for (let i = 0; i < HOTBAR_SIZE; i++) {
+      if (!this.getItemAt(i)) {
+        return i === this._selectedIndex;
+      }
+    }
+    
+    return false;
+  }
+
+  protected override onSlotChanged(position: number, item: BaseItem | null): void {
+    this.syncUIUpdate(this._owner.player, position, item);
+  }
+}