Soul Graves

# 🪦Soul Graves🪦 A unique graves plugin where players collect their souls to retrieve their belongings when they die. A soul will spawn at your death location that provides audio and visual feedback to help you locate it. Once you find it you can retrieve your items by walking into your soul. Be careful though, wait too long and your soul will burst dropping all your items! Special thanks to (https://github.com/Catnies) and (https://github.com/ShiroKazane) for their contributions to the project! ## Features ### ⭐ Core Mechanics - Soul Graves will spawn a soul when a player dies, storing their belongings. - Avoids spawning souls in liquids, the void, or non-solid blocks. - Souls persist through server restarts. - Customizable number of active souls per player, with an option for unlimited. - Ability to restrict soul collection to their owner. - Config options to pause the soul countdown timer while the owner is offline. - Disable soul spawning in specific worlds. ### ✨ Visual & Audio Feedback - Visual cue indicates when a soul is about to burst. - Players in a configurable radius will hear heartbeat sounds to guide the to nearby souls. - Optional and customizable hint particles to lead players directly to their soul. - Choose which sounds play for soul collection, soul bursting, and notifying players. - Both the soul’s owner and nearby players can be notified when a soul's status changes. ### 💎 Item & XP Handling - Souls can be configured to only drop items, xp, or both when they burst. - Set distinct XP return percentages for owners and non-owners separately. - Option to either destroy or scatter items/xp when a soul bursts. ### 🌐 Cross-Server Support - Cross-server support with MySQL and Redis for a seamless experience. ### 🪙 Economy Support - Configurable costs for players teleporting to their soul. ### 🛠️ Customization & Developer API - All messages are fully customizable with MiniMessage formatting. - Custom API for developers to hook into to customize Soul Graves further. ## Compatibility - **WorldGuard**: Flag for disabling soul spawning in specific regions. - **Towny**: Supporting their various keep-inventory options. - **Soulbound Enchantment Plugins**: - Vane - ExcellentEnchants - EcoEnchants ## Showcase <video src="https://github.com/FaultyFunctions/SoulGraves/raw/refs/heads/main/media/stable_soul.mp4" autoplay muted loop></video> <center>A stable soul waiting to be collected</center> --- <video src="https://github.com/FaultyFunctions/SoulGraves/raw/refs/heads/main/media/unstable_soul.mp4" autoplay muted loop></video> <center>A unstable soul that bursts and drops its contents</center> ## Commands & Permissions - **/soulgraves** or **/sg**: The main command for Soul Graves. Will give version information to the sender. - Permission: `soulgraves.command` - **/soulgraves reload**: Reload the plugin's configuration files. - Permission: `soulgraves.command.reload` - **/soulgraves back**: Teleports the sender to their latest soul. Only works in-game. - Permission: `soulgraves.command.back` #### Other Permissions - `soulgraves.spawn`: Allows a soul to spawn if `permission-required` is true in the config. ## Configuration <details> <summary>config.yml</summary> ```yml # DO NOT EDIT file-version DIRECTLY file-version: 4 # If set true, players will require "soulgraves.spawn" permission to spawn a soul upon death permission-required: false # Time in seconds for how long a soul remains in its stable state before becoming unstable time-stable: 240 # Time in seconds for how long a soul will show the unstable animation for before bursting # The total time the soul is available to collect is time-stable + time-unstable time-unstable: 60 # How much it costs to teleport to your soul, set to 0.0 to disable teleport-cost: 0.0 # Whether to freeze the timer when the owner of the soul is offline # This feature cannot detect the online status of players in other subservers on a proxy server offline-owner-timer-freeze: false # Whether to notify nearby players when a soul bursts notify-nearby-players: true # The radius in blocks to alert nearby players when a soul bursts notify-radius: 128 # Whether to notify the owner of a soul when it is collected by another player notify-owner-pickup: true # The percentage of the soul's XP to give to the owner of the soul when it is collected by the owner xp-percentage-owner: 0.5 # The percentage of the soul's XP to give to a player who isn't the owner when the soul is collected by that player xp-percentage-others: 0.2 # The percentage of the soul's XP to drop when the soul bursts xp-percentage-burst: 0.2 # Whether souls are only collectible by their owners owner-locked: false # The maximum number of souls a player can hold simultaneously. Set to 0 for unlimited. # If the limit is exceeded, the oldest soul will explode max-souls-per-player: 0 # Whether souls will drop items when they burst souls-drop-items: true # Whethe