SoulChest Documentation
Creating a Soul Chest
When a player dies, SoulChest automatically creates a protected soul chest at or near the death location.

The chest stores:

• Inventory contents
  
  
• Armor
  
  
• Off-hand items
  
  
• Experience points
  

If the death location is unsafe (such as lava, void, or invalid blocks), SoulChest will attempt to find a safer nearby location.

Managing Soul Chests
Use the command:

/sc chests

This opens the Soul Chest Manager GUI.

From the GUI, players can:

• View all active soul chests
  
  
• Check chest information
  
  
• Preview stored contents
  
  
• Teleport to a chest
  
  
• Fetch a chest to their location
  
  
• Unlock a chest
  
  
• Delete a chest
  

Teleporting to a Soul Chest
To teleport directly to a soul chest:

/sc tp <id>

Replace <id> with the chest ID shown in the GUI.

Example:

/sc tp 15

Fetching a Soul Chest
To move a soul chest to your current location:

/sc fetch <id>

Example:

/sc fetch 15

This is useful when a chest is located far away or in a difficult-to-reach area.

Unlocking a Soul Chest
To remove protection from a soul chest:

/sc unlock <id>

Once unlocked, the chest can be accessed normally.

Deleting a Soul Chest
To permanently remove a soul chest:

/sc delete <id>

Only delete a chest if you no longer need its contents.

Disabling Soul Chest Creation
Players with permission can toggle soul chest creation:

/sc toggle

When disabled, future deaths will not create soul chests for that player.

Chest Expiration
Soul chests can expire after a configurable amount of time.

When a chest expires:

• The chest is automatically removed.
  
  
• Stored contents are permanently lost.
  
  
• Associated holograms are removed.
  

Server owners can configure expiration settings in the plugin configuration.

Holograms
SoulChest can display holograms above active chests.

Depending on configuration, holograms may display:

• Owner name
  
  
• Chest ID
  
  
• Death cause
  
  
• Time remaining until expiration
  

Administrative Commands
View Another Player's Chests
/sc chests <player>

Teleport to a Player's Chest
/sc admin tp <player> <id>

Preview Chest Contents
/sc admin view <player> <id>

Delete a Player's Chest
/sc admin delete <player> <id>

Set Chest Limits
/sc admin setlimit <player> <amount>

Reset Chest Limits
/sc admin resetlimit <player>

Permissions
The plugin uses a permission-based system to control access to features.

Examples include:

• Opening the Soul Chest GUI
  
  
• Teleporting to chests
  
  
• Fetching chests
  
  
• Unlocking chests
  
  
• Administrative actions
  
  
• Custom chest limits
  

Refer to the permissions section of the resource page for the complete permission list.

Troubleshooting
My chest did not appear
Possible causes:

• Soul chests are disabled for your player.
  
  
• The chest limit has been reached.
  
  
• Another plugin cancelled the death event.
  
  
• Configuration settings prevented chest creation.
  

I cannot access my chest
Check:

• You have permission to use the feature.
  
  
• The chest has not expired.
  
  
• The chest still exists in the GUI.
  

Holograms are not showing
Verify that:

• Holograms are enabled in the configuration.
  
  
• Any required hologram dependency is installed.
  
  
• The server has been restarted after configuration changes.
  

Configuration
Most plugin behavior can be customized, including:

• Chest expiration times
  
  
• Hologram settings
  
  
• Chest limits
  
  
• Teleportation options
  
  
• Fetch settings
  
  
• Protection rules
  
  
• Storage settings
  

Edit the configuration files and reload the plugin using:

/sc reload