Requirements

Requirements lock quests behind conditions. If no requirements section exists in a quest, the quest is always available. All requirements must be met for the quest to unlock.

Requirement Types

QUEST

Requires another quest to be completed first.

requirements:
  - type: QUEST
    quest: BE_A_BAKER           # Quest ID that must be completed
    display: '&cRequires <quest>'  # Text shown when locked

Field	Required	Description
quest	Yes	The quest ID that must be completed first
display	No	Text shown in the locked lore (<quest> = required quest's display name)

PERMISSION

Requires the player to have a specific permission node.

requirements:
  - type: PERMISSION
    permission: myplugin.vote     # Permission node
    display: '&cRequires permission: <permission>'

Field	Required	Description
permission	Yes	The permission node the player must have
display	No	Text shown in the locked lore (<permission> = the permission node)

PLACEHOLDER

Requires a PlaceholderAPI placeholder to match a specific value. Requires PlaceholderAPI on the server.

requirements:
  - type: PLACEHOLDER
    data-type: string       # string, integer, or double
    operator: '=='           # Comparison operator
    input: '%some_placeholder%'
    output: 'value'
    display: '&cRequires condition'

  - type: PLACEHOLDER
    data-type: double
    operator: '>='
    input: '%vault_eco_balance%'
    output: 200
    display: '&cRequires 200 or more balance'

Field	Required	Description
data-type	Yes	The data type to compare: string, integer, or double
operator	Yes	Comparison operator (see below)
input	Yes	PlaceholderAPI placeholder to evaluate
output	Yes	The expected value
display	No	Text shown in the locked lore

Operators by Data Type

Data Type	Supported Operators
string	==, !=
integer	==, !=, >, <, >=, <=
double	==, !=, >, <, >=, <=

How Locked Quests Are Displayed

When a quest is locked:

• The GUI shows the locked item from the category's quests-item.locked section
• The <requirements> placeholder is replaced with each requirement's display text
• The item is typically shown as a BARRIER with red "LOCKED" text

quests-item:
  locked:
    item: BARRIER
    name: '&f<display>'
    lore:
      - ''
      - '<desc>'
      - ''
      - '<requirements>'    # ← Each requirement's display text appears here
      - ''
      - '&4&lLOCKED'

Multiple Requirements

You can have multiple requirements of the same or different types:

requirements:
  - type: QUEST
    quest: BE_A_BAKER
    display: '&cRequires <quest>'
  - type: PERMISSION
    permission: myplugin.vote
    display: '&cRequires permission: <permission>'
  - type: PLACEHOLDER
    data-type: double
    operator: '>='
    input: '%vault_eco_balance%'
    output: 200
    display: '&cRequires 200 or more balance'

All requirements must be satisfied before the quest unlocks.