module drops

🎁 Drops Module

The Drops Module allows you to configure loot tables that roll items, currency, or actions when mobs are killed. These tables can be linked to both vanilla and MythicMobs.

---

📦 How It Works

Each drop table is defined as a YAML file in:

plugins/Divinity/modules/drops/

These are then linked to mobs using mob linkage files which assign one or more drop tables to specific mobs.

---

🔗 Linking Drops to Mobs

To link a mob to a drop table, use a linkage file:

chance: 100.0
roll-once: true
vanilla-mobs: []
mythic-mobs:
  - 'drownedofficer'
prevent-from: []
drop-tables:
  - drownedofficer

Field	Description
chance	Chance (in %) that the drop tables will be activated
roll-once	If true, only one drop from the pool is rolled
vanilla-mobs	Bukkit entity names (e.g., ZOMBIE, SKELETON, etc.)
mythic-mobs	MythicMobs internal names (plugin required)
drop-tables	List of drop table file names (no .yml extension)
prevent-from	Optional blacklist of modules that can't trigger the drop

---

🧰 Drop Table Format

Example: drownedofficer.yml

name: '&fDrowned Officer'
roll-once: false

level-penalty:
  enabled: false
  variance: 10

world-whitelist:
  - '*'
biome-whitelist:
  - '*'
region-blacklist: []

non-items:
  money:
    chance: 100.0
    min-amount: 600
    max-amount: 1675
    allow-decimals: false

items:
  drownedspores:
    chance: 30.0
    module-id: 'custom_items'
    item-id: 'drownedspores'
    min-amount: 1
    max-amount: 2
    min-level: '1'
    max-level: '1'
    additional-conditions: []
    actions-on-drop: {}

  mithrilkey:
    chance: 1.0
    module-id: 'custom_items'
    item-id: 'mithrilkey'
    min-amount: 1
    max-amount: 1
    min-level: '1'
    max-level: '1'
    additional-conditions: []
    actions-on-drop: {}

---

💰 Non-Item Rewards

non-items:
  money:
    chance: 100.0
    min-amount: 600
    max-amount: 1675
    allow-decimals: false

This provides currency directly to the killer, rolled based on the chance and min/max-amount.

---

🎁 Item Drops

Field	Description
chance	% chance the item will drop
module-id	The module the item belongs to (e.g., custom_items)
item-id	File name of the item definition (no .yml)
min/max-amount	Quantity range of the item
min/max-level	Levels at which the item can roll
additional-conditions	Optional conditions from the Actions system
actions-on-drop	Optional particle, command, or effect triggers

---

🎯 Drop Mechanics

• Items roll independently unless roll-once: true.
• You can blacklist regions with region-blacklist.
• world-whitelist and biome-whitelist allow environment-based loot control.
• Level penalty can scale down drops when over-leveled.

---

🔧 Commands & Permissions

Command	Description	Permission
/drops drop <player> <table_id> [level]	Roll a drop table and drop result at the player's feet	divinity.drops.drop
/drops give <player> <table_id> [level]	Roll a drop table and directly give items	divinity.drops.give
/drops help	Show help page	divinity.drops.help
/drops reload	Reload the drops module	divinity.drops.reload

---

🧪 Tips

• Use roll-once: true if you only want one result per mob death.
• Combine with module-custom_items and module-essences for richer loot progression.
• Use the Actions system for custom effects or requirements.
• Drop money or run commands directly via non-items and actions-on-drop.

---

🏠 Return to Home

← Return to Home