@hytopia.com/examples 1.0.3 → 1.0.4

package/frontiers-rpg-game/src/regions/ratkin-nest/npcs/ScoutMorelEntity.ts

@@ -0,0 +1,67 @@
+import BaseEntity, { BaseEntityOptions } from '../../../entities/BaseEntity';
+
+export default class ScoutMorelEntity extends BaseEntity {
+  public constructor(options?: BaseEntityOptions) {
+    super({
+      idleAnimations: [ 'idle' ],
+      modelUri: 'models/npcs/mushroom-boy.gltf',
+      modelScale: 0.65,
+      moveSpeed: 3,
+      name: 'Scout Morel',
+      dialogue: {
+        avatarImageUri: 'avatars/capfolk-villager.png',
+        title: '7th Regiment Volunteer',
+        dialogue: {
+          text: `Hold there! What brings you to this cursed place? I'm Scout Morel of the 7th Regiment - been posted here to watch this Ratkin nest. This place... it's not safe.`,
+          options: [
+            {
+              text: `What exactly is this cave?`,
+              nextDialogue: {
+                text: `This was once a peaceful Ratkin nest - simple burrow dwellers who traded with Stalkhaven. Outer tunnels are now crawling with aggressive Ratkin. Deeper in are Tainted ones.. Glowing green, unnaturally strong. I only explore during daylight. Sunlight comes through holes in the cave's ceiling. At night, you can't see anything.`,
+                options: [
+                  {
+                    text: `I understand.`,
+                    dismiss: true,
+                    pureExit: true,
+                  }
+                ]
+              }
+            },
+            {
+              text: `Have you seen anything else unusual?`,
+              nextDialogue: {
+                text: `That's the worst part. Deep in the nest, I saw creatures I've never seen before. They were spewing thick vapor. When I got close to get a better look, I suddenly got dizzy - had to retreat.`,
+                options: [
+                  {
+                    text: `Thanks for the info.`,
+                    dismiss: true,
+                    pureExit: true,
+                  }
+                ]
+              }
+            },
+            {
+              text: `How did you end up in Stalkhaven?`,
+              nextDialogue: {
+                text: `I was in Sporewick when the fog hit. Captain Chanterelion and Captain Sporn led the evacuation - chaos everywhere, corrupted spores in the air. Lost so many... I escaped with refugees and trained as a scout to honor those who didn't make it.`,
+                options: [
+                  {
+                    text: `I'm glad you made it out safely.`,
+                    dismiss: true,
+                    pureExit: true,
+                  }
+                ]
+              }
+            },
+            {
+              text: `I'll be careful.`,
+              dismiss: true,
+              pureExit: true,
+            }
+          ]
+        }
+      },
+      ...options,
+    });
+  }
+}

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

@@ -0,0 +1,82 @@
+import { Quaternion } from 'hytopia';
+import GameRegion from '../../GameRegion';
+import PortalEntity from '../../entities/PortalEntity';
+
+import CapfolkVillagerEntity from '../../entities/npcs/CapfolkVillagerEntity';
+import CaptainSpornEntity from './npcs/CaptainSpornEntity';
+import CommanderMarkEntity from './npcs/CommanderMarkEntity';
+import BankerJohnEntity from './npcs/BankerJohnEntity';
+import HealerMycelisEntity from './npcs/HealerMycelisEntity';
+import MerchantFinnEntity from './npcs/MerchantFinnEntity';
+
+import stalkhavenMap from '../../../assets/maps/stalkhaven.json';
+
+export default class StalkhavenRegion extends GameRegion {
+  public constructor() {
+    super({
+      id: 'stalkhaven',
+      name: 'Stalkhaven',
+      map: stalkhavenMap,
+      skyboxUri: 'skyboxes/partly-cloudy',
+      spawnPoint: { x: 1, y: 2, z: 40 },
+      ambientAudioUri: 'audio/music/hytopia-main-theme.mp3',
+    });
+  }
+
+  protected override setup(): void {
+    super.setup();
+    
+    this._setupNPCs();
+    this._setupPortals();
+  }
+
+  private _setupNPCs(): void {
+    (new BankerJohnEntity({ facingAngle: 90 })).spawn(this.world, { x: 12, y: 3, z: 41 });
+    (new CaptainSpornEntity({ facingAngle: 315 })).spawn(this.world, { x: -2, y: 3, z: 43 });
+    (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
+    ];
+
+    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,
+        }
+      });
+    }
+  }
+
+  private _setupPortals(): void {
+    const chitterForestPortal = new PortalEntity({
+      destinationRegionId: 'chitter-forest',
+      destinationRegionFacingAngle: 0,
+      destinationRegionPosition: { x: -7, y: 2, z: 76 },
+      modelScale: 2,
+    });
+    chitterForestPortal.spawn(this.world, { x: 1, y: 3.5, z: 46 });
+
+    const stalkhavenPortPortal = new PortalEntity({
+      destinationRegionId: 'stalkhaven-port',
+      destinationRegionFacingAngle: 180,
+      destinationRegionPosition: { x: -6, y: 8, z: -28 },
+      modelScale: 2,
+    });
+    stalkhavenPortPortal.spawn(this.world, { x: 35.5, y: 3.5, z: 1 }, Quaternion.fromEuler(0, 90, 0));
+  }
+}

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

@@ -0,0 +1,40 @@
+import BaseEntity, { BaseEntityOptions } from '../../../entities/BaseEntity';
+
+export default class BankerJohnEntity extends BaseEntity {
+  public constructor(options?: BaseEntityOptions) {
+    super({
+      idleAnimations: [ 'idle' ],
+      modelUri: 'models/npcs/banker.gltf',
+      modelScale: 0.75,
+      name: 'Banker John',
+      dialogue: {
+        avatarImageUri: 'avatars/banker.png',
+        title: 'Head of the Bank',
+        dialogue: {
+          text: 'Sorry, the bank is still under construction. Please check back later.',
+          options: [
+            {
+              text: 'How is the town doing?',
+              nextDialogue: {
+                text: 'The town is doing well, thanks for asking.',
+                options: [
+                  {
+                    text: 'That\'s good to hear.',
+                    dismiss: true,
+                    pureExit: true,
+                  },
+                ]
+              }
+            },
+            {
+              text: 'Ok, I will check back later.',
+              dismiss: true,
+              pureExit: true,
+            },
+          ],
+        }
+      },
+      ...options,
+    });
+  }
+}

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

@@ -0,0 +1,117 @@
+import BaseEntity, { BaseEntityOptions } from '../../../entities/BaseEntity';
+
+export default class CaptainSpornEntity extends BaseEntity {
+  public constructor(options?: BaseEntityOptions) {
+    super({
+      idleAnimations: [ 'idle' ],
+      modelUri: 'models/npcs/mushroom-knight.gltf',
+      modelScale: 0.65,
+      moveSpeed: 3,
+      name: 'Captain Sporn',
+      dialogue: {
+        avatarImageUri: 'avatars/capfolk-knight.png',
+        title: 'South Gate Guard',
+        dialogue: {
+          text: `Hold there, traveler. I'm Captain Sporn. I led Capfolk refugees here from the fog, now I guard this gate. Chitter Forest beyond is overrun with twisted creatures. The Ratkin were never this aggressive before. You prepared for what's out there?`,
+          options: [
+            {
+              text: `I'm ready to fight.`,
+              nextDialogue: {
+                text: `Good spirit! But the fog changed them - they're stronger, more cunning. Their leader calls himself the "Whisker King" now. Make sure you're well-armed before entering the fog.`,
+                options: [
+                  {
+                    text: `Where can I get weapons?`,
+                    nextDialogue: {
+                      text: `Merchant Finn's got blades that cut through fog-touched hide. Tell him I sent you for a fair price. And if you hear chittering in the fog, retreat immediately.`,
+                      options: [
+                        {
+                          text: `Thanks for the warning.`,
+                          dismiss: true,
+                          pureExit: true,
+                        },
+                      ]
+                    }
+                  },
+                  {
+                    text: `Any survival tips?`,
+                    nextDialogue: {
+                      text: `The fog's thickest off the main paths - that's where they hunt. Avoid anything glowing through the fog - it's never friendly. The forest itself fights you now.`,
+                      options: [
+                        {
+                          text: `I'll be careful.`,
+                          dismiss: true,
+                          pureExit: true,
+                        },
+                      ]
+                    }
+                  },
+                  {
+                    text: `I'll clear them all out.`,
+                    nextDialogue: {
+                      text: `If you can push back the fog's influence, Stalkhaven will sing your name! We've lost too much to this cursed fog. Return with victory and I'll make you a local legend.`,
+                      options: [
+                        {
+                          text: `I'll bring you their leader's head.`,
+                          dismiss: true,
+                          pureExit: true,
+                        },
+                      ]
+                    }
+                  },
+                ]
+              }
+            },
+            {
+              text: `What's this Frontier Fog?`,
+              nextDialogue: {
+                text: `Came from nowhere two months ago - a creeping fog that turns peaceful creatures into monsters. Lost a dozen settlements already. My brother's patrol vanished when the fog first hit the forest.`,
+                options: [
+                  {
+                    text: `I'll find answers about your brother.`,
+                    nextDialogue: {
+                      text: `The fog took him, but maybe not his soul. Look for signs in the fog - survivors say some folks are still trapped in there, changed but alive.`,
+                      options: [
+                        {
+                          text: `I promise he'll be avenged.`,
+                          dismiss: true,
+                          pureExit: true,
+                        },
+                      ]
+                    }
+                  },
+                  {
+                    text: `Maybe I should avoid the forest.`,
+                    nextDialogue: {
+                      text: `Smart thinking. If you do decide to go out, make sure you've got a weapon.`,
+                      options: [
+                        {
+                          text: `I'll prepare before entering Chitter Forest.`,
+                          dismiss: true,
+                          pureExit: true,
+                        },
+                      ]
+                    }
+                  },
+                ]
+              }
+            },
+            {
+              text: `Just passing through.`,
+              nextDialogue: {
+                text: `Through fog-cursed wilderness? Either brave or mad. The fog claims most who enter unprepared. Grab weapons from Finn's shop - consider it frontier survival insurance.`,
+                options: [
+                  {
+                    text: `Fine, I'll get equipped first.`,
+                    dismiss: true,
+                    pureExit: true,
+                  },
+                ]
+              }
+            },
+          ],
+        }
+      },
+      ...options,
+    });
+  }
+}

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

@@ -0,0 +1,313 @@
+import BaseEntity, { BaseEntityOptions } from '../../../entities/BaseEntity';
+
+export default class CommanderMarkEntity extends BaseEntity {
+  public constructor(options?: BaseEntityOptions) {
+    super({
+      idleAnimations: [ 'idle' ],
+      modelUri: 'models/npcs/knight-commander.gltf',
+      modelScale: 0.75,
+      name: 'Commander Mark',
+      dialogue: {
+        avatarImageUri: 'avatars/commander.png',
+        title: '7th Regiment Commander',
+        dialogue: {
+          text: `Welcome to Stalkhaven, adventurer. I'm Commander Mark of the 7th Regiment. This might be the last free settlement in The Frontier - we need brave souls like you.`,
+          options: [
+            {
+              text: `Tell me about Stalkhaven.`,
+              nextDialogue: {
+                text: `Once The Frontier's greatest trading hub, now a refugee shelter. We're barely holding the line against the fog.`,
+                options: [
+                  {
+                    text: `What happened to other settlements?`,
+                                          nextDialogue: {
+                        text: `Swallowed by fog, one by one. We've received refugees from a dozen settlements. Most places are just monsters and mist now.`,
+                      options: [
+                        {
+                          text: `Are there other survivors out there?`,
+                          nextDialogue: {
+                            text: `Captain Sporn led Capfolk refugees here last week. If they made it, others might still be alive, hiding in the fog.`,
+                            options: [
+                              {
+                                text: `I'll search for more survivors.`,
+                                dismiss: true,
+                                pureExit: true,
+                              },
+                            ]
+                          }
+                        },
+                        {
+                          text: `How has Stalkhaven survived?`,
+                                                      nextDialogue: {
+                              text: `Strong walls, good people, determination. We've fortified every entrance, but honestly? We're just lucky so far.`,
+                            options: [
+                              {
+                                text: `I'll help defend this place.`,
+                                dismiss: true,
+                                pureExit: true,
+                              },
+                            ]
+                          }
+                        },
+                      ]
+                    }
+                  },
+                  {
+                    text: `What about the port?`,
+                                            nextDialogue: {
+                          text: `Eastern port is sealed. Sea monsters attacked - fog-twisted creatures. No ships until it's safe.`,
+                      options: [
+                        {
+                          text: `I could help clear the port.`,
+                                                      nextDialogue: {
+                              text: `Brave offer, but those waters are treacherous. Speak with the harbor master first - we can't lose more people.`,
+                            options: [
+                              {
+                                text: `I'll investigate the harbor first.`,
+                                dismiss: true,
+                                pureExit: true,
+                              },
+                            ]
+                          }
+                        },
+                        {
+                          text: `What kind of sea monsters?`,
+                                                      nextDialogue: {
+                              text: `Massive tentacled beasts with glowing eyes. They pulled two ships under. Something vast lurks beneath the waves.`,
+                            options: [
+                              {
+                                text: `The fog is affecting the seas too...`,
+                                dismiss: true,
+                                pureExit: true,
+                              },
+                            ]
+                          }
+                        },
+                      ]
+                    }
+                  },
+                  {
+                    text: `Where can I settle here?`,
+                                            nextDialogue: {
+                          text: `Planning to stay? Good. Head west to the farmlands - old farmer wants to sell his plot. Humble land, but yours to build on.`,
+                      options: [
+                        {
+                          text: `How much is he asking?`,
+                                                      nextDialogue: {
+                              text: `Fair price. He wants someone who'll make good use of it. A working farm could help feed our refugees.`,
+                            options: [
+                              {
+                                text: `I'll speak with him about the land.`,
+                                dismiss: true,
+                                pureExit: true,
+                              },
+                            ]
+                          }
+                        },
+                        {
+                          text: `Is the farmland safe?`,
+                                                      nextDialogue: {
+                              text: `Safer than most places. Fog hasn't reached western fields yet, and we patrol regularly. Best place to make a stand.`,
+                            options: [
+                              {
+                                text: `I'll consider it.`,
+                                dismiss: true,
+                                pureExit: true,
+                              },
+                            ]
+                          }
+                        },
+                      ]
+                    }
+                  },
+                ]
+              }
+            },
+            {
+              text: `What threats are we facing?`,
+              nextDialogue: {
+                text: `The fog spawns countless horrors. Chitter Forest is overrun with Ratkin - once peaceful traders, now killers under the "Whisker King."`,
+                options: [
+                  {
+                    text: `What changed the Ratkin?`,
+                                          nextDialogue: {
+                        text: `Nobody knows. They were our allies for generations - peaceful merchants. Now they attack on sight under this Whisker King.`,
+                      options: [
+                        {
+                          text: `I'll confront this Whisker King.`,
+                                                      nextDialogue: {
+                              text: `You'll need more than courage. Talk to Captain Sporn at the south gate first - he knows their movements. Get armed.`,
+                            options: [
+                              {
+                                text: `I'll prepare thoroughly.`,
+                                dismiss: true,
+                                pureExit: true,
+                              },
+                            ]
+                          }
+                        },
+                        {
+                          text: `Can they be saved?`,
+                                                      nextDialogue: {
+                              text: `That's what keeps me awake. If the fog's influence can be broken, maybe they can return. We need to find the source first.`,
+                            options: [
+                              {
+                                text: `Finding the source is crucial then.`,
+                                dismiss: true,
+                                pureExit: true,
+                              },
+                            ]
+                          }
+                        },
+                      ]
+                    }
+                  },
+                  {
+                    text: `Where does the fog come from?`,
+                                          nextDialogue: {
+                        text: `Million-gold question. Appeared two months ago, spreading ever since. Thickest to the northeast, but none who venture deep return.`,
+                      options: [
+                        {
+                          text: `I'll investigate the source.`,
+                                                      nextDialogue: {
+                              text: `Many tried, few return. Those who do come back... changed. Gather allies first - not a solo mission.`,
+                            options: [
+                              {
+                                text: `I'll find others to help.`,
+                                dismiss: true,
+                                pureExit: true,
+                              },
+                            ]
+                          }
+                        },
+                        {
+                          text: `Any scouts survive to report back?`,
+                                                      nextDialogue: {
+                              text: `A handful. They speak of impossible things - shifting landscapes, creatures that shouldn't exist. The fog isn't weather - it's alive.`,
+                            options: [
+                              {
+                                text: `Alive? What do you mean?`,
+                                nextDialogue: {
+                                  text: `It moves with purpose, responds to threats. Some say it whispers, tries to turn you against companions. Whatever's at its center is intelligent.`,
+                                  options: [
+                                    {
+                                      text: `We have to stop it.`,
+                                      dismiss: true,
+                                      pureExit: true,
+                                    },
+                                  ]
+                                }
+                              },
+                            ]
+                          }
+                        },
+                      ]
+                    }
+                  },
+                  {
+                    text: `Other dangers besides the fog?`,
+                    nextDialogue: {
+                      text: `Fog corrupts everything it touches. Normal wolves become shadowbeasts, peaceful Ratkin turn savage. Every day brings new horrors.`,
+                      options: [
+                        {
+                          text: `How do we fight that?`,
+                          nextDialogue: {
+                            text: `Steel, courage, unity. The fog preys on isolation and fear. Stay together, stay vigilant, never venture into heavy fog alone.`,
+                            options: [
+                              {
+                                text: `I'll remember that.`,
+                                dismiss: true,
+                                pureExit: true,
+                              },
+                            ]
+                          }
+                        },
+                      ]
+                    }
+                  },
+                ]
+              }
+            },
+            {
+              text: `I'm new here. What should I know?`,
+              nextDialogue: {
+                text: `Stalkhaven operates on mutual aid - everyone contributes. Visit our merchants for supplies, check with gate guards about threats.`,
+                options: [
+                  {
+                    text: `Where should I start?`,
+                    nextDialogue: {
+                      text: `Get equipped first - Merchant Finn has quality gear. Talk to gate guards about threats. Capfolk refugees have intel about beyond our walls.`,
+                      options: [
+                        {
+                          text: `Any specific tasks you need help with?`,
+                          nextDialogue: {
+                            text: `Always need scouts, monster hunters, anyone brave enough to venture into fog. Prove yourself with smaller missions first.`,
+                            options: [
+                              {
+                                text: `I'll build my reputation.`,
+                                dismiss: true,
+                                pureExit: true,
+                              },
+                            ]
+                          }
+                        },
+                        {
+                          text: `Tell me about the Capfolk refugees.`,
+                          nextDialogue: {
+                            text: `Brave folk led here by Captain Sporn after their village fell. They provide valuable intelligence and many are skilled crafters.`,
+                            options: [
+                              {
+                                text: `I should speak with them.`,
+                                dismiss: true,
+                                pureExit: true,
+                              },
+                            ]
+                          }
+                        },
+                      ]
+                    }
+                  },
+                  {
+                    text: `What makes Stalkhaven special?`,
+                    nextDialogue: {
+                      text: `Before the fog, we were The Frontier's greatest trading hub. That spirit of cooperation keeps us alive now.`,
+                      options: [
+                        {
+                          text: `Will trade return to normal?`,
+                          nextDialogue: {
+                            text: `Once we deal with the fog, absolutely. We'll rebuild bigger and stronger. We have to believe that.`,
+                            options: [
+                              {
+                                text: `I'll help make that future possible.`,
+                                dismiss: true,
+                                pureExit: true,
+                              },
+                            ]
+                          }
+                        },
+                      ]
+                    }
+                  },
+                ]
+              }
+            },
+            {
+              text: `I need to go. Stay safe, Commander.`,
+              nextDialogue: {
+                text: `And you as well. Remember - in The Frontier, we're stronger together. Don't face the fog alone, always have an escape route.`,
+                options: [
+                  {
+                    text: `Thank you for the guidance.`,
+                    dismiss: true,
+                    pureExit: true,
+                  },
+                ]
+              }
+            },
+          ],
+        }
+      },
+      ...options,
+    });
+  }
+}