Quest Loot System (Premium)

Adds unbound quest papers to chest loot and mob drops.

Premium config files

File	Role
quest-loot.yml	Chest and mob drop chances, worlds, pools, and per-mob overrides
random-generator.yml	Required when a pool uses mode: random or mixed

Edition: Premium only. Free ignores this file. Defaults: Default quest-loot.yml · Hub: Config Reference.

When a paper drops, it is unbound until a player picks it up. Progress binds on first pickup unless the quest uses lock-to-player.

---

Enable

quest-loot:
  enabled: true
  max-per-event: 4
  obey-plugin-restrictions: true

Field	Description
enabled	Master toggle
max-per-event	Cap papers added per loot event
obey-plugin-restrictions	Respect quest permissions and conditions before dropping

---

Chest loot

  chest:
    enabled: true
    chance: 10
    amount:
      min: 1
      max: 2
    worlds:
      - "world"
    allowed-loot-tables:
      - "chests/simple_dungeon"
      - "chests/buried_treasure"
    pool:
      mode: manual
      mixed-ratio: 0.5
      quests:
        - lumberjack
        - zombie_slayer

Field	Description
chance	Percent chance to add papers to a matching chest event
amount.min / amount.max	How many papers to add when the roll succeeds
worlds	Empty list = all worlds
allowed-loot-tables	Substring match on loot table keys; empty = allow all

Pool mode	Behavior
manual	Random quest from pool.quests
random	New quest from random generator
mixed	mixed-ratio chance of random; otherwise manual

---

Mob drops

  mobs:
    enabled: true
    default-chance: 5
    amount:
      min: 1
      max: 1
    worlds:
      - "world"
    pool:
      inherit-chest-quests: true
      # mode: manual   # omit to inherit chest.pool.mode
      # quests: []     # empty + inherit = use chest pool
    types:
      ZOMBIE:
        chance: 12
        amount:
          min: 1
          max: 2
      BLAZE:
        chance: 15

Field	Description
default-chance	Drop chance when the entity is not listed under types
amount	Default paper count range for mobs
types.<ENTITY>	Bukkit EntityType name (UPPER_CASE)
types.<ENTITY>.chance	Overrides default-chance
types.<ENTITY>.amount.min / .max	Optional per-mob amount range

When mobs.pool.quests is empty, mob drops inherit chest pool quests unless inherit-chest-quests: false.

---

How-to checklist

1. Install Premium and confirm quest-loot.yml exists.
2. Set quest-loot.enabled: true.
3. Fill chest.pool.quests (or use mode: random with the generator enabled).
4. Optionally tune mobs.types for bosses vs trash.
5. /sq reload, then generate a dungeon chest or kill a listed mob.

---

Reload

/sq reload refreshes quest-loot.yml. Changes apply to newly generated loot events only.

---

Version 1.0.5 - Premium