Razorz DiabloDrops

Razorz DiabloDrops is a Paper Minecraft plugin that gives randomly-spawned hostile mobs randomized loot with tiered enchantments and lore effects, which they drop on death.

Features

Loot mobs — A configurable percentage of naturally-spawned hostile mobs become loot mobs, spawning equipped with 1–5 randomly generated items.
Tiered loot — Items roll against a weighted tier table (Common through Legendary/Unidentified), each with distinct drop chances and stat ranges.
Enchantment caps — A global hard cap (level 7) plus per-enchant caps (Fortune=4, Mending=1, etc.) with probability gates that control how often higher levels appear.
Lore effects — Weapons can roll enemy debuffs (Slowness, Poison, Wither, Blindness) or wielder buffs (Strength, Regeneration). Armor can roll attacker punishes or wearer protections (Resistance, Absorption, Speed). All effects capped at ±3.
Identify system — Items can drop as Unidentified and require an Identify Tome to reveal their stats.
Admin commands — Full /dd command suite for spawning, modifying, and debugging items in-game (see below).

Admin Commands

All commands require the diablodrops.use permission. reload additionally requires diablodrops.reload.

Command	Description
`/dd`	Give yourself a random DiabloDrops item
`/dd tome`	Give yourself an Identify Tome
`/dd repair`	Fully repair the item in your main hand
`/dd give <player> [player...]`	Give a random item to one or more online players
`/dd tier [name] [p:<player>]`	Give an item of the named tier (random tier if omitted)
`/dd mythic [p:<player>]`	Give an unidentified Mythic-tier item
`/dd lore [tier] [p:<player>]`	Give a guaranteed lore-enhanced item
`/dd custom [name]`	Give a random custom item, or a specific one by name
`/dd modify lore <text\|clear>`	Set or clear the lore on your held item (use `,` to separate lines, `&` for color codes)
`/dd modify name <text\|clear>`	Set or clear the display name on your held item
`/dd modify enchant add <enchant> <level>`	Add an enchantment to your held item
`/dd modify enchant remove [enchant]`	Remove one or all enchantments from your held item
`/dd modify enchant clear`	Clear all enchantments from your held item
`/dd debug [detailed]`	Print loaded config counts to server log; `detailed` dumps all names
`/dd reload`	Reload the plugin config

Configuration

File	Purpose
`config.yml`	Drop rates, enchantment caps, global toggles
`tier.yml`	Tier weights, level ranges, drop chances
`offenselore.txt`	Weapon lore effect pool
`defenselore.txt`	Armor lore effect pool

Key config defaults:

ChancePerSpawn: 3 — 3% of mobs become loot mobs
EnchantmentLevelCap: 7 — global enchantment ceiling
Spawner and spawn-egg mobs are blocked from becoming loot mobs

Build

Requires Java 21 and Paper 1.21.8.

./gradlew build
# Output: build/libs/RazorzDiabloDrops.jar

Drop the JAR into your server's plugins/ folder and restart.