🔮 SoulboundFragments

SoulboundFragments is a PvP RPG plugin that introduces Soul Fragments currency, buffed diamond armor upgrades, an automatic bounty system, anti-alt protection, and high-performance async saving — built for competitive servers.

⚔️ Core Features

🧩Soul Fragments (PvP Currency)

• Drops from PvP kills only (configurable)
• Configurable drop amount and hard cap
• Physical fragment item used for upgrades
• Supports custom textures via resource pack
• Async stat saving (no lag)

🛡️ Buffed Armor System

• Diamond armor only
• One buff per armor piece
• Buff types:
  • Reinforced
  • IronWill
  • FlameGuard
  • LifeGuard
  • SwiftStep
• Per-buff max level overrides
• Max-level armor features:
  • Colored glint effects
  • Custom model support
• Buffed armor is soulbound
• Cannot be stored in:
  • Chests
  • Item frames
  • Bundles
• Persistent data prevents duplication exploits

💀 Automatic Bounty System

• Bounty added on every PvP kill
• Bonus bounty when wearing max-level armor
• Bounty paid as Soul Fragments
• High-bounty death broadcast
• Bonus rewards for killing high-bounty targets

🛑 Anti-Alt Protection

• Prevents farming the same player
• Cooldown per killer-victim pair
• Blocks stats, bounty, and fragment drops during cooldown

🔥 Armor Destruction Rules

• Optional global destruction on death
• Cause-based destruction:
  • Lava
  • Void
  • Fire
  • Explosion
• PvP-only destruction toggle

🧠 GUI System

• Buff upgrade GUI
• Buff change confirmation GUI
• Configurable GUI titles and sounds

⚡ Performance Optimized

• Fully async stat saving
• Configurable autosave interval
• No disk I/O lag during gameplay
• Safe shutdown saving

📜 Commands

/buff - Open Buff Upgrade GUI /soul - Upgrade your armor /souls - View PvP stats /bounties - Open bounty GUI /soulreload - Reload config

📦 Installation

1. Drop the plugin jar into /plugins/
2. Restart the server
3. Configure config.yml
4. Restart again
5. (Optional) Apply the resource pack

🧩 Supported Versions

• Paper / Spigot / Purpur
• Minecraft 1.21+

⚠️ Important Notes

• Only diamond armor is supported
• Buffed armor is soulbound to players
• Cannot be stored in containers or frames
• Designed to be exploit-safe and lag-free

🚀 Future Ready

• Custom fragment textures
• Max-level armor models
• Colored glint effects
• Cosmetic particle effects