module drops - magemonkeystudio/divinity GitHub Wiki

๐ŸŽ 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

โš ๏ธ **GitHub.com Fallback** โš ๏ธ