ForgeQuests Integration

ForgeQuests turns DungeonForge runs into quest objectives, story chains, turn-ins, and reward flows. Use DungeonForge for the instanced dungeon content, then let ForgeQuests guide players into the dungeon, track clears and bosses, and continue the story afterward.

Recommended Plugin Setup

1. Install both DungeonForge and ForgeQuests in the server plugins folder.
2. Start the server once so both plugins generate their config folders.
3. Build and publish your dungeon in DungeonForge.
4. Create a ForgeQuests quest that targets the dungeon id with DUNGEON_CLEAR or the boss id with BOSS_KILL.
5. Use ForgeQuests waypoints and NPCs to point players to the dungeon entrance, quest board, or story NPC.

Enable the Soft Hook

ForgeQuests includes a DungeonForge soft integration. In plugins/ForgeQuests/integrations.yml:

integrations:
  dungeonforge: true

No DungeonForge config change is required for basic quest progress. ForgeQuests listens for DungeonForge run completion and boss kill events when the plugin is present.

Story Run Launches

ForgeQuests premium scripts can launch DungeonForge directly from dialogue or quest moments. Use this when an NPC choice should queue the player into a dungeon after a cinematic, codex unlock, or phase change.

scripts:
  crypt_trial:
    accept:
      - "title:&6Crypt Trial|&7The doors open below."
      - "dungeon-run:crypt_trial"
    complete:
      - "codex:crypt_warden"
      - "phase:crypt_cleansed"
      - "season:season_one:25"

Dungeon Clear Quest

Use the DungeonForge dungeon id as the objective target. When the player clears that dungeon, ForgeQuests advances the objective.

quests:
  crypt_trial:
    display-name: "&6Trial of the Crypt"
    category: MAIN
    repeatable: DAILY
    next-quest: crypt_aftermath
    next-quest-mode: SUGGEST
    stages:
      - id: enter
        title: "Enter the old crypt"
        objectives:
          - type: REACH
            target: world,120,64,-44,4
            amount: 1
            description: "Reach the crypt entrance"
            waypoint: world,120,64,-44
            hint: "Follow the old road north of spawn."
      - id: clear
        title: "Clear the crypt"
        time-limit-seconds: 1800
        fail-on-death: false
        objectives:
          - type: DUNGEON_CLEAR
            target: crypt_trial
            amount: 1
            description: "Clear the Crypt Trial dungeon"
            hint: "Queue with a party if the final room is too hard."
    rewards:
      money: 250
      class-xp: 500
      skill-points: 1
      commands:
        - "tell %player% The crypt doors fall silent."

Boss Kill Quest

Use BOSS_KILL for story bosses. The target should match the boss id emitted by the DungeonForge boss event or your configured boss marker id.

quests:
  warden_head:
    display-name: "&cThe Warden Below"
    category: MAIN
    repeatable: NEVER
    stages:
      - id: slay
        title: "Defeat the dungeon warden"
        fail-on-death: true
        failure-quest: warden_recovery
        objectives:
          - type: BOSS_KILL
            target: crypt_warden
            amount: 1
            description: "Defeat the Crypt Warden"
            hint: "Interrupt the summon phase before the room fills."

Dungeon Entrance NPC Flow

A common premium setup is: NPC gives quest, waypoint sends players to the dungeon, DungeonForge run completes objective, then ForgeQuests opens the next story step.

npcs:
  crypt_guard:
    npc-id: -1
    dialogue: "crypt_guard"
    quest-marker: true
    built-in:
      enabled: true
      entity-type: "VILLAGER"
      display-name: "&6Crypt Guard"
      location: { world: "world", x: 115.5, y: 64.0, z: -42.5, yaw: 90.0, pitch: 0.0 }

Useful Cross-Plugin Commands

Design Pattern