@hytopia.com/examples 1.0.3 → 1.0.5

package/frontiers-rpg-game/src/quests/main/StalkhavensOutpostQuest.ts

@@ -0,0 +1,63 @@
+import BaseQuest, { QuestObjective, QuestNpcDialogueInteraction } from '../BaseQuest';
+import { SkillId } from '../../config';
+import type GamePlayerEntity from '../../GamePlayerEntity';
+
+import CaptainChanterelionEntity from '../../regions/chitter-forest/npcs/CaptainChanterelionEntity';
+import ClearingCampsQuest from './ClearingCampsQuest';
+
+export default class StalkhavensOutpostQuest extends BaseQuest {
+  static readonly id = 'stalkhavens-outpost';
+  static readonly name = `Stalkhaven's Outpost`;
+  static readonly description = 'Commander Mark has instructed you to meet Captain Chanterelion at his outpost in Chitter Forest just outside of the Stalkhaven gate. He needs your help to clear the Ratkin camps in the area.';
+
+  static readonly reward = {
+    skillExperience: [
+      { skillId: SkillId.EXPLORATION, amount: 75 },
+    ],
+  }
+
+  static readonly objectives: QuestObjective[] = [
+    {
+      id: 'talk-to-chanterelion',
+      name: 'Speak with Captain Chanterelion',
+      description: 'Find Captain Chanterelion at his outpost in Chitter Forest and speak with him.',
+      target: 1,
+    },
+  ];
+
+  static readonly dialogueInteractions: QuestNpcDialogueInteraction[] = [
+    // Quest Complete 
+    {
+      npcClass: CaptainChanterelionEntity,
+      dialogueOption: {
+        text: `Commander Mark sent me to report for strikes on the Ratkin camps.`,
+        nextDialogue: {
+          text: `Excellent, friend. Mark spoke true - we need someone with proven combat skills. The Ratkin have established four major encampments that threaten Stalkhaven. We need to clear these camps out before they can launch a full on assault on Stalkhaven.`,
+          options: [
+            {
+              text: `I'm ready. Where are these camps?`,
+              nextDialogue: {
+                text: `Scattered throughout the forest - two in the main woodland, one by the lake, and another off an old beaten path. Clear them all and report back. Time is short - every day they grow stronger.`,
+                options: [
+                  {
+                    text: `Consider it done, Captain.`,
+                    dismiss: true,
+                    pureExit: true,
+                  }
+                ],
+              },
+              onSelect: (interactor: GamePlayerEntity) => {
+                interactor.gamePlayer.questLog.adjustObjectiveProgress(this.id, 'talk-to-chanterelion', 1);
+                interactor.gamePlayer.questLog.completeQuest(this.id);
+                interactor.gamePlayer.questLog.startQuest(ClearingCampsQuest);
+              }
+            }
+          ],
+        },
+      },
+      enabledForInteractor: (interactor: GamePlayerEntity) => {
+        return interactor.gamePlayer.questLog.isQuestActive(this.id);
+      }
+    }
+  ];
+}

package/frontiers-rpg-game/src/quests/main/TestedMettleQuest.ts

@@ -0,0 +1,103 @@
+import BaseQuest, { QuestObjective, QuestNpcDialogueInteraction } from '../BaseQuest';
+import { SkillId } from '../../config';
+import type GamePlayer from '../../GamePlayer';
+import type GamePlayerEntity from '../../GamePlayerEntity';
+
+import { BaseEntityPlayerEvent } from '../../entities/BaseEntity';
+import { GamePlayerEntityPlayerEvent } from '../../GamePlayerEntity';
+import type { BaseEntityPlayerEventPayloads } from '../../entities/BaseEntity';
+import type { GamePlayerEntityPlayerEventPayloads } from '../../GamePlayerEntity';
+
+import CommanderMarkEntity from '../../regions/stalkhaven/npcs/CommanderMarkEntity';
+import StalkhavensOutpostQuest from './StalkhavensOutpostQuest';
+
+import GoldItem from '../../items/general/GoldItem';
+
+export default class TestedMettleQuest extends BaseQuest {
+  static readonly id = 'tested-mettle';
+  static readonly name = 'Tested Mettle';
+  static readonly description = `Commander Mark wants to test your combat abilities before assigning you to military operations. Prove your mettle by eliminating corrupted Ratkin in Chitter Forest and demonstrating your dodging skills in combat.`;
+
+  static readonly reward = {
+    items: [
+      { itemClass: GoldItem, quantity: 50},
+    ],
+    skillExperience: [
+      { skillId: SkillId.COMBAT, amount: 150 },
+      { skillId: SkillId.EXPLORATION, amount: 150 },
+    ],
+  }
+
+  static readonly objectives: QuestObjective[] = [
+    {
+      id: 'kill-5-ratkin',
+      name: 'Kill 5 Ratkin',
+      description: 'Kill 5 Ratkin in Chitter Forest.',
+      target: 5,
+    },
+    {
+      id: 'dodge-3-times',
+      name: 'Perform 3 Successful Roll Dodges',
+      description: 'Roll dodge successfully 3 times in combat.',
+      target: 3,
+    },
+    {
+      id: 'talk-to-mark',
+      name: 'Return to Commander Mark',
+      description: 'Talk to Commander Mark after completing all other objectives.',
+      target: 1,
+    }
+  ];
+
+  static readonly dialogueInteractions: QuestNpcDialogueInteraction[] = [
+    {
+      npcClass: CommanderMarkEntity,
+      dialogueOption: {
+        text: `I've cleared out some of the Ratkin in Chitter Forest.`,
+        nextDialogue: {
+          text: `Impressive work. You've proven you can handle the corrupted Ratkin and stay alive doing it. I want you to go meet Captain Chanterelion. He's established an outpost just outside the Stalkhaven gates in Chitter Forest with Capfolk knights from his refugee group. They're planning coordinated strikes against the larger Ratkin encampments closes to Stalkhaven. Report to the camp - they need someone with your proven abilities.`,
+          options: [
+            {
+              text: `I'll report to Captain Chanterelion's camp immediately.`,
+              dismiss: true,
+              pureExit: true,
+            }
+          ],
+        },
+        onSelect: (interactor: GamePlayerEntity) => {
+          interactor.gamePlayer.questLog.adjustObjectiveProgress(this.id, 'talk-to-mark', 1);
+          interactor.gamePlayer.questLog.completeQuest(this.id);
+          interactor.gamePlayer.questLog.startQuest(StalkhavensOutpostQuest);
+        }
+      },
+      enabledForInteractor: (interactor: GamePlayerEntity) => {
+        return interactor.gamePlayer.questLog.isQuestActive(this.id) &&
+               interactor.gamePlayer.questLog.isQuestObjectiveCompleted(this.id, 'kill-5-ratkin') &&
+               interactor.gamePlayer.questLog.isQuestObjectiveCompleted(this.id, 'dodge-3-times')
+      }
+    }
+  ];
+
+  public static setupForPlayer(gamePlayer: GamePlayer): () => void {
+    // Add event listeners
+    const dodgeListener = (payload: GamePlayerEntityPlayerEventPayloads[GamePlayerEntityPlayerEvent.DODGED]) => {
+      gamePlayer.questLog.adjustObjectiveProgress(this.id, 'dodge-3-times', 1);
+    };
+
+    const killListener = (payload: BaseEntityPlayerEventPayloads[BaseEntityPlayerEvent.KILLED]) => {
+      if (payload.entity.name.includes('Ratkin')) {
+        gamePlayer.questLog.adjustObjectiveProgress(this.id, 'kill-5-ratkin', 1);
+      }
+    }
+
+    gamePlayer.eventRouter.on(GamePlayerEntityPlayerEvent.DODGED, dodgeListener);
+    gamePlayer.eventRouter.on(BaseEntityPlayerEvent.KILLED, killListener);
+
+    const cleanup = () => {
+      gamePlayer.eventRouter.off(GamePlayerEntityPlayerEvent.DODGED, dodgeListener);
+      gamePlayer.eventRouter.off(BaseEntityPlayerEvent.KILLED, killListener);
+    };
+
+    return cleanup;
+  }    
+}

package/frontiers-rpg-game/src/quests/main/WelcomeToStalkhavenQuest.ts

@@ -0,0 +1,88 @@
+import BaseQuest, { QuestObjective, QuestReward, QuestNpcDialogueInteraction } from '../BaseQuest';
+import { SkillId } from '../../config';
+import type GamePlayerEntity from '../../GamePlayerEntity';
+
+import BoatRepairmanSidEntity from '../../regions/stalkhaven-port/npcs/BoatRepairmanSidEntity';
+import CommanderMarkEntity from '../../regions/stalkhaven/npcs/CommanderMarkEntity';
+import ExploringStalkhavenQuest from './ExploringStalkhavenQuest';
+
+export default class WelcomeToStalkhavenQuest extends BaseQuest {
+  static readonly id = 'welcome-to-stalkhaven';
+  static readonly name = 'Welcome to Stalkhaven';
+  static readonly description = 'You have arrived in Stalkhaven. After talking to Sid at the port, he instructs you to find Commander Mark in town to learn more about the Frontier and fog.';
+
+  static readonly reward = {
+    skillExperience: [
+      { skillId: SkillId.EXPLORATION, amount: 100 },
+    ],
+  }
+
+  static readonly objectives: QuestObjective[] = [
+    {
+      id: 'talk-to-mark',
+      name: 'Talk to Commander Mark',
+      description: 'Find Commander Mark in Stalkhaven and speak with him.',
+      target: 1,
+    },
+  ];
+
+  static readonly dialogueInteractions: QuestNpcDialogueInteraction[] = [
+    // Quest Start - Talk To Sid
+    {
+      npcClass: BoatRepairmanSidEntity,
+      dialogueOption: {
+        text: `I need to understand what's happening here. Who can tell me about the fog?`,
+        nextDialogue: {
+          text: `Commander Mark runs Stalkhaven - he's fighting to keep this place standing while The Frontier falls. Find him at the garrison, he'll tell you the truth about what we're facing.`,
+          options: [
+            {
+              text: `I'll find Commander Mark.`,
+              dismiss: true,
+              pureExit: true,
+            }
+          ]
+        },
+        onSelect: (interactor: GamePlayerEntity) => {
+          interactor.gamePlayer.questLog.startQuest(this);
+        }
+      },
+      enabledForInteractor: (interactor: GamePlayerEntity) => {
+        return !interactor.gamePlayer.questLog.hasQuest(this.id);
+      }
+    },
+
+    // Quest Complete, Talk To Mark
+    {
+      npcClass: CommanderMarkEntity,
+      dialogueOption: {
+        text: `Sid sent me. I need to know what I'm up against in The Frontier.`,
+        nextDialogue: {
+          text: `Smart of Sid to send you here. The fog isn't weather - it's alive, corrupting everything it touches. Stalkhaven may be the last free settlement standing. You'll need to understand the threats before venturing out.`,
+          options: [
+            {
+              text: `What should I do to prepare?`,
+              nextDialogue: {
+                text: `Get familiar with Stalkhaven first. Talk to our merchants, guards, and refugees. They'll teach you what you need to survive. Knowledge saves lives in The Frontier.`,
+                options: [
+                  {
+                    text: `I'll speak with everyone. Thank you, Commander.`,
+                    dismiss: true,
+                    pureExit: true,
+                  }
+                ],
+              },
+              onSelect: (interactor: GamePlayerEntity) => {
+                interactor.gamePlayer.questLog.adjustObjectiveProgress(this.id, 'talk-to-mark', 1);
+                interactor.gamePlayer.questLog.completeQuest(this.id);
+                interactor.gamePlayer.questLog.startQuest(ExploringStalkhavenQuest);
+              }
+            }
+          ],
+        },
+      },
+      enabledForInteractor: (interactor: GamePlayerEntity) => {
+        return interactor.gamePlayer.questLog.isQuestActive(this.id);
+      }
+    }
+  ];
+}

package/frontiers-rpg-game/src/quests/side/DipDuckDodgeQuest.ts

@@ -0,0 +1,123 @@
+import BaseQuest, { QuestObjective, QuestNpcDialogueInteraction } from '../BaseQuest';
+import { SkillId } from '../../config';
+import type GamePlayer from '../../GamePlayer';
+import type GamePlayerEntity from '../../GamePlayerEntity';
+
+import { GamePlayerEntityPlayerEvent } from '../../GamePlayerEntity';
+import type { GamePlayerEntityPlayerEventPayloads } from '../../GamePlayerEntity';
+
+import CaptainSpornEntity from '../../regions/stalkhaven/npcs/CaptainSpornEntity';
+import ExploringStalkhavenQuest from '../main/ExploringStalkhavenQuest';
+
+import AdventurerLeggingsItem from '../../items/wearables/AdventurerLeggingsItem';
+
+export default class DipDuckDodgeQuest extends BaseQuest {
+  static readonly id = 'dip-duck-dodge';
+  static readonly name = 'Dip, Duck, Dodge!';
+  static readonly description = `Captain Sporn wants to sharpen up your survival skills. Improving your dodge timing is critical to surviving in the Frontier.`;
+
+  static readonly reward = {
+    items: [
+      { itemClass: AdventurerLeggingsItem, quantity: 1 },
+    ],
+    skillExperience: [
+      { skillId: SkillId.AGILITY, amount: 750 },
+      { skillId: SkillId.COMBAT, amount: 250 },
+    ],
+  }
+
+  static readonly objectives: QuestObjective[] = [
+    {
+      id: 'dodge',
+      name: 'Perform 100 Successful Roll Dodges',
+      description: 'Perform 100 successful roll dodges in combat.',
+      target: 100,
+    },
+    {
+      id: 'talk-to-sporn',
+      name: 'Speak with Captain Sporn',
+      description: 'Speak with Captain Sporn after completing 100 successful roll dodges.',
+      target: 1,
+    }
+  ];
+
+  static readonly dialogueInteractions: QuestNpcDialogueInteraction[] = [
+    // Start Quest
+    {
+      npcClass: CaptainSpornEntity,
+      dialogueOption: {
+        text: `Teach me to survive against fog-touched creatures.`,
+        nextDialogue: {
+          text: `Smart request. Those Ratkin move fast and strike without warning. Your best defense? Master dodging. Evasion keeps you breathing.`,
+          options: [
+            {
+              text: `I'm ready for whatever training you've got.`,
+              nextDialogue: {
+                text: `Let's start with 100 successful roll dodges. The fog-touched monsters won't give you second chances, so your timing needs to be perfect. Find some enemies and practice.`,
+                options: [
+                  {
+                    text: `Understood, Captain.`,
+                    dismiss: true,
+                    pureExit: true,
+                  }
+                ],
+              },
+              onSelect: (interactor: GamePlayerEntity) => {
+                interactor.gamePlayer.questLog.startQuest(this);
+              }
+            },
+            {
+              text: `Maybe I'll stick to safer areas for now.`,
+              dismiss: true,
+              pureExit: true,
+            }
+          ],
+        },
+      },
+      enabledForInteractor: (interactor: GamePlayerEntity) => {
+        return interactor.gamePlayer.questLog.isQuestCompleted(ExploringStalkhavenQuest.id) &&
+               !interactor.gamePlayer.questLog.hasQuest(this.id);
+      }
+    },
+
+    // Complete Quest
+    {
+      npcClass: CaptainSpornEntity,
+      dialogueOption: {
+        text: `That was tough, but I've completed your evasion training.`,
+        nextDialogue: {
+          text: `Excellent work. Your footwork's improved - might just keep you alive when you venture into the fog.`,
+          options: [
+            {
+              text: `I'll be on my way.`,
+              dismiss: true,
+              pureExit: true,
+            }
+          ],
+        },
+        onSelect: (interactor: GamePlayerEntity) => {
+          interactor.gamePlayer.questLog.completeQuest(this.id);
+        }
+      },
+      enabledForInteractor: (interactor: GamePlayerEntity) => {
+        return interactor.gamePlayer.questLog.isQuestActive(this.id) &&
+               interactor.gamePlayer.questLog.isQuestObjectiveCompleted(this.id, 'dodge');
+      }
+    }
+  ];
+
+  public static setupForPlayer(gamePlayer: GamePlayer): () => void {
+    // Add event listeners
+    const dodgeListener = (payload: GamePlayerEntityPlayerEventPayloads[GamePlayerEntityPlayerEvent.DODGED]) => {
+      gamePlayer.questLog.adjustObjectiveProgress(this.id, 'dodge', 1);
+    };
+
+    gamePlayer.eventRouter.on(GamePlayerEntityPlayerEvent.DODGED, dodgeListener);
+
+    const cleanup = () => {
+      gamePlayer.eventRouter.off(GamePlayerEntityPlayerEvent.DODGED, dodgeListener);
+    };
+
+    return cleanup;
+  }    
+}

package/frontiers-rpg-game/src/quests/side/FungalForagingQuest.ts

@@ -0,0 +1,172 @@
+import BaseQuest, { QuestObjective, QuestNpcDialogueInteraction } from '../BaseQuest';
+import { SkillId } from '../../config';
+import type GamePlayer from '../../GamePlayer';
+import type GamePlayerEntity from '../../GamePlayerEntity';
+
+import { BaseForageableEntityPlayerEvent } from '../../entities/BaseForageableEntity';
+import { BaseItemPlayerEvent } from '../../items/BaseItem';
+import type { BaseForageableEntityPlayerEventPayloads } from '../../entities/BaseForageableEntity';
+import type { BaseItemPlayerEventPayloads } from '../../items/BaseItem';
+
+import MerchantFinnEntity from '../../regions/stalkhaven/npcs/MerchantFinnEntity';
+import ExploringStalkhavenQuest from '../main/ExploringStalkhavenQuest';
+
+import AdventurerGlovesItem from '../../items/wearables/AdventurerGlovesItem';
+import CommonMushroomItem from '../../items/consumables/CommonMushroomItem';
+import GoldItem from '../../items/general/GoldItem';
+
+export default class FungalForagingQuest extends BaseQuest {
+  static readonly id = 'fungal-foraging';
+  static readonly name = 'Fungal Foraging';
+  static readonly description = `Merchant Finn is running low on mushrooms, and you're running low on coins. Can you help him out?`;
+
+  static readonly reward = {
+    items: [
+      { itemClass: AdventurerGlovesItem, quantity: 1 },
+      { itemClass: GoldItem, quantity: 125 },
+    ],
+    skillExperience: [
+      { skillId: SkillId.FORAGING, amount: 300 },
+      { skillId: SkillId.BARTERING, amount: 300 },
+    ],
+  }
+
+  static readonly objectives: QuestObjective[] = [
+    {
+      id: 'forage-logs',
+      name: 'Forage At Least 5 Rotten Logs',
+      description: 'Forage at least 5 Rotten Logs in the Chitter Forest.',
+      target: 5,
+    },
+    {
+      id: 'pick-mushrooms',
+      name: 'Collect 25 Common Mushrooms',
+      description: 'Collect 25 Common Mushrooms from Rotten Logs in Chitter Forest.',
+      target: 25,
+    },
+    {
+      id: 'give-mushrooms',
+      name: 'Give 25 Common Mushrooms To Merchant Finn',
+      description: 'Give 25 Common Mushrooms to Merchant Finn in Stalkhaven.',
+      target: 1,
+    }
+  ];
+
+  static readonly dialogueInteractions: QuestNpcDialogueInteraction[] = [
+    // Start Quest
+    {
+      npcClass: MerchantFinnEntity,
+      dialogueOption: {
+        text: `Looking for work - got anything that pays?`,
+        nextDialogue: {
+          text: `Business has been good, maybe too good. The Capfolk can't get enough mushrooms and my supply's running dry. If you can bring me 25 Common Mushrooms from the Rotten Logs in Chitter Forest, I'll make it worth your while.`,
+          options: [
+            {
+              text: `Sounds like a fair trade. I'll get those mushrooms.`,
+              nextDialogue: {
+                text: `Smart thinking! Just watch yourself out there - those Ratkin don't take kindly to visitors in their forest.`,
+                options: [
+                  {
+                    text: `I can handle myself.`,
+                    dismiss: true,
+                    pureExit: true,
+                  }
+                ]
+              },
+              onSelect: (interactor: GamePlayerEntity) => {
+                interactor.gamePlayer.questLog.startQuest(this);
+              }
+            },
+            {
+              text: `Not interested in forest work right now.`,
+              dismiss: true,
+              pureExit: true,
+            }
+          ],
+        },
+      },
+      enabledForInteractor: (interactor: GamePlayerEntity) => {
+        return interactor.gamePlayer.questLog.isQuestCompleted(ExploringStalkhavenQuest.id) &&
+               !interactor.gamePlayer.questLog.hasQuest(this.id);
+      }
+    },
+
+    // Complete Quest
+    {
+      npcClass: MerchantFinnEntity,
+      dialogueOption: {
+        text: `Got your mushrooms right here.`,
+        nextDialogue: {
+          text: `Perfect quality! My Capfolk customers will be pleased, and so will my coin purse. Here's your payment as promised.`,
+          options: [
+            {
+              text: `Pleasure doing business.`,
+              dismiss: true,
+              pureExit: true,
+            }
+          ],
+        },
+        onSelect: (interactor: GamePlayerEntity) => {
+          const totalBackpackMushrooms = interactor.gamePlayer.backpack.getItemQuantityByClass(CommonMushroomItem);
+          const totalHotbarMushrooms = interactor.gamePlayer.hotbar.getItemQuantityByClass(CommonMushroomItem);
+
+          if (totalHotbarMushrooms + totalBackpackMushrooms < 25) {
+            return interactor.showNotification(`Merchant Finn is looking for 25 Common Mushrooms - seems you're a bit short!`, 'error');
+          }
+
+          // Remove 25 mushrooms from backpack and hotbar
+          let remaining = 25;
+          
+          // Remove from backpack first
+          for (const item of interactor.gamePlayer.backpack.getItemsByClass(CommonMushroomItem)) {
+            if (remaining <= 0) break;
+            const toRemove = Math.min(item.quantity, remaining);
+            interactor.gamePlayer.backpack.adjustItemQuantityByReference(item, -toRemove);
+            remaining -= toRemove;
+          }
+          
+          // Remove from hotbar if needed
+          for (const item of interactor.gamePlayer.hotbar.getItemsByClass(CommonMushroomItem)) {
+            if (remaining <= 0) break;
+            const toRemove = Math.min(item.quantity, remaining);
+            interactor.gamePlayer.hotbar.adjustItemQuantityByReference(item, -toRemove);
+            remaining -= toRemove;
+          }
+
+          interactor.gamePlayer.questLog.adjustObjectiveProgress(this.id, 'give-mushrooms', 1);
+          interactor.gamePlayer.questLog.completeQuest(this.id);
+        }
+      },
+      enabledForInteractor: (interactor: GamePlayerEntity) => {
+        return interactor.gamePlayer.questLog.isQuestActive(this.id) &&
+               interactor.gamePlayer.questLog.isQuestObjectiveCompleted(this.id, 'forage-logs') &&
+               interactor.gamePlayer.questLog.isQuestObjectiveCompleted(this.id, 'pick-mushrooms');
+      }
+    }
+  ];
+
+  public static setupForPlayer(gamePlayer: GamePlayer): () => void {
+    // Add event listeners
+    const forageListener = (payload: BaseForageableEntityPlayerEventPayloads[BaseForageableEntityPlayerEvent.FORAGED]) => {
+      if (payload.entity.name === 'Rotten Log') {
+        gamePlayer.questLog.adjustObjectiveProgress(this.id, 'forage-logs', 1);
+      }
+    };
+
+    const itemPickupListener = (payload: BaseItemPlayerEventPayloads[BaseItemPlayerEvent.PICKED_UP]) => {
+      if (payload.item.id === CommonMushroomItem.id) {
+        gamePlayer.questLog.adjustObjectiveProgress(this.id, 'pick-mushrooms', payload.item.quantity);
+      }
+    };
+
+    gamePlayer.eventRouter.on(BaseForageableEntityPlayerEvent.FORAGED, forageListener);
+    gamePlayer.eventRouter.on(BaseItemPlayerEvent.PICKED_UP, itemPickupListener);
+
+    const cleanup = () => {
+      gamePlayer.eventRouter.off(BaseForageableEntityPlayerEvent.FORAGED, forageListener);
+      gamePlayer.eventRouter.off(BaseItemPlayerEvent.PICKED_UP, itemPickupListener);
+    };
+
+    return cleanup;
+  }    
+}