SimpleEvo RPG

✦ SimpleEvo - Advanced RPG Item Leveling ✦
The ultimate lightweight, database-free item progression system for modern Paper 1.21+ servers.

Transform your standard Minecraft survival experience into a dynamic RPG world. SimpleEvo allows players to organically level up their weapons, tools, armor, and shields just by playing the game. As items gain XP, their physical stats scale, giving players a massive incentive to grind, farm, and protect their favorite gear.

Built specifically for modern server architectures, SimpleEvo requires zero databases and uses built-in anti-exploit memory caching to keep your server running at 20 TPS.

✨ Comprehensive Feature List
⚔️ Dynamic Action-Based Leveling Players don't need confusing commands to level up. They simply use their gear!

• Weapons (Swords & Axes): Gain XP by dealing damage and killing custom-configured mobs.
  
  
• Tools (Pickaxes, Shovels, Hoes): Gain XP by mining configured blocks and ores.
  
  
• Shields: Gain XP dynamically by successfully blocking enemy attacks.
  

Tangible Stat Scaling When an item levels up, it doesn't just look pretty—it gets stronger.

• Weapons gain scaling Bonus Damage.
  
  
• Tools gain scaling Mining Speed (custom efficiency).
  
  
• Armor and Shields gain passive Bonus Armor when worn or held in the off-hand.
  
  
• All vanilla attributes are automatically hidden for a clean, professional RPG tooltip.
  

The EvoForge Evolution System Items naturally cap at Level 10. To push past this limit, players must use the interactive EvoForge GUI (/forge).

• Players pay a customizable material cost (e.g., Diamonds, Netherite) to evolve their item.
  
  
• 5 Rarity Tiers: Common ➔ Uncommon ➔ Rare ➔ Epic ➔ Legendary.
  
  
• Evolving an item permanently increases its level cap by +10, allowing for endless, balanced progression.
  

️ Bulletproof Anti-Exploit Engine Keep your economy safe from exploiters. SimpleEvo features a high-performance Guava memory cache that tracks player actions in real-time:

• Blocks broken with Silk Touch yield zero XP.
  
  
• Player-placed blocks (like replacing and re-mining a diamond ore) yield zero XP.
  
  
• Mobs spawned from Spawners can be blacklisted from giving XP.
  
  
• Built-in memory limits ensure the cache never causes server RAM leaks.
  

100% Database-Free (PDC Driven) Say goodbye to complex MySQL setups. SimpleEvo uses Bukkit's Persistent Data Container (PDC) to bake the level, XP, and stats directly into the item's NBT data.

• If a player drops their Level 50 Legendary Sword, the person who picks it up gets a Level 50 Legendary Sword. It is fully compatible with player trades, auction houses, and vaults.
  

Modern, Immersive UI Powered by the Adventure API (MiniMessage):

• Beautiful visual progress bars directly in the item's lore.
  
  
• Non-intrusive Action Bar XP notifications (with smart decimal formatting).
  
  
• Satisfying audio chimes and RPG particle effects on level-up.
  
  
• Rainbow-colored <MAX LEVEL> indicators for endgame gear.
  

⚙️ Total Admin Control
Server owners have complete control over the balancing and economy via the config.yml.

• Custom Geometric Math: Define the base XP and multiplier. Make early levels fast and late levels a true grind.
  
  
• Dynamic XP Sources: Reward 500 XP for an Ender Dragon, but only 2 XP for a Zombie. Reward 50 XP for Ancient Debris, but 1 XP for Coal.
  
  
• Admin Commands: Full console support to setlevel, addxp, or reset any player's item to fix mistakes or reward event winners.
  

Commands & Permissions

• /sevo info - View your held item's progression. (simpleevo.use)
  
  
• /forge - Open the EvoForge GUI. (simpleevo.use)
  
  
• /sevo admin addxp <player> <amount> - Grant raw XP. (simpleevo.admin)
  
  
• /sevo admin setlevel <player> <level> - Force-set an item's level. (simpleevo.admin)
  
  
• /sevo admin reset <player> - Wipe an item back to Level 1. (simpleevo.admin)
  
  
• /sevo reload - Hot-reload the config and UI strings. (simpleevo.admin)