Quest recipe book

These recipes are independent. Copy one group file and one quest file, then change the IDs and values for your server.

Stonebreaker

Shows: BREAK, several material targets, task messages, and quest messages.

Group file:

options:
  repeatable: false
  sequential-tasks: false
  need-starting: false
  automatically-given: false

automatic-reset: "0 0 * * *"
global-assignment-limit: 1
max-rerolls: 0

Quest file:

quests:
  stonebreaker:
    name: "&e&lStonebreaker"
    description:
      - "&7Break ten stone or cobblestone blocks."
    group: "daily"
    rewards:
      - "[message] &6Stonebreaker complete!"
    tasks:
      1:
        task_type: "BREAK"
        task_description: "&7Broken: &e%task_progress%&8/&e%task_required%"
        required_amount: 10
        required_targets:
          - STONE
          - COBBLESTONE
        task_rewards:
          - "[message] &aTask complete: 10 blocks broken."

Give it with bdq give daily stonebreaker PlayerName.

Ranch hand

Shows: BREED, SHEAR, sequential tasks, and a sheep-color condition.

Group file:

options:
  repeatable: false
  sequential-tasks: true
  need-starting: false
  automatically-given: false

global-assignment-limit: 1
max-rerolls: 0

Quest file:

quests:
  ranch-hand:
    name: "&eRanch Hand"
    group: "ranch"
    options:
      sequential-tasks: true
    rewards:
      - "[message] &6Ranch Hand complete!"
    tasks:
      1:
        task_type: "BREED"
        required_amount: 2
        required_target: COW
        task_rewards:
          - "[message] &aThe cows are ready."
      2:
        task_type: "SHEAR"
        required_amount: 3
        conditions:
          sheep_color: WHITE
        task_rewards:
          - "[message] &aThree white sheep sheared."

The player must breed two cows, then shear three white sheep. BREED is available on Minecraft 1.10 and newer.

Workshop order

Shows: CRAFT, ENCHANT, an enchantment condition, and a console reward.

Group file:

options:
  repeatable: false
  sequential-tasks: true
  need-starting: false
  automatically-given: false

global-assignment-limit: 1
max-rerolls: 0

Quest file:

quests:
  workshop-order:
    name: "&eWorkshop Order"
    group: "workshop"
    options:
      sequential-tasks: true
    rewards:
      - "[console] give %player% diamond 1"
      - "[message] &6Workshop Order complete!"
    tasks:
      1:
        task_type: "CRAFT"
        required_amount: 1
        required_target: IRON_PICKAXE
        task_rewards:
          - "[message] &aIron pickaxe crafted."
      2:
        task_type: "ENCHANT"
        required_amount: 1
        required_target: IRON_PICKAXE
        conditions:
          required_enchants:
            required_level: 1
        task_rewards:
          - "[message] &aIron pickaxe enchanted."

Review the console reward before using it on a public server.

Wayfinder

Shows: LOCATION, a world condition, and a scheduled group reset.

Group file:

options:
  repeatable: true
  sequential-tasks: false
  need-starting: false
  automatically-given: false

automatic-reset: "0 0 * * *"
global-assignment-limit: 1
max-rerolls: 0

Quest file:

quests:
  wayfinder:
    name: "&eWayfinder"
    group: "exploration"
    conditions:
      worlds:
        - world
    rewards:
      - "[message] &6You reached the destination!"
    tasks:
      1:
        task_type: "LOCATION"
        required_location:
          world: world
          x: 100
          y: 64
          z: -25
          distance_from_location: 5

Change the world and coordinates before loading the quest. The world must already be loaded when BDQ reads the file.

Underground miner

Shows: BREAK, a game-mode condition, and an inclusive maximum height.

Group file:

options:
  repeatable: false
  sequential-tasks: false
  need-starting: false
  automatically-given: false

automatic-reset: "0 0 * * *"
global-assignment-limit: 1
max-rerolls: 0

Quest file:

quests:
  underground-miner:
    name: "&e&lUnderground Miner"
    description:
      - "&7Mine stone underground in Survival mode."
    group: "mining"
    rewards:
      - "[message] &6Underground Miner complete!"
    conditions:
      game_modes:
        required:
          - SURVIVAL
        error-message: "&cSwitch to Survival mode."
      height:
        maximum: 32
        error-message: "&cMine at Y 32 or below."
    tasks:
      1:
        task_type: "BREAK"
        task_description: "&7Stone mined: &e%task_progress%&8/&e%task_required%"
        required_amount: 64
        required_targets:
          - STONE
          - COBBLESTONE

The player must be in Survival mode at Y 32 or below when each block breaks.

Test a recipe

1. Put the group and quest files in their matching folders.
2. Run bdq reload.
3. Confirm that both IDs load.
4. Give the quest to an online test player.
5. Test one action that should count and one that should not.
6. Complete the quest and check every reward.

For all accepted task values, open Task type overview.