Skip to content
okereke-dev edited this page Jun 30, 2026 · 9 revisions

📖 RPGLoot Wiki

Welcome to the RPGLoot documentation. RPGLoot is a Paper 1.21.4 plugin that adds an RPG-style rarity system to Minecraft weapons.

Current version: v0.1.0


📚 Pages

Page Description
⚔️ Rarities Rarity tiers, colors, scaling rules and drop weights
🗡️ Weapons Per-weapon damage tables and bonus stat pools
✨ Bonus Stats All bonus stats with value ranges per rarity
🎲 Drop System How the drop system works and probability per kill
💬 Commands All admin commands with full usage reference
⚙️ Configuration Full config.yml reference with all options

⚡ Quick overview

  • Hostile mobs have a configurable chance to drop weapons with a rarity tier
  • Each weapon gets a random RPG name (e.g. Shadow Blade, Tidal Piercer)
  • Rarity adds a scaled bonus over the weapon's vanilla base stats
  • Bonus stats are unique per weapon type and rolled randomly within fixed ranges
  • Enchantments stack independently — rarity and enchantments don't amplify each other
  • Floating damage numbers and particle effects provide in-combat feedback
  • Everything is configurable: drop chance, rarity weights, and stat display format

Clone this wiki locally