ShadeSMP — Soul-Based PvP SMP Plugin
Discord Link
== Video Showcase in future | dont have the people currently ==
ShadeSMP transforms your standard survival server into a high-stakes PvP SMP where every player is bound to a soul. Souls are randomly assigned when a player first joins, each carrying passive bonuses and a powerful active ability triggered by pressing F (swap hand) or running /ability. When a player dies, their soul drops to the ground as a glowing Echo Shard — and the hunt begins.
The Soul System
Each player is assigned one of 6 soul types on first join. Souls are persistent, saved per-UUID, and displayed constantly in the action bar in their soul's unique colour.
Cold Soul
Passive: 10% chance on hit to apply Slowness II for 5 seconds and a freezing overlay to the target.Ability — Deep Freeze (45s cooldown): Completely locks the nearest player within range for 6 seconds. Ice block entities visually encase the target. While frozen they cannot move, eat, or take fall damage, and see the powdered snow GUI overlay.
Quickening Soul
Passive: Permanent Haste I — always active, re-applied every tick.Ability — Haste Surge (45s cooldown): Instantly surges to Haste V for 10 seconds, paired with sweep attack particles and a whoosh sound effect.
Dark Soul
Passive: 10% chance on hit to apply Blindness for 5 seconds to the target.Ability — Shadow Shroud (60s cooldown): For 8 seconds the caster becomes fully invisible, takes zero damage from any source, but deals 40% less damage while shrouded. Dark smoke particles pulse around them throughout.
Venom Soul
Passive: 10% chance on hit to apply Poison I for 3 seconds (works on any entity).Ability — Vine Pull (30s cooldown): Finds the nearest player within 40 blocks (line-of-sight required) and yanks them toward the caster using a velocity vector, spawning spore blossom particles along the pull path.
Sharp Soul
Passive: 10% chance on hit to gain Strength III for 5 seconds on yourself.Ability — Blade Drop (60s cooldown): Spawns a diamond sword 6 blocks above the nearest entity within 8 blocks, which plummets down and impacts the ground — dealing 8 armour-piercing damage (4 hearts) to all entities within 5 blocks, with ground-crack block display shards and crit particles on impact.
Flaming Soul
Passive: Permanent Fire Resistance + 1.3× outgoing damage while you are on fire.Ability — Lava Curse (60s cooldown): Targets the nearest living entity within 10 blocks. For 8 seconds a lava block follows them wherever they walk, they are continuously set on fire, take 1.5× fire damage, and each fire-damage tick randomly damages a worn armour piece by 20 durability.
Soulless
Obtained only by dying — never randomly assigned.Passive: 10% chance on hit to apply Weakness I for 3 seconds to the target.
Ability — Soul Curse (150s cooldown): Inflicts the Soulless soul onto the nearest player within 16 blocks for 60 seconds, stripping them of their soul's passives and applying Soulless effects temporarily. Their real soul returns on expiry.
Death & Soul Mechanics
When a player dies:- Their soul drops as a glowing soul item at the death location, coloured with their soul's outline colour (e.g. aqua for Cold Soul, red for Flaming Soul).
- The dead player is placed in Spectator mode until revived.
- The dead player's soul is set to Soulless immediately.
Soul Item Interactions
| Action | Result |
|---|---|
| Right-click a dropped soul | Revives the soul's owner — teleports them to you and returns them to Survival |
| Left-click a dropped soul | Swaps your current soul into the item and claims the embedded soul for yourself |
| /withdraw | Bottles your own soul into a Bottled Soul item (you become Soulless); right-clicking the bottle swaps it back |
The Soulless Blade (Special Weapon)
A legendary Netherite Sword (Sharpness III, Sweeping Edge III, Unbreakable) with a gradient name and custom lore.- While the blade is in a player's inventory, their soul is forced to Soulless until they remove it.
- Right-click ability (90s cooldown, 10s window): Arms the blade. The next player hit within the window is soul-cursed for 30 seconds:
- Dense dark particles trail them (visible to all)
- Their soul's passive proc chance is halved
- Their soul's ability cooldown ticks at double speed (1 second costs 2 seconds)
Grace Period
Start the server with a configurable grace period using /grace <worldBorderSize> <blocksPerMinute>.- A gradient boss bar ("ɢʀᴀᴄᴇ ᴘᴇʀɪᴏᴅ") counts down in real time and is shown to all players, including those who join mid-grace.
- All PvP damage is blocked while grace is active (projectiles included).
- When grace ends, a "Good luck!" title plays across the server with a challenge-complete sound.
Target Mode
Players can configure which entities their soul abilities target with /target [players|mobs].- Players mode (default) — abilities seek out nearby players.
- Mobs mode — abilities target hostile mobs (Monsters, Slimes, Ghasts, Phantoms, angered Iron Golems, Piglins, and creatures actively targeting a player).
Commands
| Command | Description | Permission |
|---|---|---|
| /ability | Activate your soul's active ability | All players |
| /withdraw | Bottle your soul into an item | All players |
| /target [players|mobs] | Set ability targeting mode | All players |
| /revive <player> | Revive a dead player | OP only |
| /grace <borderSize> <blocksPerMin> | Start the grace period | OP only |
| /soul <type> [player] | Set a player's soul type | OP only |
| /soulsword | Give yourself the Soulless Blade | OP only |
| /selfsoul <type> <passive|ability> | Test any soul's passive or ability on yourself | OP only |
| /soulbladetest | Fire the Soulless Blade soul splash on yourself | OP only |
Technical Details
- API Version: 1.21
- Author: YTDarkGuy
- Storage: Souls are saved to plugins/ShadeSMP/souls.yml, persisted per UUID across restarts.
- Action Bar: Each player sees their soul type displayed in their soul's colour at all times (if using texture pack).
- Fire Aspect: A FireAspectRemovalListener is included to prevent Fire Aspect from interfering with soul-based fire mechanics.
- No dependencies — fully self-contained.
Perfect For
- Lifesteal / SMP servers looking for a unique twist on death mechanics
- PvP-focused SMPs that want class-like asymmetry without a full RPG plugin
- Content creator servers where soul reveals and soul steals create dramatic moments
- Any server that wants lore-driven, skill-based PvP with memorable fights
Plugin Stats
- Open-Source [FALSE] --> Does not consent on being modified or recoded
- DMR-Free [TRUE] --> There is no license since its completely free and gives full consent to be re-coded from the community
- Unobfuscated [TRUE] -->The coding is difficult to understand
