SoulVault

WHAT IT DOES

When a player dies, their inventory is stored safely inside a protected vault at the location where they died.

Instead of items scattering across the ground, burning in lava, despawning while the player runs back, or being stolen by another player, SoulVault keeps everything safe.

FEATURES

Protected Death Vaults

• Stores inventory, armour, offhand items and experience
• Vaults can be locked to their owner for a configurable amount of time
• Vaults can automatically become public after the protection period expires
• Floating hologram showing the owner, death cause, time remaining and lock status
• Supports any block as the vault
• Optional player head vault using the dead player's skin
• Protected from explosions, fire, lava, water and pistons
• Armour automatically equips when collected

Finding Your Vault

• /sv opens a menu containing all your vaults
• /sv list lists your vaults in chat
• /sv tp teleports you back to a vault
• Optional teleport warm-up that cancels if you move
• /sv take remotely collects vault contents
• Clickable Teleport, Fetch and Unlock buttons in chat
• Optional compass pointing to your latest vault
• Configurable distance limits and economy costs

Graveyards

• Create dedicated graveyard regions
• Deaths can be redirected to a graveyard instead of the death location
• Each graveyard can have its own grave block, hologram style and priority
• Place exact grave locations manually
• Automatically scan regions for valid grave locations
• Optional graveyard respawn point

Rules That Fit Your Server

• Per-rank settings through groups.yml
• Per-death-cause rules
• Different behaviour for lava, void, PvP and more
• Item rules for excluding or destroying specific items
• PvP-specific settings
• Configure whether the killer can loot the vault
• Random item loss and spawn chances
• Configurable cooldowns
• Trusted players can access locked vaults

Staff Tools

• Archive and restore removed vaults
• Recover vaults after expiry, crashes or accidents
• Detailed audit logs
• Track who removed items from vaults
• Build and break protection around active vaults
• Optional WorldGuard, GriefPrevention and Lands support

Presentation

• Particle effects when vaults spawn, open and disappear
• Configurable idle particle effects
• Multiple particle shapes
• Advanced hologram customization
• Control scale, billboard, background, opacity, shadow and brightness
• Optional floating item showing valuable loot
• Every plugin message is editable

COMMANDS

/sv
Open your vault menu.

/sv list
List your vaults in chat.

/sv tp [number]
Teleport to a vault.

/sv take [number]
Collect vault contents remotely.

/sv unlock [number]
Unlock a vault early.

/sv trust
Allow a player to access your locked vaults.

/sv untrust
Remove a trusted player.

/sv trusted
View your trusted players.

/sv toggle
Enable or disable vault creation for yourself.

/sv reload
Reload the plugin configuration.

/sv admin restore
List and restore removed vaults.

/svgraveyard
Create and manage graveyards.

Aliases: /soulvault, /vault and /vaults.

COMPATIBILITY

Minecraft 1.20 through 26.2

Supported server software:

• Paper
• Purpur
• Spigot
• CraftBukkit
• Folia

Java 17+

Optional integrations:

• Vault
• PlaceholderAPI
• WorldGuard
• GriefPrevention
• Lands

Nothing is required. SoulVault works perfectly without additional plugins.

INSTALLATION

1. Download SoulVault.
   
   
2. Place the jar inside your plugins folder.
   
   
3. Start or restart your server.
   
   
4. Configure additional options in config.yml.
   

The default configuration is designed to work immediately.

When updating SoulVault, new configuration options can be added while preserving your existing settings.

PLACEHOLDERS

With PlaceholderAPI installed:

%soulvault_count%
Number of vaults owned.

%soulvault_time_left%
Time remaining on the newest vault.

%soulvault_items%
Items waiting to be collected.

%soulvault_x%
X coordinate of the newest vault.

%soulvault_y%
Y coordinate of the newest vault.

%soulvault_z%
Z coordinate of the newest vault.

%soulvault_world%
World of the newest vault.

DEVELOPER API

SoulVault provides a simple API for developers.

SoulVaultAPI api = SoulVaultAPI.get();

List vaults = api.getVaults(player);

Available events:

VaultCreateEvent
Cancellable.

VaultOpenEvent
Cancellable.

VaultRemoveEvent
Not cancellable.

SUPPORT

Found a bug or have a feature suggestion?

Post it in the discussion thread.

For debugging, enable debug: true in the configuration and include the relevant console output when reporting an issue.

Protect what matters.

SoulVault — Death shouldn't mean starting from nothing.