Default quests.yml

Last updated Oct 28, 2026

Default quests.yml

Shipped defaults from SoapsQuest 1.0.7. Edition: Free and Premium.

After first run, this file lives in plugins/SoapsQuest/. Updating the jar does not overwrite your live copy.

See also: Config Reference · Creating Quests

# ##############################################################
# #                                                            #
# #                      SoapsQuest                            #
# #                                                            #
# #           Created by: AlternativeSoap                      #
# #           Website:    www.SoapsUniverse.com                #
# #           Support:    https://discord.gg/mawAzwFq          #
# #                                                            #
# ##############################################################

# ╔════════════════════════════════════════════════════════════════════════════╗
# ║                        SoapsQuest - Quests                                ║
# ║  Define your server's quests here. Each quest needs a unique ID,          ║
# ║  at least one objective, and at least one reward.                         ║
# ║  Commands: /sq give <player> <quest> | /sq list | /sq browse              ║
# ╚════════════════════════════════════════════════════════════════════════════╝
#
# ════════════════════════════════════════════════════════════════════════════
# QUEST STRUCTURE
# ════════════════════════════════════════════════════════════════════════════
#
#   quest_id:                              # Unique internal ID (lowercase, underscores)
#     display: "<#55FF55>Quest Name"       # Display name (MiniMessage or legacy colors)
#     material: PAPER                      # Optional: Item material for the quest paper
#     tier: common                         # Optional: Tier from config.yml (common/uncommon/rare/epic/legendary)
#     difficulty: easy                     # Optional: Difficulty from config.yml (easy/normal/hard/expert/nightmare)
#     sequential: false                    # Optional: true = objectives must be done in order
#     milestones: [25, 50, 75]             # Optional: Progress % notifications
#     lock-to-player: false                # Optional: true = quest binds to first player
#     lore:                                # Optional: Custom item lore (list of strings)
#       - "<#AAAAAA>Description line 1"
#       - "<#AAAAAA>Description line 2"
#     quest_paper:                         # Optional: Custom quest paper appearance
#       material: BOOK
#       name: "<#FFD700>Custom Name"
#       glowing: false
#
#     objectives:                          # Required: At least 1 objective
#       - type: kill                       # Objective type (see list below)
#         target: ZOMBIE                   # Target entity/block/item
#         amount: 10                       # Amount required
#
#     reward:                              # Required: At least one reward type
#       xp: 100                            # Experience points
#       money: 50                          # Vault economy (requires Vault)
#       sigils: 25                         # SoapsQuest custom Sigils
#       items:                             # Item rewards
#         - material: DIAMOND
#           amount: 5
#           name: "<#55FFFF>Reward Diamond"
#           enchantments: ["SHARPNESS:1"]
#           chance: 100                    # Drop chance percentage
#       commands:                          # Command rewards (use {player} placeholder)
#         - "broadcast {player} completed a quest!"
#
#     conditions:                          # Optional: Requirements to start/unlock (flat keys)
#       min-level: 10                      # Minimum player level
#       min-sigils: 50                     # Minimum SoapsQuest Sigils
#       world: ["world"]                   # Allowed worlds
#       permission: "custom.perm"          # Required permission to pick up in browser
#       require-quest-completed:             # Requires prior quest completions (typed)
#         type: require-quest-completed
#         quests: ["starter_quest"]
#       cost: 500                          # Money cost to unlock (requires Vault)
#       sigil-cost: 100                    # Sigil cost to unlock
#       item: "DIAMOND:5"                  # Item cost to unlock
#       consume-item: true                 # Whether to consume the item cost
#       gamemode: ["SURVIVAL"]             # Required gamemode
#       active-limit: 1                    # Max active quests of this type
#
#     permission: "soapsquest.vip"         # Optional ROOT field: gates progress (not browser lock)
#
#     timer:                               # Optional. Omit for untimed quests.
#       minutes: 15                        # Required if timer: is present. Integer 1-10080.
#       start-on: activate                 # receive = from the moment the paper exists
#                                          # activate = right-click the active paper in hand to start
#       on-expire: fail                    # fail = void, no rewards
#                                          # consolation = fail-reward now, then void
#                                          # overtime = can still finish, claim uses fail-reward
#     fail-reward:                         # Optional. Same keys as reward: (full system).
#       xp: 10
#
# ════════════════════════════════════════════════════════════════════════════
# AVAILABLE OBJECTIVE TYPES (61+) — see showcase_* quests for working examples
# ════════════════════════════════════════════════════════════════════════════
#
#   kill, kill_mythicmob, damage, bowshoot, projectile
#   break, place, smelt, craft, enchant, anvil_repair
#   collect, consume, drop
#   fish, harvest, breed, tame, shear
#   death, sleep, heal, brew
#   move, vehicle, elytra_fly, jump
#   explore_biome
#   reachlevel (uses level:), gainlevel, xp_pickup
#   interact, trade, chat, command, placeholder, firework
#
# Special YAML fields (not target):
#   command     → command: "help"     (+ amount)
#   placeholder → placeholder: player_level  (+ amount; requires PlaceholderAPI)
#   reachlevel  → level: 30
#   vehicle     → vehicle: ANY       (+ amount = blocks; target also accepted)
#   chat        → text: "hello"       (+ amount; optional filter)
#
# Aliases resolved at load: shoot_bow→bowshoot, launch_firework→firework, ride_vehicle→vehicle, level→gainlevel
#
# ════════════════════════════════════════════════════════════════════════════
# EXAMPLE QUEST (uncomment to use)
# ════════════════════════════════════════════════════════════════════════════
#
#   starter_quest:
#     material: BOOK
#     display: "<gradient:#55FF55:#55FFFF>Starter Quest</gradient>"
#     tier: common
#     difficulty: easy
#     lore:
#       - "<#AAAAAA>A simple quest to get started"
#       - "<#AAAAAA>Break logs and kill zombies!"
#     objectives:
#       - type: break
#         target: OAK_LOG
#         amount: 10
#       - type: kill
#         target: ZOMBIE
#         amount: 5
#     reward:
#       xp: 100
#       money: 50
#       items:
#         - material: STONE_SWORD
#           name: "<#55FF55>Starter Sword"
#           enchantments:
#             - "SHARPNESS:1"
#           chance: 100
#

quests:

  # ══════════════════════════════════════════════════════════════════════════
  # STARTER QUESTS - Easy introductory quests
  # ══════════════════════════════════════════════════════════════════════════

  lumberjack:
    material: OAK_LOG
    display: "<gradient:#55FF55:#00CC44>Lumberjack</gradient>"
    tier: common
    difficulty: easy
    lore:
      - "<gradient:#555555:#AAAAAA:#555555><st>━━━━━━━━━━━━━━━━━━━━</st></gradient>"
      - "<#FFFFFF>Chop down some trees!"
      - "<#888888>A simple task for any adventurer."
      - "<#666666><tier>  <#555555>·  <#666666><difficulty>"
      - ""
      - "<gradient:#FFD700:#FFAA00>➤</gradient> <#FFFFFF><objective> <#55FF55>(<progress>/<amount>)"
      - ""
      - "<#55FF55>Rewards <#AAAAAA>· <#FFFFFF>Wooden tools & bread"
      - "<gradient:#555555:#AAAAAA:#555555><st>━━━━━━━━━━━━━━━━━━━━</st></gradient>"
    objectives:
      - type: break
        target: OAK_LOG
        amount: 20
    reward:
      xp: 50
      money: 25
      items:
        - material: STONE_AXE
          name: "<#55FF55>Lumberjack's Axe"
          enchantments:
            - "EFFICIENCY:1"
          chance: 100
        - material: BREAD
          amount: 8
          chance: 100

  zombie_slayer:
    material: ROTTEN_FLESH
    display: "<gradient:#FF5555:#CC0000>Zombie Slayer</gradient>"
    tier: common
    difficulty: easy
    lore:
      - "<gradient:#555555:#AAAAAA:#555555><st>━━━━━━━━━━━━━━━━━━━━</st></gradient>"
      - "<#FFFFFF>The undead are rising!"
      - "<#888888>Slay zombies to protect the village."
      - "<#666666><tier>  <#555555>·  <#666666><difficulty>"
      - ""
      - "<gradient:#FFD700:#FFAA00>➤</gradient> <#FFFFFF><objective> <#55FF55>(<progress>/<amount>)"
      - ""
      - "<#55FF55>Rewards <#AAAAAA>· <#FFFFFF>Iron sword & XP"
      - "<gradient:#555555:#AAAAAA:#555555><st>━━━━━━━━━━━━━━━━━━━━</st></gradient>"
    objectives:
      - type: kill
        target: ZOMBIE
        amount: 15
    reward:
      xp: 100
      money: 50
      items:
        - material: IRON_SWORD
          name: "<#FF5555>Zombie Slayer"
          enchantments:
            - "SHARPNESS:1"
            - "UNBREAKING:1"
          chance: 100

  gone_fishing:
    material: FISHING_ROD
    display: "<gradient:#5555FF:#55FFFF>Gone Fishing</gradient>"
    tier: common
    difficulty: easy
    lore:
      - "<gradient:#555555:#AAAAAA:#555555><st>━━━━━━━━━━━━━━━━━━━━</st></gradient>"
      - "<#FFFFFF>Relax by the water."
      - "<#888888>Catch some fish for dinner."
      - "<#666666><tier>  <#555555>·  <#666666><difficulty>"
      - ""
      - "<gradient:#FFD700:#FFAA00>➤</gradient> <#FFFFFF><objective> <#55FF55>(<progress>/<amount>)"
      - ""
      - "<#55FF55>Rewards <#AAAAAA>· <#FFFFFF>Enchanted fishing rod"
      - "<gradient:#555555:#AAAAAA:#555555><st>━━━━━━━━━━━━━━━━━━━━</st></gradient>"
    objectives:
      - type: fish
        target: ANY
        amount: 10
    reward:
      xp: 75
      money: 40
      items:
        - material: FISHING_ROD
          name: "<#55FFFF>Lucky Rod"
          enchantments:
            - "LUCK_OF_THE_SEA:1"
            - "LURE:1"
          chance: 100
        - material: COOKED_COD
          amount: 8
          chance: 100

  sigil_training:
    material: GOLD_NUGGET
    display: "<gradient:#FFD700:#FFAA00>Currency Training</gradient>"
    tier: common
    difficulty: easy
    lore:
      - "<gradient:#555555:#AAAAAA:#555555><st>━━━━━━━━━━━━━━━━━━━━</st></gradient>"
      - "<#FFFFFF>Earn your first Sigils."
      - "<#666666><tier>  <#555555>·  <#666666><difficulty>"
      - ""
      - "<gradient:#FFD700:#FFAA00>➤</gradient> <#FFFFFF><objective> <#55FF55>(<progress>/<amount>)"
      - ""
      - "<#55FF55>Rewards <#AAAAAA>· <#FFFFFF>Currency + XP"
      - "<gradient:#555555:#AAAAAA:#555555><st>━━━━━━━━━━━━━━━━━━━━</st></gradient>"
    objectives:
      - type: break
        target: OAK_LOG
        amount: 16
    reward:
      xp: 45
      sigils: 20

  sigil_master_contract:
    material: EMERALD
    display: "<gradient:#55FFFF:#55FF55>Currency Master Contract</gradient>"
    tier: uncommon
    difficulty: normal
    lore:
      - "<gradient:#555555:#AAAAAA:#555555><st>━━━━━━━━━━━━━━━━━━━━</st></gradient>"
      - "<#FFFFFF>Spend Sigils to start this contract."
      - "<#666666><tier>  <#555555>·  <#666666><difficulty>"
      - ""
      - "<gradient:#FFD700:#FFAA00>➤</gradient> <#FFFFFF><objective> <#55FF55>(<progress>/<amount>)"
      - ""
      - "<#55FF55>Rewards <#AAAAAA>· <#FFFFFF>Currency + money"
      - "<gradient:#555555:#AAAAAA:#555555><st>━━━━━━━━━━━━━━━━━━━━</st></gradient>"
    objectives:
      - type: kill
        target: ZOMBIE
        amount: 20
      - type: collect
        target: ROTTEN_FLESH
        amount: 16
    conditions:
      min-sigils: 15
      sigil-cost: 10
    reward:
      money: 120
      sigils: 50

  # ══════════════════════════════════════════════════════════════════════════
  # INTERMEDIATE QUESTS - Multi-objective challenges
  # ══════════════════════════════════════════════════════════════════════════

  iron_miner:
    material: IRON_PICKAXE
    display: "<gradient:#AAAAAA:#FFFFFF>Iron Miner</gradient>"
    tier: uncommon
    difficulty: normal
    lore:
      - "<gradient:#555555:#AAAAAA:#555555><st>━━━━━━━━━━━━━━━━━━━━</st></gradient>"
      - "<#FFFFFF>Dig deep for iron!"
      - "<#888888>Mine and smelt iron ore."
      - "<#666666><tier>  <#555555>·  <#666666><difficulty>"
      - ""
      - "<gradient:#FFD700:#FFAA00>➤</gradient> <#FFFFFF><objective> <#55FF55>(<progress>/<amount>)"
      - ""
      - "<#55FF55>Rewards <#AAAAAA>· <#FFFFFF>Iron gear"
      - "<gradient:#555555:#AAAAAA:#555555><st>━━━━━━━━━━━━━━━━━━━━</st></gradient>"
    objectives:
      - type: break
        target:
          - IRON_ORE
          - DEEPSLATE_IRON_ORE
        amount: 30
      - type: smelt
        target: IRON_INGOT
        amount: 20
    reward:
      xp: 200
      money: 100
      items:
        - material: IRON_PICKAXE
          name: "<#FFFFFF>Miner's Pickaxe"
          enchantments:
            - "EFFICIENCY:2"
            - "UNBREAKING:2"
          chance: 100
        - material: IRON_INGOT
          amount: 16
          chance: 100

  mob_hunter:
    material: BOW
    display: "<gradient:#FFAA00:#FF5555>Mob Hunter</gradient>"
    tier: uncommon
    difficulty: normal
    lore:
      - "<gradient:#555555:#AAAAAA:#555555><st>━━━━━━━━━━━━━━━━━━━━</st></gradient>"
      - "<#FFFFFF>Hunt the night creatures."
      - "<#888888>Clear out hostile mobs!"
      - "<#666666><tier>  <#555555>·  <#666666><difficulty>"
      - ""
      - "<gradient:#FFD700:#FFAA00>➤</gradient> <#FFFFFF><objective> <#55FF55>(<progress>/<amount>)"
      - ""
      - "<#55FF55>Rewards <#AAAAAA>· <#FFFFFF>Enchanted bow & arrows"
      - "<gradient:#555555:#AAAAAA:#555555><st>━━━━━━━━━━━━━━━━━━━━</st></gradient>"
    objectives:
      - type: kill
        target: ZOMBIE
        amount: 20
      - type: kill
        target: SKELETON
        amount: 15
      - type: kill
        target: SPIDER
        amount: 10
    reward:
      xp: 250
      money: 150
      items:
        - material: BOW
          name: "<#FFAA00>Hunter's Bow"
          enchantments:
            - "POWER:2"
            - "INFINITY:1"
          chance: 100
        - material: ARROW
          amount: 64
          chance: 100

  baker:
    material: BREAD
    display: "<gradient:#FFD700:#FF8C00>Baker</gradient>"
    tier: common
    difficulty: easy
    lore:
      - "<gradient:#555555:#AAAAAA:#555555><st>━━━━━━━━━━━━━━━━━━━━</st></gradient>"
      - "<#FFFFFF>Bake some fresh bread!"
      - "<#888888>Harvest wheat and craft bread."
      - "<#666666><tier>  <#555555>·  <#666666><difficulty>"
      - ""
      - "<gradient:#FFD700:#FFAA00>➤</gradient> <#FFFFFF><objective> <#55FF55>(<progress>/<amount>)"
      - ""
      - "<#55FF55>Rewards <#AAAAAA>· <#FFFFFF>Golden apples & XP"
      - "<gradient:#555555:#AAAAAA:#555555><st>━━━━━━━━━━━━━━━━━━━━</st></gradient>"
    objectives:
      - type: harvest
        target: WHEAT
        amount: 30
      - type: craft
        target: BREAD
        amount: 10
    reward:
      xp: 100
      money: 60
      items:
        - material: GOLDEN_APPLE
          amount: 2
          chance: 100

  shepherd:
    material: WHITE_WOOL
    display: "<gradient:#FF55FF:#FFAAFF>Shepherd</gradient>"
    tier: common
    difficulty: easy
    lore:
      - "<gradient:#555555:#AAAAAA:#555555><st>━━━━━━━━━━━━━━━━━━━━</st></gradient>"
      - "<#FFFFFF>Tend to the flock!"
      - "<#888888>Shear sheep and collect wool."
      - "<#666666><tier>  <#555555>·  <#666666><difficulty>"
      - ""
      - "<gradient:#FFD700:#FFAA00>➤</gradient> <#FFFFFF><objective> <#55FF55>(<progress>/<amount>)"
      - ""
      - "<#55FF55>Rewards <#AAAAAA>· <#FFFFFF>Colorful wool & shears"
      - "<gradient:#555555:#AAAAAA:#555555><st>━━━━━━━━━━━━━━━━━━━━</st></gradient>"
    objectives:
      - type: shear
        target: SHEEP
        amount: 15
    reward:
      xp: 75
      money: 35
      items:
        - material: SHEARS
          name: "<#FF55FF>Shepherd's Shears"
          enchantments:
            - "EFFICIENCY:2"
            - "UNBREAKING:2"
          chance: 100
        - material: WHITE_WOOL
          amount: 16
          chance: 100
        - material: ORANGE_WOOL
          amount: 8
          chance: 100
        - material: LIGHT_BLUE_WOOL
          amount: 8
          chance: 100

  # ══════════════════════════════════════════════════════════════════════════
  # ADVANCED QUESTS - Harder challenges with better rewards
  # ══════════════════════════════════════════════════════════════════════════

  diamond_rush:
    material: DIAMOND
    display: "<gradient:#55FFFF:#5555FF>Diamond Rush</gradient>"
    tier: rare
    difficulty: hard
    lore:
      - "<gradient:#555555:#AAAAAA:#555555><st>━━━━━━━━━━━━━━━━━━━━</st></gradient>"
      - "<#FFFFFF>Strike it rich!"
      - "<#888888>Mine deep and find diamonds."
      - "<#666666><tier>  <#555555>·  <#666666><difficulty>"
      - ""
      - "<gradient:#FFD700:#FFAA00>➤</gradient> <#FFFFFF><objective> <#55FF55>(<progress>/<amount>)"
      - ""
      - "<#55FF55>Rewards <#AAAAAA>· <#FFFFFF>Enchanted diamond pickaxe"
      - "<gradient:#555555:#AAAAAA:#555555><st>━━━━━━━━━━━━━━━━━━━━</st></gradient>"
    objectives:
      - type: break
        target:
          - DIAMOND_ORE
          - DEEPSLATE_DIAMOND_ORE
        amount: 10
      - type: craft
        target: DIAMOND_PICKAXE
        amount: 1
    reward:
      xp: 500
      money: 300
      items:
        - material: DIAMOND_PICKAXE
          name: "<gradient:#55FFFF:#5555FF>Fortune Seeker</gradient>"
          enchantments:
            - "FORTUNE:3"
            - "EFFICIENCY:3"
            - "UNBREAKING:3"
          chance: 100
        - material: DIAMOND
          amount: 5
          chance: 100

  nether_explorer:
    material: NETHERRACK
    display: "<gradient:#FF5555:#FFAA00>Nether Explorer</gradient>"
    tier: rare
    difficulty: hard
    lock-to-player: true
    milestones: [50]
    lore:
      - "<gradient:#555555:#AAAAAA:#555555><st>━━━━━━━━━━━━━━━━━━━━</st></gradient>"
      - "<#FFFFFF>Venture into the Nether!"
      - "<#888888>Brave the dangers below."
      - "<#666666><tier>  <#555555>·  <#666666><difficulty>"
      - ""
      - "<gradient:#FFD700:#FFAA00>➤</gradient> <#FFFFFF><objective> <#55FF55>(<progress>/<amount>)"
      - ""
      - "<#55FF55>Rewards <#AAAAAA>· <#FFFFFF>Blaze gear & potions"
      - "<gradient:#555555:#AAAAAA:#555555><st>━━━━━━━━━━━━━━━━━━━━</st></gradient>"
    objectives:
      - type: kill
        target: BLAZE
        amount: 25
      - type: collect
        target: NETHER_WART
        amount: 16
      - type: brew
        target: ANY
        amount: 5
    reward:
      xp: 750
      money: 400
      items:
        - material: BLAZE_ROD
          amount: 8
          chance: 100
        - material: EXPERIENCE_BOTTLE
          amount: 16
          chance: 100
    conditions:
      min-level: 15

  master_builder:
    material: BRICKS
    display: "<gradient:#FFD700:#FF8C00>Master Builder</gradient>"
    tier: epic
    difficulty: hard
    sequential: true
    milestones: [25, 50, 75]
    lore:
      - "<gradient:#555555:#AAAAAA:#555555><st>━━━━━━━━━━━━━━━━━━━━</st></gradient>"
      - "<#FFFFFF>Build your way to glory!"
      - "<#888888>Sequential. Complete each step in order."
      - "<#666666><tier>  <#555555>·  <#666666><difficulty>"
      - ""
      - "<gradient:#FFD700:#FFAA00>➤</gradient> <#FFFFFF><objective> <#55FF55>(<progress>/<amount>)"
      - ""
      - "<#55FF55>Rewards <#AAAAAA>· <#FFFFFF>Builder's toolkit"
      - "<gradient:#555555:#AAAAAA:#555555><st>━━━━━━━━━━━━━━━━━━━━</st></gradient>"
    objectives:
      - type: place
        target: COBBLESTONE
        amount: 50
      - type: craft
        target: STONE_BRICKS
        amount: 20
      - type: place
        target: STONE_BRICKS
        amount: 30
      - type: craft
        target: GLASS_PANE
        amount: 10
    reward:
      xp: 400
      money: 250
      items:
        - material: DIAMOND_AXE
          name: "<gradient:#FFD700:#FF8C00>Builder's Axe</gradient>"
          enchantments:
            - "EFFICIENCY:4"
            - "UNBREAKING:3"
          chance: 100
        - material: GOLDEN_APPLE
          amount: 3
          chance: 100

  # ══════════════════════════════════════════════════════════════════════════
  # SHOWCASE - one test quest per objective type (admin use)
  # Give with: /sq give <player> showcase_<type>
  # Omit custom lore — papers use messages.yml quest-default-lore (live progress)
  # ══════════════════════════════════════════════════════════════════════════

  showcase_kill:
    permission: soapsquest.admin
    material: IRON_SWORD
    display: "<#AAAAAA>Showcase: <#55FF55>Kill"
    tier: common
    difficulty: easy
    objectives:
      - type: kill
        target: ZOMBIE
        amount: 1
    reward:
      xp: 10

  showcase_break:
    permission: soapsquest.admin
    material: DIAMOND_PICKAXE
    display: "<#AAAAAA>Showcase: <#55FF55>Break"
    tier: common
    difficulty: easy
    objectives:
      - type: break
        target: OAK_LOG
        amount: 1
    reward:
      xp: 10

  showcase_place:
    permission: soapsquest.admin
    material: COBBLESTONE
    display: "<#AAAAAA>Showcase: <#55FF55>Place"
    tier: common
    difficulty: easy
    objectives:
      - type: place
        target: COBBLESTONE
        amount: 1
    reward:
      xp: 10

  showcase_collect:
    permission: soapsquest.admin
    material: DIRT
    display: "<#AAAAAA>Showcase: <#55FF55>Collect"
    tier: common
    difficulty: easy
    objectives:
      - type: collect
        target: DIRT
        amount: 1
    reward:
      xp: 10

  showcase_craft:
    permission: soapsquest.admin
    material: CRAFTING_TABLE
    display: "<#AAAAAA>Showcase: <#55FF55>Craft"
    tier: common
    difficulty: easy
    objectives:
      - type: craft
        target: STICK
        amount: 1
    reward:
      xp: 10

  showcase_smelt:
    permission: soapsquest.admin
    material: FURNACE
    display: "<#AAAAAA>Showcase: <#55FF55>Smelt"
    tier: common
    difficulty: easy
    objectives:
      - type: smelt
        target: IRON_INGOT
        amount: 1
    reward:
      xp: 10

  showcase_fish:
    permission: soapsquest.admin
    material: FISHING_ROD
    display: "<#AAAAAA>Showcase: <#55FF55>Fish"
    tier: common
    difficulty: easy
    objectives:
      - type: fish
        target: ANY
        amount: 1
    reward:
      xp: 10

  showcase_enchant:
    permission: soapsquest.admin
    material: ENCHANTING_TABLE
    display: "<#AAAAAA>Showcase: <#55FF55>Enchant"
    tier: common
    difficulty: easy
    objectives:
      - type: enchant
        target: ANY
        amount: 1
    reward:
      xp: 10

  showcase_consume:
    permission: soapsquest.admin
    material: BREAD
    display: "<#AAAAAA>Showcase: <#55FF55>Consume"
    tier: common
    difficulty: easy
    objectives:
      - type: consume
        target: BREAD
        amount: 1
    reward:
      xp: 10

  showcase_tame:
    permission: soapsquest.admin
    material: BONE
    display: "<#AAAAAA>Showcase: <#55FF55>Tame"
    tier: common
    difficulty: easy
    objectives:
      - type: tame
        target: WOLF
        amount: 1
    reward:
      xp: 10

  showcase_trade:
    permission: soapsquest.admin
    material: EMERALD
    display: "<#AAAAAA>Showcase: <#55FF55>Trade"
    tier: common
    difficulty: easy
    objectives:
      - type: trade
        target: ANY
        amount: 1
    reward:
      xp: 10

  showcase_brew:
    permission: soapsquest.admin
    material: BREWING_STAND
    display: "<#AAAAAA>Showcase: <#55FF55>Brew"
    tier: common
    difficulty: easy
    objectives:
      - type: brew
        target: ANY
        amount: 1
    reward:
      xp: 10

  showcase_breed:
    permission: soapsquest.admin
    material: WHEAT
    display: "<#AAAAAA>Showcase: <#55FF55>Breed"
    tier: common
    difficulty: easy
    objectives:
      - type: breed
        target: COW
        amount: 1
    reward:
      xp: 10

  showcase_shear:
    permission: soapsquest.admin
    material: SHEARS
    display: "<#AAAAAA>Showcase: <#55FF55>Shear"
    tier: common
    difficulty: easy
    objectives:
      - type: shear
        target: SHEEP
        amount: 1
    reward:
      xp: 10

  showcase_sleep:
    permission: soapsquest.admin
    material: RED_BED
    display: "<#AAAAAA>Showcase: <#55FF55>Sleep"
    tier: common
    difficulty: easy
    objectives:
      - type: sleep
        amount: 1
    reward:
      xp: 10

  showcase_heal:
    permission: soapsquest.admin
    material: GOLDEN_APPLE
    display: "<#AAAAAA>Showcase: <#55FF55>Heal"
    tier: common
    difficulty: easy
    objectives:
      - type: heal
        amount: 5
    reward:
      xp: 10

  showcase_drop:
    permission: soapsquest.admin
    material: DIRT
    display: "<#AAAAAA>Showcase: <#55FF55>Drop"
    tier: common
    difficulty: easy
    objectives:
      - type: drop
        target: DIRT
        amount: 1
    reward:
      xp: 10

  showcase_damage:
    permission: soapsquest.admin
    material: DIAMOND_SWORD
    display: "<#AAAAAA>Showcase: <#55FF55>Damage"
    tier: common
    difficulty: easy
    objectives:
      - type: damage
        amount: 10
    reward:
      xp: 10

  showcase_death:
    permission: soapsquest.admin
    material: SKELETON_SKULL
    display: "<#AAAAAA>Showcase: <#55FF55>Death"
    tier: common
    difficulty: easy
    objectives:
      - type: death
        amount: 1
    reward:
      xp: 10

  showcase_reachlevel:
    permission: soapsquest.admin
    material: EXPERIENCE_BOTTLE
    display: "<#AAAAAA>Showcase: <#55FF55>Reach Level"
    tier: common
    difficulty: easy
    objectives:
      - type: reachlevel
        level: 5
    reward:
      xp: 10

  showcase_gainlevel:
    permission: soapsquest.admin
    material: EXPERIENCE_BOTTLE
    display: "<#AAAAAA>Showcase: <#55FF55>Gain Level"
    tier: common
    difficulty: easy
    objectives:
      - type: gainlevel
        amount: 2
    reward:
      xp: 10

  showcase_move:
    permission: soapsquest.admin
    material: LEATHER_BOOTS
    display: "<#AAAAAA>Showcase: <#55FF55>Move"
    tier: common
    difficulty: easy
    objectives:
      - type: move
        amount: 50
    reward:
      xp: 10

  showcase_jump:
    permission: soapsquest.admin
    material: RABBIT_FOOT
    display: "<#AAAAAA>Showcase: <#55FF55>Jump"
    tier: common
    difficulty: easy
    objectives:
      - type: jump
        amount: 5
    reward:
      xp: 10

  showcase_chat:
    permission: soapsquest.admin
    material: BOOK
    display: "<#AAAAAA>Showcase: <#55FF55>Chat"
    tier: common
    difficulty: easy
    objectives:
      - type: chat
        text: "showcase"
        amount: 1
    reward:
      xp: 10

  showcase_interact:
    permission: soapsquest.admin
    material: CRAFTING_TABLE
    display: "<#AAAAAA>Showcase: <#55FF55>Interact"
    tier: common
    difficulty: easy
    objectives:
      - type: interact
        target: CRAFTING_TABLE
        amount: 1
    reward:
      xp: 10

  showcase_bowshoot:
    permission: soapsquest.admin
    material: BOW
    display: "<#AAAAAA>Showcase: <#55FF55>Bow Shoot"
    tier: common
    difficulty: easy
    objectives:
      - type: bowshoot
        amount: 3
    reward:
      xp: 10

  showcase_projectile:
    permission: soapsquest.admin
    material: SNOWBALL
    display: "<#AAAAAA>Showcase: <#55FF55>Projectile"
    tier: common
    difficulty: easy
    objectives:
      - type: projectile
        target: SNOWBALL
        amount: 1
    reward:
      xp: 10

  showcase_firework:
    permission: soapsquest.admin
    material: FIREWORK_ROCKET
    display: "<#AAAAAA>Showcase: <#55FF55>Firework"
    tier: common
    difficulty: easy
    objectives:
      - type: firework
        amount: 1
    reward:
      xp: 10

  showcase_vehicle:
    permission: soapsquest.admin
    material: MINECART
    display: "<#AAAAAA>Showcase: <#55FF55>Vehicle"
    tier: common
    difficulty: easy
    objectives:
      - type: vehicle
        vehicle: ANY
        amount: 100
    reward:
      xp: 10

  showcase_harvest:
    permission: soapsquest.admin
    material: WHEAT
    display: "<#AAAAAA>Showcase: <#55FF55>Harvest"
    tier: common
    difficulty: easy
    objectives:
      - type: harvest
        target: WHEAT
        amount: 1
    reward:
      xp: 10

  showcase_elytra_fly:
    permission: soapsquest.admin
    material: FEATHER
    display: "<#AAAAAA>Showcase: <#55FF55>Elytra Fly"
    tier: common
    difficulty: easy
    objectives:
      - type: elytra_fly
        amount: 50
    reward:
      xp: 10

  showcase_explore_biome:
    permission: soapsquest.admin
    material: MAP
    display: "<#AAAAAA>Showcase: <#55FF55>Explore Biome"
    tier: common
    difficulty: easy
    objectives:
      - type: explore_biome
        target: PLAINS
        amount: 1
    reward:
      xp: 10

  showcase_xp_pickup:
    permission: soapsquest.admin
    material: EXPERIENCE_BOTTLE
    display: "<#AAAAAA>Showcase: <#55FF55>XP Pickup"
    tier: common
    difficulty: easy
    objectives:
      - type: xp_pickup
        amount: 50
    reward:
      xp: 10

  showcase_anvil_repair:
    permission: soapsquest.admin
    material: ANVIL
    display: "<#AAAAAA>Showcase: <#55FF55>Anvil Repair"
    tier: common
    difficulty: easy
    objectives:
      - type: anvil_repair
        amount: 1
    reward:
      xp: 10

  showcase_command:
    permission: soapsquest.admin
    material: COMMAND_BLOCK
    display: "<#AAAAAA>Showcase: <#55FF55>Command"
    tier: common
    difficulty: easy
    objectives:
      - type: command
        command: help
        amount: 1
    reward:
      xp: 10

  showcase_placeholder:
    permission: soapsquest.admin
    material: NAME_TAG
    display: "<#AAAAAA>Showcase: <#55FF55>Placeholder"
    tier: common
    difficulty: easy
    objectives:
      - type: placeholder
        # %player_level% requires PlaceholderAPI "Player" expansion:
        # /papi ecloud download Player
        # /papi reload
        placeholder: player_level
        amount: 5
    reward:
      xp: 10

  showcase_kill_mythicmob:
    permission: soapsquest.admin
    material: NETHER_STAR
    display: "<#AAAAAA>Showcase: <#55FF55>Kill MythicMob"
    tier: common
    difficulty: easy
    objectives:
      - type: kill_mythicmob
        target: YourMobName
        amount: 1
    reward:
      xp: 10

  showcase_playtime:
    permission: soapsquest.admin
    material: CLOCK
    display: "<#AAAAAA>Showcase: <#55FF55>Playtime"
    tier: common
    difficulty: easy
    objectives:
      - type: playtime
        amount: 2
    reward:
      xp: 10

  showcase_enter_world:
    permission: soapsquest.admin
    material: OBSIDIAN
    display: "<#AAAAAA>Showcase: <#55FF55>Enter World"
    tier: common
    difficulty: easy
    objectives:
      - type: enter_world
        target: NETHER
        amount: 1
    reward:
      xp: 10

  showcase_timer:
    permission: soapsquest.admin
    material: CLOCK
    display: "<#AAAAAA>Showcase: <#FFD700>Timed Quest"
    tier: common
    difficulty: easy
    timer:
      minutes: 2
      start-on: activate
      on-expire: overtime
    objectives:
      - type: kill
        target: ZOMBIE
        amount: 1
    reward:
      xp: 25
    fail-reward:
      xp: 5

  # Showcase quests omit custom lore: on paper they use messages.yml quest-default-lore.

  showcase_kill_player:
    permission: soapsquest.admin
    material: DIAMOND_SWORD
    display: "<#AAAAAA>Showcase: <#55FF55>Kill Player"
    tier: common
    difficulty: easy
    objectives:
      - type: kill_player
        amount: 1
    reward:
      xp: 10

  showcase_advancement:
    permission: soapsquest.admin
    material: KNOWLEDGE_BOOK
    display: "<#AAAAAA>Showcase: <#55FF55>Advancement"
    tier: common
    difficulty: easy
    objectives:
      - type: advancement
        target: minecraft:story/mine_stone
        amount: 1
    reward:
      xp: 10

  showcase_equip:
    permission: soapsquest.admin
    material: DIAMOND_CHESTPLATE
    display: "<#AAAAAA>Showcase: <#55FF55>Equip"
    tier: common
    difficulty: easy
    objectives:
      - type: equip
        target: DIAMOND_CHESTPLATE
        slot: CHEST
        amount: 1
    reward:
      xp: 10

  showcase_smith:
    permission: soapsquest.admin
    material: SMITHING_TABLE
    display: "<#AAAAAA>Showcase: <#55FF55>Smith"
    tier: common
    difficulty: easy
    objectives:
      - type: smith
        target: ANY
        amount: 1
    reward:
      xp: 10

  showcase_wg_enter_region:
    permission: soapsquest.admin
    material: IRON_BARS
    display: "<#AAAAAA>Showcase: <#55FF55>WG Enter Region"
    tier: common
    difficulty: easy
    objectives:
      - type: wg_enter_region
        target: spawn
        amount: 1
    reward:
      xp: 10

  showcase_lands_enter_land:
    permission: soapsquest.admin
    material: GRASS_BLOCK
    display: "<#AAAAAA>Showcase: <#55FF55>Lands Enter"
    tier: common
    difficulty: easy
    objectives:
      - type: lands_enter_land
        target: MyLand
        amount: 1
    reward:
      xp: 10

  showcase_citizens_talk_npc:
    permission: soapsquest.admin
    material: VILLAGER_SPAWN_EGG
    display: "<#AAAAAA>Showcase: <#55FF55>Talk NPC"
    tier: common
    difficulty: easy
    objectives:
      - type: citizens_talk_npc
        target: "1"
        amount: 1
    reward:
      xp: 10

  showcase_mcmmo_skill_level:
    permission: soapsquest.admin
    material: EXPERIENCE_BOTTLE
    display: "<#AAAAAA>Showcase: <#55FF55>mcMMO Skill"
    tier: common
    difficulty: easy
    objectives:
      - type: mcmmo_skill_level
        target: MINING
        amount: 5
    reward:
      xp: 10

  showcase_denizen_run:
    permission: soapsquest.admin
    material: COMMAND_BLOCK
    display: "<#AAAAAA>Showcase: <#55FF55>Denizen Run"
    tier: common
    difficulty: easy
    objectives:
      - type: denizen_run
        target: my_script
        amount: 1
    reward:
      xp: 10

  showcase_wg_leave_region:
    permission: soapsquest.admin
    material: IRON_DOOR
    display: "<#AAAAAA>Showcase: <#55FF55>WG Leave Region"
    tier: common
    difficulty: easy
    objectives:
      - type: wg_leave_region
        target: spawn
        amount: 1
    reward:
      xp: 10

  showcase_wg_time_in_region:
    permission: soapsquest.admin
    material: CLOCK
    display: "<#AAAAAA>Showcase: <#55FF55>WG Time In Region"
    tier: common
    difficulty: easy
    objectives:
      - type: wg_time_in_region
        target: spawn
        amount: 60
    reward:
      xp: 10

  showcase_lands_visit_land:
    permission: soapsquest.admin
    material: OAK_BOAT
    display: "<#AAAAAA>Showcase: <#55FF55>Lands Visit"
    tier: common
    difficulty: easy
    objectives:
      - type: lands_visit_land
        target: MyLand
        amount: 1
    reward:
      xp: 10

  showcase_lands_claim_chunks:
    permission: soapsquest.admin
    material: GOLDEN_SHOVEL
    display: "<#AAAAAA>Showcase: <#55FF55>Lands Claim"
    tier: common
    difficulty: easy
    objectives:
      - type: lands_claim_chunks
        target: ANY
        amount: 1
    reward:
      xp: 10

  showcase_lands_land_level:
    permission: soapsquest.admin
    material: BEACON
    display: "<#AAAAAA>Showcase: <#55FF55>Lands Level"
    tier: common
    difficulty: easy
    objectives:
      - type: lands_land_level
        target: MyLand
        level: 5
    reward:
      xp: 10

  showcase_lands_deposit:
    permission: soapsquest.admin
    material: GOLD_INGOT
    display: "<#AAAAAA>Showcase: <#55FF55>Lands Deposit"
    tier: common
    difficulty: easy
    objectives:
      - type: lands_deposit
        target: MyLand
        amount: 100
    reward:
      xp: 10

  showcase_lands_member_count:
    permission: soapsquest.admin
    material: PLAYER_HEAD
    display: "<#AAAAAA>Showcase: <#55FF55>Lands Members"
    tier: common
    difficulty: easy
    objectives:
      - type: lands_member_count
        target: MyLand
        amount: 3
    reward:
      xp: 10

  showcase_citizens_deliver_npc:
    permission: soapsquest.admin
    material: CHEST
    display: "<#AAAAAA>Showcase: <#55FF55>Deliver to NPC"
    tier: common
    difficulty: easy
    objectives:
      - type: citizens_deliver_npc
        target: "1"
        item: WHEAT:16
        amount: 1
    reward:
      xp: 10

  showcase_citizens_kill_npc:
    permission: soapsquest.admin
    material: IRON_SWORD
    display: "<#AAAAAA>Showcase: <#55FF55>Kill NPC"
    tier: common
    difficulty: easy
    objectives:
      - type: citizens_kill_npc
        target: "1"
        amount: 1
    reward:
      xp: 10

  showcase_mcmmo_skill_gain:
    permission: soapsquest.admin
    material: DIAMOND_PICKAXE
    display: "<#AAAAAA>Showcase: <#55FF55>mcMMO Skill Gain"
    tier: common
    difficulty: easy
    objectives:
      - type: mcmmo_skill_gain
        target: MINING
        amount: 100
    reward:
      xp: 10

  showcase_mcmmo_power_level:
    permission: soapsquest.admin
    material: NETHER_STAR
    display: "<#AAAAAA>Showcase: <#55FF55>mcMMO Power Level"
    tier: common
    difficulty: easy
    objectives:
      - type: mcmmo_power_level
        amount: 100
    reward:
      xp: 10

  showcase_mcmmo_ability:
    permission: soapsquest.admin
    material: BLAZE_POWDER
    display: "<#AAAAAA>Showcase: <#55FF55>mcMMO Ability"
    tier: common
    difficulty: easy
    objectives:
      - type: mcmmo_ability
        target: SUPER_BREAKER
        amount: 1
    reward:
      xp: 10

  showcase_mcmmo_xp_gain:
    permission: soapsquest.admin
    material: LAPIS_LAZULI
    display: "<#AAAAAA>Showcase: <#55FF55>mcMMO XP Gain"
    tier: common
    difficulty: easy
    objectives:
      - type: mcmmo_xp_gain
        target: MINING
        amount: 500
    reward:
      xp: 10

# ════════════════════════════════════════════════════════════════════════════
# CITIZENS NPC QUEST ASSIGNMENTS
# Requires integrations.citizens: true in config.yml
# Link NPCs to quests on right-click — or use /sq npc link
# ════════════════════════════════════════════════════════════════════════════
#
# citizens-npcs:
#   "42":                    # NPC id (Citizens /npc id) or NPC display name
#     quest: tutorial_quest  # Quest id from the quests section above
#     message: "&aHere is your quest!"
#   "Quest Giver":
#     quest: daily_hunt
#     message: "&eGood luck!"

citizens-npcs: {}

Still stuck? Ask about this page