Default random-generator.yml (Premium)
Last updated Oct 28, 2026
Default random-generator.yml
Shipped defaults from SoapsQuest 1.0.7. Edition: Premium only.
After first run, this file lives in plugins/SoapsQuest/. Updating the jar does not overwrite your live copy.
See also: Config Reference · Random Quest Generator
# ##############################################################
# # #
# # SoapsQuest #
# # #
# # Created by: AlternativeSoap #
# # Website: www.SoapsUniverse.com #
# # Support: https://discord.gg/mawAzwFq #
# # #
# ##############################################################
# ════════════════════════════════════════════════════════════════════════════
# SoapsQuest — Random Quest Generator (Premium)
# ════════════════════════════════════════════════════════════════════════════
#
# Commands: /sq generate [type] [count|amount] [objective] [min] [max] [difficulty] [tier] [material]
# After type, a lone number is objective amount (e.g. /sq generate single 20). Use "-" for a random slot.
# Permission: soapsquest.generate
#
# Generated quests save to save-location (default: generated.yml).
# Give papers with /sq give <player> <quest_id> after generating.
#
# ─── OBJECTIVE TEMPLATE FIELDS ───────────────────────────────────────────────
# objective Canonical type (kill, break, collect, bowshoot, …)
# target Entity, block, item, or list thereof
# amount Fixed number or [min, max] range
# amount-by-difficulty Per-difficulty min/max map
#
# ─── REWARDS ─────────────────────────────────────────────────────────────────
# reward-pool uses the same block format as quests.yml.
# When templates are defined, they take priority over tier ranges.
#
# ════════════════════════════════════════════════════════════════════════════
# SETTINGS
# ════════════════════════════════════════════════════════════════════════════
random-generator:
enabled: true
id-prefix: "generated_"
generated-quest-mode: persistent # persistent | temporary | session
save-location: generated.yml
allowed-types: [single, multi, sequence]
internal-name-formats:
single: "quest_<tier>_<objective>_<id>"
multi: "multi_<tier>_<id>"
sequence: "seq_<tier>_<counter>"
default: "generated_<id>"
# ════════════════════════════════════════════════════════════════════════════
# TIER & DIFFICULTY POOLS
# Empty allowed: [] = use all tiers/difficulties from tiers.yml / difficulties.yml
# ════════════════════════════════════════════════════════════════════════════
difficulty-pool:
enabled: true
allowed: []
default: normal
tier-pool:
enabled: true
allowed: []
default: common
milestones:
enabled: true
mode: tier-based # tier-based | random | default
default: [25, 50, 75]
random-pool:
- [50]
- [25, 75]
- [25, 50, 75]
- [33, 66]
tier-based:
common: [50]
uncommon: [50]
rare: [25, 75]
epic: [25, 50, 75]
legendary: [20, 40, 60, 80]
mythic: [20, 40, 60, 80]
# ════════════════════════════════════════════════════════════════════════════
# QUEST STRUCTURE
# ════════════════════════════════════════════════════════════════════════════
multi-objective:
min-objectives: 2
max-objectives: 4
sequence-objective:
min-objectives: 2
max-objectives: 4
objective-weights:
# Combat
kill: 45
bowshoot: 15
damage: 10
death: 3
projectile: 10
kill_mythicmob: 8
# Mining & building
break: 40
place: 25
interact: 8
harvest: 12
# Collection & crafting
collect: 30
craft: 30
smelt: 20
fish: 18
enchant: 12
brew: 12
drop: 10
# Survival
consume: 12
tame: 10
shear: 10
breed: 10
trade: 15
sleep: 10
heal: 10
# Movement
move: 20
jump: 12
vehicle: 8
# Leveling
gainlevel: 15
reachlevel: 10
# Misc
chat: 8
firework: 5
playtime: 6
enter_world: 8
kill_player: 2
advancement: 5
equip: 6
smith: 6
anvil_repair: 4
explore_biome: 6
elytra_fly: 5
xp_pickup: 6
command: 3
placeholder: 2
# ════════════════════════════════════════════════════════════════════════════
# UNLOCK CONDITIONS (random requirements by tier / difficulty)
# ════════════════════════════════════════════════════════════════════════════
conditions:
enabled: true
min-level:
enabled: true
chance: 40
by-tier:
common: 0
uncommon: 3
rare: 10
epic: 25
legendary: 50
mythic: 75
by-difficulty:
easy: 0
normal: 5
hard: 15
expert: 20
nightmare: 30
max-level:
enabled: false
chance: 10
default: 100
min-money:
enabled: true
chance: 25
by-tier:
common: 100
uncommon: 250
rare: 500
epic: 2000
legendary: 10000
mythic: 50000
world:
enabled: false
chance: 15
allowed-worlds:
- world
- world_nether
- world_the_end
gamemode:
enabled: false
chance: 20
allowed-modes:
- SURVIVAL
- ADVENTURE
time:
enabled: false
chance: 10
options:
- DAY
- NIGHT
permission:
enabled: false
chance: 30
by-tier:
common: "soapsquest.tier.common"
uncommon: "soapsquest.tier.uncommon"
rare: "soapsquest.tier.rare"
epic: "soapsquest.tier.epic"
legendary: "soapsquest.tier.legendary"
mythic: "soapsquest.tier.mythic"
cost:
enabled: true
chance: 20
by-tier:
common: 50
uncommon: 150
rare: 250
epic: 1000
legendary: 5000
mythic: 25000
item:
enabled: false
chance: 15
consume-item: true
by-tier:
common: "IRON_INGOT:5"
uncommon: "GOLD_INGOT:5"
rare: "GOLD_INGOT:3"
epic: "DIAMOND:2"
legendary: "NETHERITE_INGOT:1"
mythic: "NETHERITE_INGOT:3"
active-limit:
enabled: false
chance: 5
default: 3
placeholder:
enabled: false
chance: 10
expressions:
- "%player_health% >= 15"
- "%player_food_level% >= 10"
- "%vault_eco_balance% >= 1000"
# ════════════════════════════════════════════════════════════════════════════
# QUEST PAPER MATERIAL
# ════════════════════════════════════════════════════════════════════════════
quest-paper-material:
selection-mode: random
default-material: PAPER
random-pool:
- material: PAPER
weight: 55
- material: MAP
weight: 25
- material: ENCHANTED_BOOK
weight: 15
- material: KNOWLEDGE_BOOK
weight: 5
tier-based:
common:
- PAPER
- MAP
rare:
- MAP
- ENCHANTED_BOOK
epic:
- ENCHANTED_BOOK
- KNOWLEDGE_BOOK
legendary:
- ENCHANTED_BOOK
- KNOWLEDGE_BOOK
- NETHER_STAR
# ════════════════════════════════════════════════════════════════════════════
# DISPLAY — quest names & lore
# Placeholders: <tier>, <tier_prefix>, <tier_color>, <difficulty>, <target>,
# <amount>, <type>, <objective>, <progress>
# ════════════════════════════════════════════════════════════════════════════
display:
lore-style: fancy # simple | detailed | fancy
name-templates:
# Combat
kill:
- "<gradient:#FF5555:#CC0000><target> Slayer</gradient>"
- "<#FF4444>Hunt <white><amount></white> <target>s</#FF4444>"
- "<gradient:#FF0000:#FF5555>Eliminate <white><amount></white> <target></gradient>"
- "<tier_prefix> <gradient:#FF5555:#FF0000><target> Hunter</gradient>"
damage:
- "<gradient:#FF5555:#FFAA00>Damage Dealer</gradient>"
- "<#FF4444>Deal <white><amount></white> damage</#FF4444>"
bowshoot:
- "<gradient:#FFAA00:#FFD700>Archery Challenge</gradient>"
- "<#FFAA00>Shoot <white><amount></white> arrows</#FFAA00>"
- "<tier_prefix> <gradient:#FFAA00:#FFD700>Marksman Trial</gradient>"
# Building
break:
- "<#AAAAAA>Mine <white><amount></white> <target></#AAAAAA>"
- "<gradient:#888888:#FFFFFF><target> Breaker</gradient>"
place:
- "<#55FF55>Place <white><amount></white> <target></#55FF55>"
- "<gradient:#00CC44:#55FF55><target> Builder</gradient>"
# Collection
collect:
- "<#FFAA00>Gather <white><amount></white> <target>s</#FFAA00>"
- "<gradient:#FFD700:#FFAA00><target> Collector</gradient>"
craft:
- "<#00AAAA>Forge <white><amount></white> <target>s</#00AAAA>"
- "<gradient:#55FFFF:#00AAAA>Crafting Order: <white><target></white></gradient>"
fish:
- "<#0000AA>Catch <white><amount></white> <target></#0000AA>"
- "<gradient:#5555FF:#55FFFF>Fishing Contract</gradient>"
# Smelting
smelt:
- "<gradient:#FF8800:#FFCC00>Smelt <white><amount></white> <target></gradient>"
- "<#FF8800>Furnace Duty: <white><target></#FF8800>"
# Enchanting & brewing
enchant:
- "<gradient:#AA00FF:#FF55FF>Enchant <white><amount></white> items</gradient>"
- "<#AA00FF>Arcane Study</#AA00FF>"
brew:
- "<gradient:#FF55FF:#AA00FF>Brew <white><amount></white> potions</gradient>"
- "<#FF55FF>Alchemist's Task</#FF55FF>"
# Animals & Farming
tame:
- "<gradient:#55FF55:#00AA00>Tame <white><amount></white> <target></gradient>"
- "<#55FF55>Animal Whisperer</#55FF55>"
breed:
- "<gradient:#55FF55:#FFAA00>Breed <white><amount></white> <target></gradient>"
- "<#55FF55>Rancher's Task: <white><target></#55FF55>"
shear:
- "<gradient:#FFFFFF:#AAAAAA>Shear <white><amount></white> <target></gradient>"
- "<#AAAAAA>Wool Gatherer</#AAAAAA>"
trade:
- "<gradient:#55FF55:#00FF00>Trade <white><amount></white> times</gradient>"
- "<#55FF55>Merchant's Contract</#55FF55>"
# Survival
consume:
- "<gradient:#FFAA00:#FF5555>Consume <white><amount></white> <target></gradient>"
- "<#FFAA00>Feast or Famine</#FFAA00>"
sleep:
- "<gradient:#5555FF:#000088>Sleep <white><amount></white> nights</gradient>"
- "<#5555FF>Rest Mandate</#5555FF>"
heal:
- "<gradient:#FF5555:#55FF55>Heal <white><amount></white> health</gradient>"
- "<#55FF55>Recovery Mission</#55FF55>"
drop:
- "<#AAAAAA>Drop <white><amount></white> <target></#AAAAAA>"
- "<gradient:#AAAAAA:#555555>Discard Order</#AAAAAA>"
death:
- "<gradient:#555555:#FF5555>Die <white><amount></white> times</gradient>"
- "<#FF5555>Martyrdom</#FF5555>"
# Movement
move:
- "<gradient:#55FFFF:#5555FF>Travel <white><amount></white> blocks</gradient>"
- "<#55FFFF>Exploration Contract</#55FFFF>"
jump:
- "<gradient:#55FF55:#FFFF55>Jump <white><amount></white> times</gradient>"
- "<#55FF55>Leap Challenge</#55FF55>"
vehicle:
- "<gradient:#AAAAAA:#FFFF55>Ride <white><amount></white> blocks</gradient>"
- "<#FFFF55>Vehicle Journey</#FFFF55>"
# Leveling
gainlevel:
- "<gradient:#55FF55:#FFFF55>Gain <white><amount></white> levels</gradient>"
- "<#55FF55>Experience Seeker</#55FF55>"
reachlevel:
- "<gradient:#55FFFF:#55FF55>Reach level <white><amount></white></gradient>"
- "<#55FFFF>Ascension Goal</#55FFFF>"
# Misc
chat:
- "<gradient:#FFFF55:#FFFFFF>Send <white><amount></white> messages</gradient>"
- "<#FFFF55>Chatterbox Challenge</#FFFF55>"
firework:
- "<gradient:#FF55FF:#FF5555>Launch <white><amount></white> fireworks</gradient>"
- "<#FF55FF>Pyrotechnics Display</#FF55FF>"
projectile:
- "<gradient:#FFAA00:#FF5555>Launch <white><amount></white> projectiles</gradient>"
- "<#FFAA00>Throwing Challenge</#FFAA00>"
interact:
- "<gradient:#FFFF55:#FFAA00>Interact <white><amount></white> times</gradient>"
- "<#FFFF55>Interaction Task</#FFFF55>"
playtime:
- "<gradient:#55FFFF:#AAAAAA>Play for <white><amount></white> minutes</gradient>"
- "<#55FFFF>Active Duty</#55FFFF>"
enter_world:
- "<gradient:#AA55FF:#55FFFF>Visit <white><target></white></gradient>"
- "<#AA55FF>World Traveler</#AA55FF>"
kill_player:
- "<gradient:#FF5555:#AA0000>Defeat <white><amount></white> players</gradient>"
- "<#FF5555>Duelist Contract</#FF5555>"
advancement:
- "<gradient:#FFD700:#FFFF55>Earn <white><amount></white> advancements</gradient>"
- "<#FFD700>Achievement Hunt</#FFD700>"
equip:
- "<gradient:#55FF55:#FFAA00>Equip <white><target></white></gradient>"
- "<#55FF55>Gear Up</#55FF55>"
smith:
- "<gradient:#AAAAAA:#FFD700>Smith <white><amount></white> items</gradient>"
- "<#FFD700>Smithing Order</#FFD700>"
harvest:
- "<gradient:#55FF55:#FFFF55>Harvest <white><amount></white> <target></gradient>"
- "<#55FF55>Crop Duty</#55FF55>"
anvil_repair:
- "<gradient:#AAAAAA:#FFFFFF>Repair <white><amount></white> items</gradient>"
- "<#AAAAAA>Anvil Work</#AAAAAA>"
elytra_fly:
- "<gradient:#55FFFF:#FFFFFF>Glide <white><amount></white> blocks</gradient>"
- "<#55FFFF>Elytra Flight</#55FFFF>"
xp_pickup:
- "<gradient:#55FF55:#FFFF55>Collect <white><amount></white> XP</gradient>"
- "<#55FF55>Experience Gatherer</#55FF55>"
command:
- "<gradient:#FFAA00:#FFFF55>Run /<white><target></white></gradient>"
- "<#FFAA00>Command Task</#FFAA00>"
placeholder:
- "<gradient:#AAAAAA:#55FFFF>Reach placeholder goal</gradient>"
- "<#55FFFF>Progress Check</#55FFFF>"
# Fallback for any objective type
generic:
- "<tier_color><tier_prefix> <type> Challenge"
- "<tier_color><type> Challenge"
- "<tier_color>Complete <white><amount></white> <type>"
# ─────────────────────────────────────────────────────────────────────────
# LORE STYLES (Pick one with "lore-style" above)
# ─────────────────────────────────────────────────────────────────────────
# Placeholders: <tier>, <tier_color>, <difficulty>, <objective>, <progress>, <amount>
lore-styles:
# ─── simple ────────────────────────────────────────────────────────────
# Minimal design — gray borders, tier-colored label, task line, progress.
simple:
- "<#AAAAAA><st>\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501</st>"
- "<tier_color>Guild Quest"
- "<#AAAAAA>Tier: <tier> \u2022 Difficulty: <difficulty>"
- ""
- "<#AAAAAA>\u27a4 <objective>"
- ""
- "<#55FF55>Progress: <white><progress><#AAAAAA>/<white><amount>"
- "<#AAAAAA><st>\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501</st>"
# ─── detailed ──────────────────────────────────────────────────────────
# Same structure as simple but borders pick up the tier's color.
detailed:
- "<tier_color><st>\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501</st>"
- "<white>The guild has a task for you."
- "<#AAAAAA>Tier: <tier> \u2022 Difficulty: <difficulty>"
- ""
- "<#AAAAAA>\u27a4 <objective>"
- ""
- "<#55FF55>Progress: <white><progress><#AAAAAA>/<white><amount>"
- "<tier_color><st>\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501</st>"
# ─── fancy ─────────────────────────────────────────────────────────────
# Per-tier flavor text and tier-matched border colors.
# Mirrors the visual style of manually authored quests in quests.yml.
fancy:
common:
- "<#AAAAAA><st>\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501</st>"
- "<white>A task from the guild."
- "<#AAAAAA>Tier: <tier> \u2022 Difficulty: <difficulty>"
- ""
- "<#AAAAAA>\u27a4 <objective>"
- ""
- "<#55FF55>Progress: <white><progress><#AAAAAA>/<white><amount>"
- "<#AAAAAA><st>\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501</st>"
uncommon:
- "<#00AA00><st>\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501</st>"
- "<white>The guild requires your skill."
- "<#AAAAAA>Tier: <tier> \u2022 Difficulty: <difficulty>"
- ""
- "<#AAAAAA>\u27a4 <objective>"
- ""
- "<#55FF55>Progress: <white><progress><#AAAAAA>/<white><amount>"
- "<#00AA00><st>\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501</st>"
rare:
- "<#5555FF><st>\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501</st>"
- "<white>A rare contract has been issued."
- "<#AAAAAA>Tier: <tier> \u2022 Difficulty: <difficulty>"
- ""
- "<#AAAAAA>\u27a4 <objective>"
- ""
- "<#55FF55>Progress: <white><progress><#AAAAAA>/<white><amount>"
- "<#5555FF><st>\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501</st>"
epic:
- "<#AA00FF><st>\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501</st>"
- "<white>An epic challenge looms."
- "<#AAAAAA>Tier: <tier> \u2022 Difficulty: <difficulty>"
- ""
- "<#AAAAAA>\u27a4 <objective>"
- ""
- "<#55FF55>Progress: <white><progress><#AAAAAA>/<white><amount>"
- "<#AA00FF><st>\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501</st>"
legendary:
- "<#FFAA00><st>\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501</st>"
- "<white><bold>A legendary deed is called for.</bold>"
- "<#AAAAAA>Tier: <tier> \u2022 Difficulty: <difficulty>"
- ""
- "<#AAAAAA>\u27a4 <objective>"
- ""
- "<#55FF55>Progress: <white><progress><#AAAAAA>/<white><amount>"
- "<#FFAA00><st>\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501</st>"
mythic:
- "<gradient:#FF55FF:#AA00FF><st>\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501</st></gradient>"
- "<white><bold>A mythic legend demands your service.</bold>"
- "<#AAAAAA>Tier: <tier> \u2022 Difficulty: <difficulty>"
- ""
- "<#AAAAAA>\u27a4 <objective>"
- ""
- "<#55FF55>Progress: <white><progress><#AAAAAA>/<white><amount>"
- "<gradient:#FF55FF:#AA00FF><st>\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501</st></gradient>"
# ════════════════════════════════════════════════════════════════════════════
# OBJECTIVE TEMPLATES
# Keys are internal labels; objective: is the canonical type used at runtime.
# ════════════════════════════════════════════════════════════════════════════
objectives:
kill_hostile:
objective: kill
target: [ZOMBIE, SKELETON, CREEPER, SPIDER]
amount-by-difficulty:
easy: [10, 25]
normal: [20, 40]
hard: [40, 75]
nightmare: [75, 150]
kill_zombies:
objective: kill
target: [ZOMBIE]
amount: [15, 40]
kill_skeletons:
objective: kill
target: [SKELETON]
amount: [10, 35]
kill_creepers:
objective: kill
target: [CREEPER]
amount: [5, 20]
kill_spiders:
objective: kill
target: [SPIDER, CAVE_SPIDER]
amount: [15, 45]
kill_endermen:
objective: kill
target: [ENDERMAN]
amount: [5, 15]
kill_nether_mobs:
objective: kill
target: [BLAZE, WITHER_SKELETON, PIGLIN, ZOMBIFIED_PIGLIN]
amount: [10, 30]
kill_ocean_mobs:
objective: kill
target: [DROWNED, GUARDIAN, ELDER_GUARDIAN]
amount: [8, 25]
kill_bosses:
objective: kill
target: [WITHER, ENDER_DRAGON]
amount: [1, 3]
kill_breeze:
objective: kill
target: [BREEZE]
amount: [5, 15]
kill_armadillo:
objective: kill
target: [ARMADILLO]
amount: [3, 10]
deal_damage:
objective: damage
amount-by-difficulty:
easy: [50, 200]
normal: [100, 500]
hard: [300, 1000]
nightmare: [500, 2000]
shoot_arrows:
objective: bowshoot
amount: [10, 100]
throw_projectiles:
objective: projectile
target: [SNOWBALL, EGG, ENDER_PEARL]
amount: [10, 100]
die_once:
objective: death
amount: [1, 3]
die_many:
objective: death
amount: [5, 15]
# ═══════════════════════════════════════════════════════════════════
# MINING & BUILDING OBJECTIVES
# ═══════════════════════════════════════════════════════════════════
break_stone:
objective: break
target: [STONE, COBBLESTONE, ANDESITE, DIORITE, GRANITE]
amount-by-difficulty:
easy: [30, 80]
normal: [50, 200]
hard: [150, 400]
nightmare: [300, 800]
break_deepslate:
objective: break
target: [DEEPSLATE, COBBLED_DEEPSLATE]
amount: [30, 150]
break_coal_ore:
objective: break
target: [COAL_ORE, DEEPSLATE_COAL_ORE]
amount: [20, 80]
break_iron_ore:
objective: break
target: [IRON_ORE, DEEPSLATE_IRON_ORE]
amount: [10, 40]
break_gold_ore:
objective: break
target: [GOLD_ORE, DEEPSLATE_GOLD_ORE]
amount: [5, 25]
break_diamond_ore:
objective: break
target: [DIAMOND_ORE, DEEPSLATE_DIAMOND_ORE]
amount: [3, 15]
break_netherite:
objective: break
target: [ANCIENT_DEBRIS]
amount: [1, 5]
break_logs:
objective: break
target: [OAK_LOG, BIRCH_LOG, SPRUCE_LOG, JUNGLE_LOG, ACACIA_LOG, DARK_OAK_LOG]
amount: [30, 150]
break_nether_blocks:
objective: break
target: [NETHERRACK, NETHER_BRICKS, BLACKSTONE]
amount: [50, 200]
break_copper_ore:
objective: break
target: [COPPER_ORE, DEEPSLATE_COPPER_ORE]
amount: [20, 80]
break_trial_blocks:
objective: break
target: [TRIAL_SPAWNER, VAULT]
amount: [1, 5]
break_copper_blocks:
objective: break
target: [COPPER_BULB, COPPER_GRATE, COPPER_DOOR, COPPER_TRAPDOOR, CHISELED_COPPER, CUT_COPPER]
amount: [10, 50]
place_blocks:
objective: place
target: [OAK_PLANKS, STONE_BRICKS, COBBLESTONE]
amount: [20, 100]
place_decorations:
objective: place
target: [TORCH, LANTERN, GLOWSTONE, SEA_LANTERN]
amount: [10, 50]
place_rails:
objective: place
target: [RAIL, POWERED_RAIL, DETECTOR_RAIL]
amount: [10, 64]
use_blocks:
objective: interact
target: [CHEST, FURNACE, CRAFTING_TABLE, ANVIL, ENCHANTING_TABLE]
amount: [5, 50]
# ═══════════════════════════════════════════════════════════════════
# COLLECTION & CRAFTING OBJECTIVES
# ═══════════════════════════════════════════════════════════════════
collect_crops:
objective: collect
target: [WHEAT, CARROT, POTATO, BEETROOT]
amount-by-difficulty:
easy: [10, 32]
normal: [16, 64]
hard: [48, 128]
nightmare: [96, 256]
collect_seeds:
objective: collect
target: [WHEAT_SEEDS, PUMPKIN_SEEDS, MELON_SEEDS]
amount: [10, 40]
collect_valuables:
objective: collect
target: [IRON_INGOT, GOLD_INGOT, DIAMOND, EMERALD]
amount: [5, 20]
collect_rare_items:
objective: collect
target: [NETHERITE_INGOT, NETHERITE_SCRAP, NETHER_STAR]
amount: [1, 5]
collect_flowers:
objective: collect
target: [POPPY, DANDELION, BLUE_ORCHID, ALLIUM, AZURE_BLUET]
amount: [10, 50]
collect_mob_drops:
objective: collect
target: [BONE, ROTTEN_FLESH, SPIDER_EYE, GUNPOWDER, ENDER_PEARL]
amount: [10, 50]
collect_copper:
objective: collect
target: [COPPER_INGOT, RAW_COPPER]
amount: [20, 64]
collect_breeze_items:
objective: collect
target: [BREEZE_ROD, WIND_CHARGE]
amount: [5, 20]
collect_trial_items:
objective: collect
target: [TRIAL_KEY, OMINOUS_TRIAL_KEY]
amount: [1, 5]
collect_armadillo_scute:
objective: collect
target: [ARMADILLO_SCUTE]
amount: [5, 20]
craft_tools:
objective: craft
target: [WOODEN_PICKAXE, STONE_PICKAXE, IRON_PICKAXE, DIAMOND_PICKAXE]
amount: [1, 5]
craft_weapons:
objective: craft
target: [WOODEN_SWORD, STONE_SWORD, IRON_SWORD, DIAMOND_SWORD]
amount: [1, 5]
craft_armor:
objective: craft
target: [IRON_HELMET, IRON_CHESTPLATE, IRON_LEGGINGS, IRON_BOOTS]
amount: [1, 4]
craft_blocks:
objective: craft
target: [CRAFTING_TABLE, CHEST, FURNACE, TORCH]
amount: [5, 20]
craft_decorations:
objective: craft
target: [PAINTING, ITEM_FRAME, ARMOR_STAND, BANNER]
amount: [3, 15]
craft_copper_items:
objective: craft
target: [COPPER_BULB, COPPER_GRATE, COPPER_DOOR, COPPER_TRAPDOOR]
amount: [5, 20]
craft_wolf_armor:
objective: craft
target: [WOLF_ARMOR]
amount: [1, 3]
craft_crafter:
objective: craft
target: [CRAFTER]
amount: [1, 5]
smelt_ores:
objective: smelt
target: [IRON_INGOT, GOLD_INGOT, COPPER_INGOT]
amount: [10, 50]
smelt_food:
objective: smelt
target: [COOKED_BEEF, COOKED_PORKCHOP, COOKED_CHICKEN, COOKED_MUTTON]
amount: [10, 40]
smelt_blocks:
objective: smelt
target: [GLASS, BRICK, TERRACOTTA]
amount: [10, 64]
# ═══════════════════════════════════════════════════════════════════
# FISHING & OCEAN OBJECTIVES
# ═══════════════════════════════════════════════════════════════════
catch_fish:
objective: fish
target: [COD, SALMON, TROPICAL_FISH, PUFFERFISH]
amount: [10, 50]
catch_rare_fish:
objective: fish
target: [SALMON, TROPICAL_FISH]
amount: [5, 25]
catch_treasure:
objective: fish
target: [ANY]
amount: [15, 60]
# ═══════════════════════════════════════════════════════════════════
# FARMING & ANIMALS OBJECTIVES
# ═══════════════════════════════════════════════════════════════════
tame_wolves:
objective: tame
target: [WOLF]
amount: [1, 5]
tame_cats:
objective: tame
target: [CAT]
amount: [1, 3]
tame_horses:
objective: tame
target: [HORSE]
amount: [1, 3]
tame_parrots:
objective: tame
target: [PARROT]
amount: [1, 2]
breed_cows:
objective: breed
target: [COW]
amount: [5, 20]
breed_sheep:
objective: breed
target: [SHEEP]
amount: [5, 20]
breed_pigs:
objective: breed
target: [PIG]
amount: [5, 15]
breed_chickens:
objective: breed
target: [CHICKEN]
amount: [5, 25]
breed_horses:
objective: breed
target: [HORSE]
amount: [2, 8]
breed_wolves:
objective: breed
target: [WOLF]
amount: [2, 10]
breed_any:
objective: breed
target: [ANY]
amount: [10, 30]
shear_sheep:
objective: shear
target: [SHEEP]
amount: [10, 40]
trade_villagers:
objective: trade
target: [ANY]
amount: [5, 20]
# ═══════════════════════════════════════════════════════════════════
# ENCHANTING & BREWING OBJECTIVES
# ═══════════════════════════════════════════════════════════════════
enchant_items:
objective: enchant
target: [ANY]
amount: [3, 15]
brew_potions:
objective: brew
target: [ANY]
amount: [5, 20]
# ═══════════════════════════════════════════════════════════════════
# MOVEMENT & EXPLORATION OBJECTIVES
# ═══════════════════════════════════════════════════════════════════
travel_short:
objective: move
amount: [500, 2000]
travel_medium:
objective: move
amount-by-difficulty:
easy: [1000, 3000]
normal: [2000, 5000]
hard: [4000, 8000]
nightmare: [6000, 12000]
travel_long:
objective: move
amount: [5000, 10000]
travel_vehicle:
objective: vehicle
target: [ANY]
amount: [500, 3000]
jump_challenge:
objective: jump
amount: [50, 200]
# ═══════════════════════════════════════════════════════════════════
# LEVELING OBJECTIVES
# ═══════════════════════════════════════════════════════════════════
gain_levels:
objective: gainlevel
amount: [5, 20]
reach_level_10:
objective: reachlevel
amount: [10, 15]
reach_level_20:
objective: reachlevel
amount: [20, 30]
reach_level_30:
objective: reachlevel
amount: [30, 40]
# ═══════════════════════════════════════════════════════════════════
# SURVIVAL & MISC OBJECTIVES
# ═══════════════════════════════════════════════════════════════════
sleep_in_bed:
objective: sleep
amount: [3, 15]
heal_health:
objective: heal
amount: [50, 200]
consume_food:
objective: consume
target: [APPLE, BREAD, COOKED_BEEF, GOLDEN_APPLE]
amount: [10, 50]
drop_items:
objective: drop
target: [DIRT, COBBLESTONE, STICK]
amount: [10, 64]
send_messages:
objective: chat
amount: [10, 50]
launch_fireworks:
objective: firework
amount: [5, 20]
# ═══════════════════════════════════════════════════════════════════
# SPECIAL & EXTREME OBJECTIVES
# ═══════════════════════════════════════════════════════════════════
kill_wither:
objective: kill
target: [WITHER]
amount: [1, 3]
kill_ender_dragon:
objective: kill
target: [ENDER_DRAGON]
amount: [1, 2]
kill_warden:
objective: kill
target: [WARDEN]
amount: [1, 5]
break_obsidian:
objective: break
target: [OBSIDIAN]
amount: [10, 100]
place_end_crystals:
objective: place
target: [END_CRYSTAL]
amount: [1, 4]
collect_end_items:
objective: collect
target: [END_STONE, END_STONE_BRICKS, PURPUR_BLOCK]
amount: [32, 128]
craft_netherite_gear:
objective: craft
target: [NETHERITE_HELMET, NETHERITE_CHESTPLATE, NETHERITE_LEGGINGS, NETHERITE_BOOTS]
amount: [1, 4]
collect_rare_flowers:
objective: collect
target: [WITHER_ROSE, LILY_OF_THE_VALLEY, CHORUS_FLOWER]
amount: [5, 20]
massive_mining:
objective: break
target: [STONE, DEEPSLATE, COBBLESTONE]
amount: [500, 2000]
epic_travel:
objective: move
amount: [10000, 50000]
repair_anvil:
objective: anvil_repair
target: [ANY]
amount: [1, 8]
explore_biomes:
objective: explore_biome
target: [PLAINS, DESERT, FOREST, JUNGLE, SAVANNA, SNOWY_PLAINS]
amount: [1, 3]
elytra_glide:
objective: elytra_fly
amount: [200, 1500]
collect_xp:
objective: xp_pickup
amount: [50, 300]
play_for_minutes:
objective: playtime
amount: [5, 30]
visit_worlds:
objective: enter_world
target: [world, world_nether, world_the_end, NETHER, THE_END]
amount: [1, 2]
player_duels:
objective: kill_player
amount: [1, 3]
earn_advancements:
objective: advancement
target: [ANY]
amount: [1, 3]
wear_gear:
objective: equip
target: [IRON_CHESTPLATE, DIAMOND_CHESTPLATE, GOLDEN_HELMET, NETHERITE_BOOTS]
amount: [1, 1]
smith_items:
objective: smith
target: [ANY]
amount: [1, 5]
harvest_crops:
objective: harvest
target: [WHEAT, CARROTS, POTATOES, BEETROOTS, NETHER_WART]
amount: [16, 64]
run_command:
objective: command
target: [help, spawn]
amount: [1, 3]
placeholder_progress:
objective: placeholder
# %player_level% requires PlaceholderAPI "Player" expansion:
# /papi ecloud download Player
# /papi reload
target: [player_level]
amount: [5, 25]
reward-pool:
# Same reward block format as quests.yml. Templates override tier ranges when present.
templates:
- weight: 35
tiers: [common, uncommon]
min-difficulty: easy
reward:
xp: 80
money: 45
sigils: 15
items:
- material: BREAD
amount: 8
chance: 100
commands:
- "say {player} completed a generated quest."
command-chance: 35
- weight: 25
tiers: [rare, epic]
min-difficulty: normal
reward:
xp: [180, 320]
money: [120, 250]
sigils: [35, 80]
items:
- material: DIAMOND
amount: [1, 3]
chance: 100
- weight: 12
tiers: [legendary, mythic]
min-difficulty: hard
reward:
xp: [450, 900]
money: [400, 1200]
sigils: [100, 300]
quest:
quest-id: diamond_rush
chance: 75
xp:
common: [25, 100]
uncommon: [75, 150]
rare: [100, 250]
epic: [250, 500]
legendary: [400, 800]
mythic: [750, 1500]
money:
common: [10, 100]
uncommon: [50, 150]
rare: [100, 400]
epic: [400, 1000]
legendary: [750, 2000]
mythic: [1500, 4000]
quests:
enabled: true
chance: 15
pool:
# Quest IDs must match entries in quests.yml
- quest-id: lumberjack
tiers: [common, uncommon]
chance: 80
min-difficulty: easy
- quest-id: mob_hunter
tiers: [rare, epic]
chance: 60
min-difficulty: normal
- quest-id: diamond_rush
tiers: [epic, legendary]
chance: 40
min-difficulty: hard
items:
selection-mode: "weighted"
min-items: 1
max-items: 3
pool:
# ═══════════════════════════════════════════════════════
# COMMON TIER REWARDS
# ═══════════════════════════════════════════════════════
- material: COAL
amount: [8, 32]
tiers: [common]
weight: 60
- material: IRON_INGOT
amount: [2, 8]
tiers: [common, uncommon]
weight: 50
- material: BREAD
amount: [8, 16]
tiers: [common]
weight: 55
- material: TORCH
amount: [16, 64]
tiers: [common]
weight: 50
- material: ARROW
amount: [16, 64]
tiers: [common]
weight: 45
- material: LEATHER
amount: [4, 16]
tiers: [common]
weight: 40
- material: COPPER_INGOT
amount: [8, 32]
tiers: [common]
weight: 55
- material: WIND_CHARGE
amount: [4, 16]
tiers: [common, uncommon]
weight: 35
# ═══════════════════════════════════════════════════════
# UNCOMMON TIER REWARDS
# ═══════════════════════════════════════════════════════
- material: IRON_SWORD
amount: 1
name: "&2Uncommon Blade"
enchantments:
- "SHARPNESS:2"
- "UNBREAKING:1"
tiers: [uncommon]
weight: 35
- material: IRON_PICKAXE
amount: 1
name: "&2Miner's Tool"
enchantments:
- "EFFICIENCY:2"
- "UNBREAKING:1"
tiers: [uncommon]
weight: 35
- material: GOLD_INGOT
amount: [2, 6]
tiers: [uncommon, rare]
weight: 35
- material: LAPIS_LAZULI
amount: [16, 32]
tiers: [uncommon]
weight: 30
- material: REDSTONE
amount: [16, 32]
tiers: [uncommon]
weight: 30
# ═══════════════════════════════════════════════════════
# RARE TIER REWARDS
# ═══════════════════════════════════════════════════════
- material: DIAMOND
amount: [1, 3]
tiers: [rare, epic]
weight: 30
- material: ENCHANTED_BOOK
amount: 1
name: "&9Rare Enchantment"
enchantments:
- "EFFICIENCY:3"
tiers: [rare]
weight: 25
- material: GOLDEN_APPLE
amount: [1, 3]
tiers: [rare, epic]
weight: 25
- material: DIAMOND_SWORD
amount: 1
name: "&9Rare Sword"
enchantments:
- "SHARPNESS:3"
- "UNBREAKING:2"
- "LOOTING:1"
tiers: [rare]
weight: 20
- material: DIAMOND_PICKAXE
amount: 1
name: "&9Fortune Pick"
enchantments:
- "EFFICIENCY:3"
- "FORTUNE:2"
- "UNBREAKING:2"
tiers: [rare]
weight: 20
- material: ENDER_PEARL
amount: [4, 12]
tiers: [rare]
weight: 25
- material: BREEZE_ROD
amount: [2, 8]
tiers: [rare, epic]
weight: 20
- material: TRIAL_KEY
amount: [1, 3]
tiers: [rare]
weight: 18
- material: WOLF_ARMOR
amount: 1
name: "&9Armored Companion"
tiers: [rare]
weight: 15
# ═══════════════════════════════════════════════════════
# EPIC TIER REWARDS
# ═══════════════════════════════════════════════════════
- material: NETHERITE_INGOT
amount: [1, 2]
tiers: [epic, legendary]
weight: 15
min-difficulty: hard
- material: DIAMOND_SWORD
amount: 1
name: "&5&lEpic Blade"
lore:
- "&7A powerful weapon"
- "&7for epic adventurers"
enchantments:
- "SHARPNESS:5"
- "UNBREAKING:3"
- "LOOTING:3"
- "FIRE_ASPECT:2"
tiers: [epic]
weight: 12
min-difficulty: normal
- material: DIAMOND_PICKAXE
amount: 1
name: "&5&lEpic Excavator"
lore:
- "&7Mine with epic efficiency"
enchantments:
- "EFFICIENCY:5"
- "FORTUNE:3"
- "UNBREAKING:3"
tiers: [epic]
weight: 12
min-difficulty: normal
- material: ENCHANTED_BOOK
amount: 1
name: "&5Epic Tome"
enchantments:
- "MENDING:1"
tiers: [epic, legendary]
weight: 15
- material: ENCHANTED_GOLDEN_APPLE
amount: [1, 2]
tiers: [epic, legendary]
weight: 10
min-difficulty: hard
- material: TOTEM_OF_UNDYING
amount: 1
tiers: [epic, legendary]
weight: 8
min-difficulty: hard
- material: ELYTRA
amount: 1
name: "&5Epic Wings"
enchantments:
- "UNBREAKING:3"
tiers: [epic]
weight: 5
min-difficulty: hard
- material: OMINOUS_TRIAL_KEY
amount: [1, 2]
name: "&5&lOminous Key"
lore:
- "&7Ominous rewards on completion"
tiers: [epic]
weight: 8
min-difficulty: normal
- material: HEAVY_CORE
amount: 1
name: "&5Heavy Core"
lore:
- "&7Craft the mighty mace"
tiers: [epic, legendary]
weight: 6
min-difficulty: hard
# ═══════════════════════════════════════════════════════
# LEGENDARY TIER REWARDS
# ═══════════════════════════════════════════════════════
- material: NETHERITE_SWORD
amount: 1
name: "&6&l⚔ Legendary Blade ⚔"
lore:
- "&7A weapon of legendary power"
- ""
- "&e▸ &7Sharpness VII"
- "&e▸ &7Looting IV"
- "&e▸ &7Fire Aspect III"
- "&e▸ &7Unbreaking V"
- ""
- "&6&l★ LEGENDARY ★"
enchantments:
- "SHARPNESS:7"
- "LOOTING:4"
- "FIRE_ASPECT:3"
- "UNBREAKING:5"
- "SWEEPING_EDGE:3"
tiers: [legendary]
weight: 8
min-difficulty: hard
- material: NETHERITE_PICKAXE
amount: 1
name: "&6&l⛏ Legendary Excavator ⛏"
lore:
- "&7Mine with legendary power"
- ""
- "&e▸ &7Efficiency VII"
- "&e▸ &7Fortune IV"
- "&e▸ &7Unbreaking V"
- ""
- "&6&l★ LEGENDARY ★"
enchantments:
- "EFFICIENCY:7"
- "FORTUNE:4"
- "UNBREAKING:5"
tiers: [legendary]
weight: 8
min-difficulty: hard
- material: NETHER_STAR
amount: [1, 2]
name: "&6Legendary Star"
tiers: [legendary, mythic]
weight: 6
min-difficulty: nightmare
- material: BEACON
amount: 1
name: "&6Beacon of Legends"
tiers: [legendary]
weight: 4
min-difficulty: nightmare
- material: DRAGON_HEAD
amount: 1
name: "&6Dragon Trophy"
tiers: [legendary]
weight: 3
min-difficulty: nightmare
- material: MACE
amount: 1
name: "&6&l⚔ Legendary Mace ⚔"
lore:
- "&7Crushing force of legends"
- ""
- "&e▸ &7Density V"
- "&e▸ &7Breach IV"
- "&e▸ &7Unbreaking V"
- "&e▸ &7Mending"
- ""
- "&6&l★ LEGENDARY ★"
enchantments:
- "DENSITY:5"
- "BREACH:4"
- "UNBREAKING:5"
- "MENDING:1"
tiers: [legendary]
weight: 7
min-difficulty: hard
# ═══════════════════════════════════════════════════════
# MYTHIC TIER REWARDS
# ═══════════════════════════════════════════════════════
- material: NETHERITE_SWORD
amount: 1
name: "&d&l&o⚔ MYTHIC DESTROYER ⚔"
lore:
- "&7A blade forged from myths"
- "&7and legends alike."
- ""
- "&d▸ &7Sharpness X"
- "&d▸ &7Looting V"
- "&d▸ &7Fire Aspect IV"
- "&d▸ &7Unbreaking VII"
- "&d▸ &7Sweeping Edge V"
- "&d▸ &7Mending"
- ""
- "&d&l✦ MYTHIC WEAPON ✦"
enchantments:
- "SHARPNESS:10"
- "LOOTING:5"
- "FIRE_ASPECT:4"
- "UNBREAKING:7"
- "SWEEPING_EDGE:5"
- "MENDING:1"
flags:
- "HIDE_ENCHANTS"
unbreakable: false
tiers: [mythic]
weight: 5
min-difficulty: nightmare
- material: NETHERITE_PICKAXE
amount: 1
name: "&d&l&o⛏ MYTHIC EXCAVATOR ⛏"
lore:
- "&7Mine through reality itself"
- ""
- "&d▸ &7Efficiency X"
- "&d▸ &7Fortune V"
- "&d▸ &7Unbreaking VII"
- "&d▸ &7Mending"
- ""
- "&d&l✦ MYTHIC TOOL ✦"
enchantments:
- "EFFICIENCY:10"
- "FORTUNE:5"
- "UNBREAKING:7"
- "MENDING:1"
flags:
- "HIDE_ENCHANTS"
tiers: [mythic]
weight: 5
min-difficulty: nightmare
- material: NETHERITE_HELMET
amount: 1
name: "&d&lMythic Crown"
enchantments:
- "PROTECTION:5"
- "UNBREAKING:5"
- "MENDING:1"
tiers: [mythic]
weight: 4
min-difficulty: expert
- material: ENCHANTED_GOLDEN_APPLE
amount: [3, 8]
name: "&dMythic Sustenance"
tiers: [mythic]
weight: 6
min-difficulty: expert
- material: TOTEM_OF_UNDYING
amount: [1, 3]
name: "&dMythic Totem"
tiers: [mythic]
weight: 5
min-difficulty: nightmare
# ════════════════════════════════════════════════════════════════════════════
# TIMER — optional time limit on generated quests (Premium generation only)
# chance: 0 = never timed. Manual quests.yml timer: still works on Free.
# fail-reward-scale clones the generated reward: block with scaled amounts.
# ════════════════════════════════════════════════════════════════════════════
timer:
chance: 0 # 0 = never timed
minutes: [10, 20]
minutes-by-difficulty: # Optional override of minutes:
hard: [8, 12]
start-on: activate # receive | activate (right-click the active paper)
on-expire: fail # fail | consolation | overtime
fail-reward-scale: 0.25 # consolation/overtime: clone full reward: into fail-reward:
# ════════════════════════════════════════════════════════════════════════════
# MYTHICMOBS — pool for kill_mythicmob objectives (requires MythicMobs plugin)
# Mob IDs must match your MythicMobs config exactly.
# ════════════════════════════════════════════════════════════════════════════
mythicmobs:
enabled: false
pool: []
# pool:
# - SkeletalKnight
# - SkeletonKing
# - FireDemon
Still stuck? Ask about this page