Quest Loot System (Premium)

Quest loot adds unbound quest papers to natural chest loot and mob drops. When a player picks up the paper for the first time, it binds to them and enters their quest queue like a normal paper.

Configure plugins/SoapsQuest/quest-loot.yml. Premium only.

---

Master toggle

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

Field	Description
max-per-event	Caps papers added per single loot roll
obey-plugin-restrictions	When true, respects quest permissions and start conditions before dropping

---

Chest loot

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

Field	Description
chance	Percent chance per chest open
amount.min / amount.max	Papers per roll (amount-min / amount-max also supported)
worlds	Empty list = all worlds
allowed-loot-tables	Substring match on loot table keys
pool.mode	manual, random, or mixed
pool.quests	Quest ID pool for manual/mixed modes
pool.mixed-ratio	0.0–1.0 probability each roll uses random (remainder uses manual)

Legacy source-mode and flat quests under chest still work.

Source modes

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          # optional; inherits chest.pool.mode when omitted
    # quests: []            # optional; uses chest pool when empty + inherit true
  types:
    ZOMBIE:
      chance: 12
      amount-min: 1
      amount-max: 2
    ENDER_DRAGON:
      chance: 100
      amount-min: 3
      amount-max: 6

Entity names must match Bukkit EntityType values in UPPER_CASE. Per-type chance overrides default-chance. Unknown entity names are logged and skipped on load.

When pool.quests is empty and inherit-chest-quests is true (default), mob drops use the chest quest pool.

---

Setup checklist

1. Premium JAR installed.
2. Set quest-loot.enabled: true.
3. Fill chest.pool.quests with valid quest IDs from quests.yml.
4. Tune chance and mob types for your economy.
5. /sq reload
6. Test by opening dungeon chests or killing configured mobs in allowed worlds.

For dynamically generated loot papers, set pool.mode: random and ensure random-generator.yml is enabled.

---

Version 1.1.0 - Premium