Skip to content
okereke-dev edited this page Jul 2, 2026 · 9 revisions

RPGLoot Wiki

Welcome to the RPGLoot documentation. RPGLoot is a Paper 26.1.2 plugin that adds an RPG-style rarity system to Minecraft weapons, armor, and tools.

Current version: v0.3.0 · SpigotMC: spigotmc.org/resources/rpgloot.136622


Pages

Page Description
Rarities Rarity tiers, colors, scaling rules and drop weights
Weapons Weapons, armor, and tools — item types and bonus stat pools
Bonus Stats All bonus stats with value ranges per rarity
Sets Set bonus system — collect matching pieces for scaling bonuses
Drop System Mob drops, boss drops, structure loot, and probability tables
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 or armor with a rarity tier
  • Each item gets a random RPG name (e.g. Shadow Blade, Tidal Piercer, Ironveil Chestplate)
  • Rarity adds a scaled flat bonus over the item's vanilla base stats — enchantments stack independently
  • Bonus stats are unique per item type and rolled randomly within fixed ranges
  • Set bonus system: weapons and armor belong to named sets — equip 2–5 matching pieces (same set name, rarity, and material) to unlock scaling bonuses
  • Tool support: pickaxe, shovel, hoe, fishing rod, woodcutter axe — Fortune Boost, Auto-Smelt, and more
  • Boss mobs guarantee a rarity drop with a configurable minimum rarity
  • Vanilla structure chests have a chance to contain an RPGLoot weapon
  • Mob material tier system: mobs drop items using materials appropriate to their difficulty zone
  • Floating damage numbers and particle effects provide in-combat feedback
  • Everything is configurable: drop chance, rarity weights, boss drop ranges, structure loot chance

Clone this wiki locally