⚔️ 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 Compatibility wiki page
• 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:

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

🛡️ Armor

⛏️ Tools

Stacking-sensitive stats are hard-capped regardless of item + set combinations: Crit Chance ≤ 35% · Bleeding ≤ 60% · Dodge ≤ 50% · Damage Reduction ≤ 60% · Fall Reduction ≤ 80%.

💎 Set Bonus System

Every weapon and armor piece belongs to one of 8 named sets. Collect matching pieces — same set name, rarity, and material — to unlock scaling bonuses.

Piece scaling:

Available sets:

The active piece count is highlighted live in the item lore in the set's rarity color. Bonuses stack additively with individual item stats — every equipped piece contributes its own bonus independently, so a full set really does add up to what the lore shows.

💀 Drop Sources

Hostile Mobs Every hostile mob has a configurable drop chance. Material tier scales with the mob's difficulty zone — skeletons don't drop Netherite, Wither Skeletons might. Some mobs can also spawn already wielding or wearing a real RPGLoot item (mob-equip) — a visible loot signal before you even land the kill; if the mob dies, that item is what drops.

Boss Mobs Elder Guardian, Wither, Ender Dragon, and Warden guarantee a drop with a configurable minimum rarity floor.

Vanilla Structures Strongholds, Bastions, End Cities, Jungle Temples, and more have a configurable chance to contain an RPGLoot weapon in their loot chests, with a per-structure max rarity that's fully configurable in config.yml (structure-loot.max-rarity) rather than hardcoded.

🎯 Combat Feedback

Every hit tells a story:

• Floating damage numbers — color-coded per type, rise above the target
• 🩸 Bleed ticks show separate red numbers
• 💚 Lifesteal pulses green healing numbers on the attacker
• 💥 Crits show enlarged gold numbers
• ⚡ Smash hits show splash damage on nearby targets
• Particle effects for crits, lifesteal, bleeds, and mace smash rings

⚙️ Configuration

Everything is tunable in config.yml — no recompile needed:

# Pure cosmetic mode — no stat/attribute changes at all
stats-enabled: true

# Drop chance per hostile mob kill
drop-chance: 0.20

# Rarity weights (higher = more common) — auto-normalized to 100
rarity-weights:
  common: 50
  uncommon: 30
  rare: 13
  hero: 5
  legendary: 2

# Structure loot
structure-loot:
  enabled: true
  inject-chance: 0.45
  max-rarity: LEGENDARY

# Rarity damage/speed multipliers — fully overridable
rarity-multipliers:
  LEGENDARY: { damage: [1.30, 1.40], speed: [1.10, 1.20], armor: [0.60, 0.85] }

# Bonus stat value ranges — fully overridable, one entry per stat
bonus-stat-ranges:
  CRIT_CHANCE: { uncommon: [2,5], rare: [5,10], hero: [10,15], legendary: [15,20] }

Per-mob material tiers, boss minimum rarity, and every rarity/stat range shown above ship pre-populated with the tested defaults and can be freely retuned. config.yml also auto-merges any new keys added by an update on startup or reload, without touching anything you've already customized.

📦 Installation

1. Drop rpgloot.jar into your /plugins folder
2. Restart the server
3. Done — no setup required

Requirements: Paper 1.20.4 – 26.1.2 · Java 21 · No dependencies

🔗 Links

• 📖 Full Wiki
• 💻 Source Code
• 🐛 Report a Bug
• 🐹 Hangar
• 🔧 SpigotMC