RPGLoot

(https://img.shields.io/badge/version-0.9.0-brightgreen?style=flat-square)](https://github.com/okereke-dev/rpgloot/releases) (https://img.shields.io/badge/Paper-1.20.4--26.1.2-blue?style=flat-square)](https://papermc.io) (https://img.shields.io/badge/license-MIT-lightgrey?style=flat-square)](https://github.com/okereke-dev/rpgloot/blob/master/LICENSE) # ⚔️ RPGLoot > Transform your vanilla server into an RPG loot experience — without replacing the game your players already love. Hostile mobs, bosses, and ancient structures now drop weapons, armor, and tools with **randomized rarity tiers**, **unique generated names**, and **hand-crafted bonus stats**. Everything stacks naturally with vanilla mechanics — enchantments, attributes, and loot tables all work exactly as expected. Drop it in, restart, done. --- ## 🌱 Vanilla-First Design RPGLoot is built to be a **complement**, not an overhaul. It was reviewed against other RPG-loot plugins specifically to avoid the common pitfalls — uncapped stat stacking, PvP-breaking power creep, and conflicts with other plugins' attributes. - **Hard caps on every stackable stat** — Dodge (50%), Damage Reduction (60%), Fall Reduction (80%), Crit Chance (35%), Bleeding (60%). No combination of item + set bonuses can exceed these, ever. - **`stats-enabled: false`** — a one-line config flip that turns RPGLoot into a **pure cosmetic rarity layer**. Items keep their generated name, color, and rarity tag but grant zero attribute bonuses, zero bonus stats, zero set bonuses. Vanilla combat stays completely untouched. - **Fully tunable power level** — every rarity multiplier and bonus-stat range lives in `config.yml`, not hardcoded. Want a subtler experience? Turn the numbers down. Want more power? Turn them up. No recompiling required. - **Real vanilla attributes, not fake NBT** — stat bonuses use Bukkit's native `AttributeModifier` system, the same one vanilla enchantments use, so RPGLoot plays nicely with other plugins instead of fighting them. - **Every item is vanilla-plus-bonus, never weaker** — rarity bonuses stack on top of an item's full vanilla stats, so even a Common piece hits at least as hard and blocks at least as much as its plain vanilla equivalent. --- ## 🔌 Integrations All optional — RPGLoot works standalone and detects these automatically at startup, with zero impact if they're not installed. - **PlaceholderAPI** — exposes `%rpgloot_active_set%`, `%rpgloot_active_set_pieces%`, `%rpgloot_active_set_bonus%` for scoreboards, tab list, and GUIs - **WorldGuard** — registers a custom `rpgloot-drops` region flag (`/rg flag <region> rpgloot-drops deny`) to exclude spawn or protected zones from RPGLoot's mob/boss/structure drops - **mcMMO** — RPGLoot's Fortune Boost and Auto-Smelt compose with mcMMO's own gathering bonuses (Double Drops, Mother Lode, Harvest Lumber, Clean Cuts, Verdant Bounty) instead of overriding them, by hooking the same `BlockDropItemEvent` mcMMO uses. Full mechanical breakdown of every overlapping stat on the (https://github.com/okereke-dev/rpgloot/wiki/Compatibility) - **RPGMood** — two-way, zero-dependency integration: mobs scaled by RPGMood's difficulty system get a higher minimum rarity floor the more dangerous they are (configurable level thresholds), and RPGMood's achievement system reacts to your rarities, Artifacts, and set completions — including "Godslayer's Arsenal" for collecting all 4 of RPGLoot's boss-exclusive Artifacts --- ## 🌟 Rarity System Every item rolls one of **5 rarity tiers**, each with its own color, name style, and stat multiplier range: | Tier | Color | Stat Bonus | Drop Chance | |---|---|---|---| | ⬜ **Common** | Gray | Low | High | | 🟢 **Uncommon** | Green | Moderate | Medium | | 🔵 **Rare** | Blue | High | Low | | 🟡 **Hero** | Gold | Very High | Very Low | | 🔴 **Legendary** | Red | Maximum | Rare | Each rarity scales damage, defense, and speed independently — armor has its own dedicated per-tier multiplier range (separate from weapon damage), so the bonus is clearly felt on every piece, not just chestplates — and unlocks stronger bonus stat rolls. --- ## ✨ Bonus Stats Items roll **1–3 bonus stats** from a curated pool per item type. No filler — every stat has a real in-game effect. **⚔️ Weapons** | Stat | Effect | |---|---| | Lifesteal | Heal a % of damage dealt | | Crit Chance | Bonus critical strike probability | | Bleeding | DoT damage over several seconds | | Knockback Boost | Extra knockback on hit | | Smash Radius | Mace: splash damage to nearby enemies | | Lightning Strike | Random lightning bolt on target | | Riptide Speed | Boost while in water or rain (Trident) | | Fall Damage Bonus | Damage scales with fall distance | **🛡️ Armor** | Stat | Effect | |---|---| | Health Boost | Permanent max HP increase | | Dodge Chance | % chance to completely avoid a hit | | Damage Reduction | Flat % less damage taken | | Speed Boost | Passive movemen