Introduction

Player Souls introduces a unique soul system that allows players to extract, return, kill, or ban souls using in-game commands and keybinds. This system adds depth to gameplay by integrating soul-based interactions with custom items and scoreboard tracking.

What This Mod Adds

• Soul Extraction: Players can use /extract_soul to remove their own soul, receiving a Player Soul item. (can be disabled in gamerules)
• Soul Items:
  • Player Soul – The default soul type, containing the KillBlocked(now removable) and SoulControl tag.
  • Summoned Soul – A special soul, allowing full interaction with the soul system.
• Admin Abilities: Admins can use /force_extract_soul (true/false) to force-extract a player’s soul.

Critical Information Before Downloading

• Keybinds are required for returning, banning, killing, or resurrecting souls.
• This system is designed for multiplayer servers but can function in single-player environments for testing. (multiplayer interaction commands wont work :<)
• Bans will have a duration of 7 days
• For 1.1.2+ you can config this via gamerule (days_soul_is_banned)

Compatibility Support

NBT Tags

• BanBlocked – Denies banning if the item has this tag.
• Kill Block – Denies execution if the item has this tag (only allowed on Summoned Souls inside the base mod unless player willingly gives permission.).
• ReturnBlocked – Denies returning a soul to its original owner.
• SoulPresent – Used as a conditional for interactions like soul destruction.
• PlayerSoul – Stores the player’s display name in the soul item.
• [Unused] SoulControl - Was used as a conditional for Soul Adrenaline Control, grant this tag only to actual souls. (Feature Removed)

Scoreboard Tracking

• Soulless – Detects if the player’s soul has been extracted.
• SoulBanned - Dectects if the Player has either been banned(1) or has banned someone(2)(Direct Banishment only)
• SoulDamage - Soul Durability, used in Soul Extraction
• SoulInitialized - Granted to them as soon as they join with the mod installed, used to grant the SoulDamage score to prevent any errors