✦ Soulbound ✦

Every player carries a unique soul. Every death cracks it. Guard it — or gamble it all on rebirth.

Soulbound is a full soul system for Paper servers: on first join, every player is bound to 1 of 15 unique soul crystals, each granting a passive buff or an active ability. Your soul is real — it sits in your inventory, it cracks when you die, and when it goes dark you become a Lost Soul with nothing but a desperate ghost power... unless you fight your way back.

---

💔 The Soul Loop

• Bound for life — your soul crystal (a custom echo shard) can't be dropped, traded, placed, or stored. It survives death and only answers to you.
• Death has a price — each death cracks your soul: −0.5 heart of max HP per crack. After 8 cracks it goes dark: a Lost Soul, no power, −4 hearts total.
• Mending — souls slowly heal 1 stage every 20 minutes (never while Lost), or instantly by consuming Soul Fragments:
  • Kill a soul-bearing player → tear out 1 fragment
  • Boss drops — Wither & Ender Dragon 100%, Warden 50%, Elder Guardian 35%
• Rebirth — craft 8 fragments around a diamond into an Empty Soul, bring it to a Soul Altar, and channel a cinematic ~20-second ritual: tightening soulfire rings, rising wisps, escalating chimes and a lightning climax. 60% success rerolls you a brand-new soul at full integrity. Fail, and the Empty Soul shatters. 5% of successful rituals grant the mythic Sovereign Soul.
• Ghost Form — even Lost Souls aren't helpless: for 2 seconds the soul drives your body — fully untouchable and invisible — then takes 2 hearts as payment (never lethal).

No altar built yet? Fresh servers aren't soft-locked: anywhere-fusion works until an admin registers the first altar. Once one exists, the ritual demands it.

---

🔮 The 15 Souls

Passives — always active:

Soul	Power	Effect
🔥 Blaze	Fireborn	Permanent Fire Resistance
💨 Swift	Windstep	Permanent Speed I
🛡️ Ironclad	Bulwark	+2 hearts max HP
☠️ Venom	Toxic Blades	Your hits poison enemies
❄️ Frost	Chilling Touch	Your hits slow & freeze enemies

Abilities — hold your soul, Sneak + Right-Click (or /soul ability):

Soul	Power	CD	Effect
🐺 Spirit	Spirit Legion	60s	Summon 2 spirit wolves (4 hearts) to fight beside you
⚡ Storm	Thundercall	90s	Lightning strikes all enemies within 8 blocks (max 5)
🌑 Shadow	Veilstep	75s	Invisibility + Speed II for 5s
✨ Guardian	Aegis	90s	Absorption III + Resistance I for 10s
💛 Radiant	Blessing	120s	Heal 3 hearts + cleanse negative effects
☄️ Inferno	Meteor Volley	45s	Launch 3 blazing meteors
🌍 Quake	Seismic Slam	75s	3-heart slam, launches everything around you
💨 Gale	Tempest Burst	60s	Violent gust cone blasts enemies away
🌀 Void	Voidlash	90s	Blink up to 12 blocks, rending all in your path

💜 Sovereign Soul (mythic — ritual-exclusive) — 4 switchable powers (Sneak + Left-Click or /soul next): Soul Seekers (3 homing bolts, 40s) · Dominion (pull + slow, 60s) · Soul Nova (soulburst, 75s) · Ascendance (6s god-mode, 120s).

👻 Lost Soul — Ghost Form (60s): 2s untouchable + invisible, costs 2 hearts.

Every cast has custom particles and sounds — spark-laced lightning, portal-trail blinks, shockwave rings, soulfire bursts, a wisp trail during Ghost Form.

---

🎮 Animated Ability HUD

A single ability box sits at your crosshair, driven by the bundled resource pack:

• Bright = ready. Cast, and it goes dark.
• The dim veil wipes downward frame-by-frame (12-frame sweep) as your cooldown recharges — full glow means it's back.
• Sovereign tracks the currently selected power; Lost Souls sweep with Ghost Form.

---

🎨 Built-in Pixel-Art Resource Pack

soulbound-pack.zip ships with the plugin: 32×32 pixel-art crystals — every soul is a purple echo-shard crystal with its own colored rune, plus Lost Soul, Empty Soul, Soul Fragment, the HUD glyph set, and a pack icon.

Server install: host soulbound-pack.zip anywhere with a direct URL, then in server.properties:

resource-pack=<direct zip URL>
resource-pack-sha1=<run: sha1sum soulbound-pack.zip>
resource-pack-prompt=§dSoulbound §7- accept the pack for custom souls & HUD!

Clients need no mods — they just accept the pack on join. Without the pack, everything still works; you just lose the custom look and HUD.

---

⌨️ Commands

Command	What it does	Permission
/soul (alias /souls)	Info, integrity bar, cooldowns, cast (/soul ability), cycle (/soul next), help	soulbound.use (default: everyone)
/souladmin give <player> <soul|random>	Set/give a soul	soulbound.admin (default: op)
/souladmin setintegrity <player> <0-8>	Set soul integrity	op
/souladmin unlost <player>	Restore a Lost Soul	op
/souladmin fragments <player> <n>	Give fragments	op
/souladmin emptysoul <player> <n>	Give Empty Souls	op
/souladmin altar build	Build a full altar where you look	op
/souladmin altar add|remove|list	Manage custom altar spots	op
/souladmin reload	Reload config	op

---

⚙️ Configure Everything

Health-per-crack, regen rate, every cooldown & power value, ghost damage, fragment drop chances, reroll/Sovereign odds, ritual duration, HUD on/off & tick rate, altar gating — all hot-reloadable in config.yml.

✅ Requirements

• Paper 1.21.x (built & tested on 1.21.11) — Java 21
• Custom item models need 1.21.4+ clients (older clients see vanilla items; mechanics unaffected)