Loot and Rewards¶

InstancedDungeons supports loot chests, mission keys, boss rewards, trigger rewards, and custom item providers.

Loot Chests¶

Create a loot chest config:

/dungeon edit dragon_lair
/dungeon addlootchest treasure_room
/dungeon lootchest give treasure_room

Add the item in your main hand to the loot table:

/dungeon lootchest loot treasure_room add

Loot chest files live in:

dungeons/<id>/lootchests/<loot_chest_id>.yml

Example:

loot-table:
  - type: VANILLA
    item: DIAMOND
    min-amount: 1
    max-amount: 4
    chance: 50.0

Mission Keys¶

Mission keys use the MISSION type and are guaranteed supply entries.

loot-table:
  - type: MISSION
    item: KEY
    stage: 1
    quantity: 1
    lore:
      - "&7A key used to unlock a dungeon stage."

Mission keys are bound to the instance where they dropped and are removed when the player leaves that instance.

Boss Rewards¶

Open the boss reward editor:

/dungeon boss reward edit

Boss and trigger delivery is controlled by reward-logic:

reward-logic:
  delivery: INVENTORY
  recipients: EVERY_ALIVE

delivery accepts INVENTORY or GROUND.

Recipient	Objective	Allowed delivery
`PARTY_SHARED`	Boss or trigger	`GROUND` only
`LEADER`	Boss or trigger	`INVENTORY` only
`KILLER`	Boss only	`INVENTORY` only
`ACTIVATOR`	Trigger only	`INVENTORY` only
`EVERY_ALIVE`	Boss or trigger	`INVENTORY` or `GROUND`

Invalid combinations block the dungeon from opening and are reported by validation. GROUND + EVERY_ALIVE makes one independent reward roll for every eligible player and creates one public pile at the boss or trigger location. Inventory overflow drops safely at the recipient's location.

Only online, alive party members inside the instance world count for EVERY_ALIVE. Supported custom items follow the same delivery rules as vanilla items.

For existing dungeons, boss rewards keep GROUND + PARTY_SHARED and trigger rewards keep INVENTORY + EVERY_ALIVE unless an administrator changes them.

Reward entries are independent. If you place 4 diamonds in one GUI slot and 2 diamonds in another slot, the plugin saves two separate reward entries.

Trigger Rewards¶

Open the trigger reward editor:

/dungeon trigger reward edit

Trigger rewards are saved in:

dungeons/<id>/trigger.yml

They are given when the configured trigger completes the dungeon.

Example:

rewards:
  enabled: true
  items:
    - type: VANILLA
      item: DIAMOND
      amount: 2
      chance: 100.0

Supported Item Types¶

Type	Description
`VANILLA`	Standard Minecraft item material or special vanilla ID.
`MYTHIC_ITEM`	MythicMobs item ID.
`ITEMSADDER`	ItemsAdder item ID.
`ORAXEN`	Oraxen item ID.
`NEXO`	Nexo item ID.
`MISSION`	Dungeon mission key entry.

Special Vanilla Item IDs¶

Special vanilla IDs work in loot chests, entry costs, stage item payment missions, boss rewards, and trigger rewards.

Supported examples include potions, splash potions, lingering potions, tipped arrows, and enchanted books.

- type: VANILLA
  item: POTION_LONG_POISON
  amount: 1