Quest Chains

Quest chains let you build progression systems where players must complete prerequisite quests before accessing more advanced ones.

How It Works

The requires field in a quest lists the IDs of quests that must be completed first. Any quest with an unmet requirement is hidden from the Available tab and shown in the Locked tab of /quest.

# quests/chapter_2.yml
id: chapter_2
display-name: "<gold>Chapter 2: The Forest"
requires:
  - chapter_1       # Must complete chapter_1 first

Building a Quest Chain

# quests/intro.yml
id: intro
display-name: "<gray>Welcome to the Server"
requires: []    # No prerequisites

# quests/apprentice.yml
id: apprentice
display-name: "<green>The Apprentice"
requires:
  - intro         # Unlocked after intro

# quests/journeyman.yml
id: journeyman
display-name: "<yellow>The Journeyman"
requires:
  - apprentice    # Unlocked after apprentice

# quests/master.yml
id: master
display-name: "<gold>The Master"
requires:
  - journeyman
  - side_quest_1  # Requires TWO quests

Branching Chains

intro
├── combat_path_1  ─── combat_path_2
└── mining_path_1  ─── mining_path_2
                            └── endgame_quest (requires both paths)

# endgame_quest.yml
id: endgame_quest
requires:
  - combat_path_2
  - mining_path_2

GUI Behavior

In the /quest GUI:

Available tab: quests whose prerequisites are all met and which the player has not yet started.
Active tab: quests currently being worked on.
Locked tab: quests with at least one unmet prerequisite, grayed out and showing the missing IDs.
Completed tab: quests already turned in (non-repeatable) or off-cooldown (repeatable).

Repeatable Quest Chains

id: daily_patrol
display-name: "<aqua>Daily Patrol"
requires:
  - main_quest_complete
repeatable: true
repeat-cooldown: 86400    # 24 hours in seconds

The cooldown counter starts when the player turns the quest in.

_{QuestForge is part of the TTS-Studio Minecraft plugin suite.}

Home | Quest Format | Objective Types