Examples

Copy-paste quest examples for common server setups. After editing, run /sq reload.

---

Simple kill quest

zombie_slayer:
  material: ROTTEN_FLESH
  display: "<gradient:#FF5555:#CC0000>Zombie Slayer</gradient>"
  tier: common
  difficulty: easy
  objectives:
    - type: kill
      target: ZOMBIE
      amount: 15
  reward:
    xp: 100
    money: 50

---

Multi-step sequential quest

master_builder:
  display: "<#FFD700>Master Builder"
  tier: epic
  difficulty: hard
  sequential: true
  milestones: [25, 50, 75]
  objectives:
    - type: place
      target: COBBLESTONE
      amount: 50
    - type: craft
      target: STONE_BRICKS
      amount: 20
    - type: place
      target: STONE_BRICKS
      amount: 30
  reward:
    xp: 400
    money: 250

---

VIP-gated quest

vip_hunt:
  display: "<#FFAA00>VIP Hunt"
  tier: rare
  difficulty: normal
  conditions:
    permission: "rank.vip"
  objectives:
    - type: kill
      target: BLAZE
      amount: 10
  reward:
    xp: 300
    sigils: 40

---

Sigil start cost and reward

sigil_contract:
  display: "<#FFD700>Sigil Contract"
  tier: uncommon
  conditions:
    min-sigils: 15
    sigil-cost: 10
  objectives:
    - type: collect
      target: DIAMOND
      amount: 5
  reward:
    sigils: 50
    money: 200

---

Quest chain

chapter_one:
  display: "<#55FF55>Chapter 1"
  objectives:
    - type: break
      target: OAK_LOG
      amount: 16
  reward:
    xp: 50
    quest:
      quest-id: chapter_two
      chance: 100

chapter_two:
  display: "<#55FF55>Chapter 2"
  objectives:
    - type: kill
      target: ZOMBIE
      amount: 10
  reward:
    xp: 100

---

Lock to first player

nether_explorer:
  display: "<#FF5555>Nether Explorer"
  lock-to-player: true
  conditions:
    min-level: 15
  objectives:
    - type: kill
      target: BLAZE
      amount: 25
  reward:
    xp: 750
    money: 400

---

Command and placeholder objectives

community_quest:
  display: "<#FFFF55>Community Check-in"
  objectives:
    - type: chat
      text: "daily"
      amount: 1
    - type: command
      command: help
      amount: 1
    - type: placeholder
      placeholder: player_level
      amount: 10
  reward:
    xp: 75

---

Item reward with enchants

fisher_reward:
  display: "<#55FFFF>Master Angler"
  objectives:
    - type: fish
      target: ANY
      amount: 25
  reward:
    items:
      - material: FISHING_ROD
        name: "<#55FFFF>Lucky Rod"
        enchantments:
          - "LUCK_OF_THE_SEA:2"
          - "LURE:2"
        chance: 100

---

Testing every objective type

Default quests.yml includes showcase_<type> for all objective types (43 vanilla, 61 with integrations):

/sq give <player> showcase_smelt
/sq give <player> showcase_kill_mythicmob

See Objectives for the full type list.

---

Timed hunt (right-click to start)

One timer. The clock starts when the player right-clicks the active paper. Dropping or parking the paper does not pause it. Finish before the deadline for full reward:; overtime uses fail-reward:.

Admin test paper (ships in default quests.yml):

/sq give <player> showcase_timer

Right-click to start a 2-minute timer, then kill 1 zombie. Finish on time for 25 XP, or claim in overtime for 5 XP.

timed_hunt:
  display: "<#FFAA00>Timed Hunt"
  material: CLOCK
  tier: rare
  difficulty: hard
  timer:
    minutes: 15
    start-on: activate
    on-expire: overtime
  objectives:
    - type: kill
      target: ZOMBIE
      amount: 20
  reward:
    xp: 200
    money: 80
  fail-reward:
    xp: 50
    money: 20

---

Version 1.0.5