————————————————————

Overview

AFSDeathKeeper is a Paper plugin designed to make player death recovery safer, cleaner and more immersive.

Instead of losing everything when a player dies, the plugin creates a temporary protected death tomb that stores the player's items. If the tomb expires, the inventory can still remain saved and be restored later through a configured recovery system, including NPC-based recovery for a more immersive survival experience.

This plugin is built for servers that want more than a simple death chest system. It adds protected tombs, hologram timers, persistent saves, optional economy integration and optional region checks.

————————————————————

Main Features

• Temporary death tombs on player death
• Owner-protected tomb access
• Hologram timer above the tomb
• Tomb expiration system
• Persistent inventory saving after expiration
• NPC-based recovery system
• Optional economy cost for restore
• Optional WorldGuard compatibility
• SQLite support
• Restart-safe persistence
• Anti-empty grave protection
• Utility / menu item filtering
• Safer and cleaner survival gameplay flow

————————————————————

How It Works

1. A player dies
2. A protected temporary tomb is created
3. Only the owner can access the tomb
4. A hologram timer shows the remaining lifetime
5. If the player recovers the tomb in time, everything is restored normally
6. If the tomb expires, the saved inventory can still remain available
7. The player can recover the expired inventory later through the configured restore system

————————————————————

Why Use AFSDeathKeeper

AFSDeathKeeper is not just a basic death chest plugin.

It is designed to provide a more complete death recovery flow for survival servers:

• temporary tombs
• protection
• hologram timers
• expiration logic
• persistent saved inventories
• immersive NPC restoration
• optional economy sink
• optional WorldGuard integration

The goal is to make death less frustrating without making it exploitable.

————————————————————

Compatibility

Server Software:

• Paper 1.21.11

Java:

• Java 21

Database:

• SQLite

Optional Hooks / Integrations:

• Vault
• EssentialsX
• FancyNPCs
• WorldGuard
• PlaceholderAPI

————————————————————

Anti-Abuse / Safety

• No empty tomb creation
• Utility / menu items can be ignored
• NPC restoration can use the same filters as grave creation
• Expired inventories remain controlled by the plugin
• Restart persistence is supported
• Optional economy requirement for restoration
• Optional protected-region checks for safer tomb placement

————————————————————

Commands

————————————————————

Permissions

————————————————————

PlaceholderAPI

If PlaceholderAPI support is enabled, AFSDeathKeeper placeholders can be used in scoreboards, menus, NPC dialogs and other compatible plugins.

These placeholders are useful for:

• DeluxeMenus
• TAB
• FancyDialogs
• scoreboards
• chat displays
• NPC dialogs

————————————————————

Configuration

Configurable parts can include:

• tomb lifetime
• hologram text
• restore behavior
• restore cost
• database settings
• ignored utility items
• NPC recovery options
• WorldGuard checks
• protection behavior
• cleanup and persistence logic

————————————————————

Installation

1. Drop the plugin jar into your plugins folder
2. Start or restart your server
3. Configure the plugin files
4. Select SQLite if needed
5. Setup Vault if you want paid restores
6. Setup FancyNPCs if you want NPC-based restoration
7. Setup WorldGuard if you want protected-region checks
8. Setup PlaceholderAPI if you want placeholder support
9. Reload or restart after configuration changes

————————————————————

Recommended Use Cases

AFSDeathKeeper is ideal for:

• Survival servers
• Semi-RP survival servers
• Community servers
• Custom progression servers
• Servers using immersive NPC systems

It is designed for server owners who want a safer and more polished death recovery system.

————————————————————

Current Version

• Version: 2.3.0
• Database: SQLite
• Platform: Paper 1.21.11
• Java: 21

————————————————————

Changelog

————————————————————

Support

If you find a bug or have a suggestion, feel free to use the resource discussion section.

Feedback, bug reports and improvement ideas are welcome.

————————————————————

Try It Live on AFS Network

AFSDeathKeeper is also running on my live server, where you can test the plugin directly in-game before using it on your own server.

See the tomb system, holograms and recovery flow in a real survival environment.

Live test server: afs-minecraft.duckdns.org