v0.3.1

What's new

Multi-version compatibility (1.20.4 – 26.1.2)

This release adds backward compatibility so the plugin works on any Paper server from 1.20.4 up to 26.1.2.

Changes:

• Compile target lowered to Paper 1.20.4 API
• Material.MACE resolved at runtime — gracefully absent on 1.20.x servers
• AttributeModifier uses UUID-based constructor (supported across all versions)
• Attribute constants updated to GENERIC_* form for 1.20.4 compatibility
• PotionEffectType.SLOW, Particle.REDSTONE, Particle.EXPLOSION_NORMAL for 1.20.4 API

No gameplay changes. Full feature parity with v0.3.0 on all supported versions.

v0.3.0 — Set Bonus System

What's new in 0.3.0

Set Bonus System

• 8 named sets: Shadowveil, Ironbound, Dawnbreaker, Tidecaller, Emberclaw, Stormwarden, Voidwalker, Gilded
• Every weapon and armor piece is randomly assigned to a set on generation
• Equip 2–5 items sharing the same set name, rarity, and material tier to activate a scaling bonus
• Piece scaling: 30% / 55% / 75% / 100% of the base value
• Active set lore highlighting: the active piece-count line is highlighted in the item's rarity color and updated dynamically on equipment change

Set Bonuses Fixed

• Voidwalker (XP Boost) — bonus now correctly adds to XP gained from block breaks
• Gilded (Luck Boost) — now applies as a passive AttributeModifier on the player
• Stormwarden (Speed Boost) — activates and deactivates instantly on equipment change

Set Grouping Fix (critical)

• Items of the same material tier (e.g. Diamond Sword + Diamond Helmet) now correctly count toward the same set group
• Previously, different item types with the same material were treated as separate tiers

Balance Changes

• Speed Boost (armor stat) range reduced: Uncommon 1–2%, Rare 2–4%, Hero 4–6%, Legendary 6–8%
• Bleeding total proc chance (item + set bonus) capped at 75%
• Fortune Boost and Auto-Smelt are now mutually exclusive per block break

Bug Fixes

• Dodge Chance and Damage Reduction now accumulate across all armor pieces and roll once per hit — previously each piece rolled independently
• Thorns Chance is now averaged across all equipped RPGLoot armor pieces and rolled once per hit

Performance

• LRU stat cache (512 entries) on ItemRarityService to avoid re-parsing bonus stats on every damage event
• SetListener debounced with a 1-tick delay to avoid redundant recalculations
• Single PDC read per armor piece per damage event

New Commands

• /rpgloot getset <set> <rarity> <tier> [pieces] — generate a full matching set of items for testing
• /rpgloot sets [set] — list all sets or show the full value table for one
• /rpgloot get now accepts an optional [set] argument to force a specific set
• /rpgloot clear — remove all RPGLoot items from your inventory
• All new commands support tab-complete

Config & Reload

• /rpgloot reload now propagates the config to all listeners live

---

Paper 1.21.4 / game version 26.1.2

RPGLoot 0.2.0

RPGLoot 0.2.0

New Features

• Armor drops — helmets, chestplates, leggings, boots now drop from hostile mobs (20% of all drops)

  • Bonus stats: Thorns Chance, Dodge Chance, Damage Reduction, Health Boost, Speed Boost, Fall Reduction, Night Vision Chance
  • Health Boost and Speed Boost applied as passive item attribute modifiers
  • Night Vision Chance has a 10-second cooldown

• Tool support — pickaxe, shovel, hoe, fishing rod, woodcutter axe via /rpgloot

  • Bonus stats: Fortune Boost, XP Boost, Auto-Smelt, Replant, Luck Boost, Double Catch Chance

• Mob material tier system (ceiling model)

  • T1 Overworld mobs → up to Iron
  • T2 Structure mobs (Pillager, Vindicator, Witch, Evoker, Ravager) → up to Golden
  • T3 Nether + End mobs → up to Diamond
  • Bosses only → up to Netherite

• Weighted mob weapon pools — 70% signature weapon type, 30% generic tier pool

  • Skeleton/Stray → Bow · Drowned → Trident · Pillager → Crossbow · Piglin → Gold · Wither Skeleton → Sword · Vindicator → Axe

• Boss drops with configurable Rare–Legendary range

  • Warden / Wither / Ender Dragon → Rare–Legendary (100%) · Elder Guardian → Rare–Hero (80%)

• Structure loot — 25% chance to inject an RPGLoot weapon into vanilla structure chests

  • Dungeon/Mineshaft → Uncommon · Desert/Jungle/Stronghold → Rare · Mansion/Bastion/Outpost/Portal → Hero · End City/Ancient City → Legendary

Balance Changes

• Common rarity now gives a flat +5% damage/defense bonus (was vanilla baseline)
• Armor drops reduced to 20% (from 35%)
• Structure loot inject chance reduced to 25% (from 40%)
• Netherite is now boss-exclusive
• rarity-weights config auto-normalizes if they don't sum to 100

v0.1.1

Fixed

• Bleeding now has a proper proc chance (20–75% by rarity) instead of triggering on every hit
• Bleeding damage per tick is now derived from weapon base damage × rarity factor — predictable and weapon-tier consistent
• Bleed ticks no longer apply knockback to mobs (was causing freeze/bounce behavior)
• Damage numbers no longer round small values to 0 — values under 10 show one decimal
• Bleed re-hit correctly cancels previous bleed before starting a new one
• Bleed ticks no longer re-trigger bonus stats (lifesteal, crit, etc.) on the attacker

Added

• damage-numbers: true/false config option to toggle floating damage numbers
• Damage numbers pop-in animation — crits scale larger for visual distinction

Note: if upgrading from 0.1.0, add damage-numbers: true to your plugins/RPGLoot/config.yml, or delete the file and let it regenerate.

Full changelog: https://github.com/okereke-dev/rpgloot/blob/master/CHANGELOG.md

v0.1.0

Initial public release of RPGLoot for Paper 1.21.4.

What's included

• 5 rarity tiers: Common, Uncommon, Rare, Hero, Legendary
• 6 weapon types: swords, axes, tridents, maces, bows, crossbows
• Random RPG-style weapon names per weapon type
• Unique bonus stat pools per weapon type (Lifesteal, Crit, Bleeding, Lightning, Smash, and more)
• Floating damage numbers with client-side interpolation
• Particle effects for crits, bleed ticks, lifesteal, and smash radius
• Fully configurable: drop chance, rarity weights, stat display format

Installation

1. Place rpgloot-0.1.0.jar in your server''s plugins/ folder
2. Restart the server

Requires: Paper 1.21.4 · Java 21

Documentation

Full documentation available on the Wiki.