RPGLoot

⚔️ 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.

🌟 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 — 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

💎 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.

💀 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.

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.

🎯 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:

# Drop chances
drop-chance: 0.15
boss-drop-chance: 1.0

# Rarity weights (higher = more common)
rarity-weights:
  COMMON: 50
  UNCOMMON: 25
  RARE: 15
  HERO: 7
  LEGENDARY: 3

# Structure loot
structure-loot-chance: 0.25

Per-mob overrides, multiplier ranges per rarity tier, and boss minimum rarity are all configurable.

📦 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
• 📦 Modrinth
• 🔧 SpigotMC