RelishDeath

⚰️ Advanced Death Inventory Protection • Graves • Holograms • Particle Trails





















Why Choose RelishDeath?

RelishDeath provides the most advanced death inventory protection system with real server-side entities, particle guidance, and comprehensive backup systems. Built for modern Minecraft servers with performance and reliability in mind.




✨ Key Highlights

⚰️ Real Server-Side Entities - Uses ItemDisplay, TextDisplay, and Interaction entities (Geyser compatible)

Particle Path Guidance - Visual trails leading players to their graves

Perfect Item Serialization - NBT-API ensures 100% accurate item restoration

Async Operations - Non-blocking database operations for optimal performance

Multi-World Support - Works across all dimensions and custom worlds




Requirements


Component
Requirement

Minecraft 1.21+

Server Paper, Purpur, or Paper-based forks

Java 21+

Dependencies PacketEvents (required), Vault (optional)


Features Overview


Free Version

• ✅ Basic grave system with real server-side entities and holograms
• ✅ Advanced holograms - Enhanced hologram features and customization
• ✅ Particle navigation - Dynamic particle trails that guide players to graves
• ✅ Remote restoration - Restore items from graves without visiting them
• ✅ Void death protection with smart safe location placement
• ✅ Keep inventory integration - respects vanilla and plugin keep settings
• ✅ XP protection with configurable keep percentages
• ✅ Multi-grave support - players can have multiple active graves
• ✅ Auto-respawn with configurable countdown
• ✅ Safe teleportation - prevents teleporting into walls or lava
• ✅ Basic commands - list, locate, teleport to graves
• ✅ Multi-world support - works across all dimensions and custom worlds
• ✅ Performance optimized - spatial partitioning for 500+ players

⭐ Premium Version

• ⭐ Admin Recovery System - Death backup system with SQLite-backed backups and admin GUI
• ⭐ Black Market - Expired graves become purchasable with economy integration
• ⭐ Trust System - Share grave access with friends
• ⭐ Economy Integration - Vault support for grave costs and marketplace

Installation

1. Download the plugin
2. Install Dependencies:
   • PacketEvents (Required)
   • Vault (Optional - for economy)
3. Place the JAR file in your server's plugins folder
4. Start/Restart your server
5. (Optional) For premium features, buy a license key from M5LB Store
6. Place license key in config.yml
7. Reload the plugin

# Quick setup commands
/rd help # View all commands
/rd info # Check plugin status
/rd reload # Reload configuration

Commands & Usage
Player Commands
Command Description Example
/rd list Show your active graves /rd list
/rd locate [#] Track route to grave with particles /rd locate 1
/rd restore [#] Restore items from grave remotely /rd restore 2
/rd stash View stored items interface /rd stash
/rd trust <player> Add player to trusted list /rd trust Steve
/rd untrust <player> Remove player from trusted list /rd untrust Steve
/rd unlock [#] Make grave public /rd unlock 1
/rd blackmarket Browse black market /rd blackmarket
/rd info Plugin statistics /rd info
Admin Commands
Command Description Example
/rd tp|teleport [#] Teleport to your grave /rd tp 1
/rd reload Reload configuration /rd reload
/rd saves View death backup GUI /rd saves
⚙️ Configuration
RelishDeath uses:

• plugins/RelishDeath/config.yml
• plugins/RelishDeath/lang/en.yml
• plugins/RelishDeath/relishdeath.db (SQLite)

Quick Example
license-key: "INSERT_KEY_HERE"

timers:
groups:
default: 5
vip: 30
premium: 60
admin: 120
permanent: -1

notifications:
sounds-enabled: true
auto-respawn:
enabled: true
delay-seconds: 0
allow-cancel: false

⚡ Timer Permissions

• relishdeath.timer.vip
• relishdeath.timer.premium
• relishdeath.timer.admin
• relishdeath.timer.permanent

⚰️ Grave System
Real Server-Side Entities
RelishDeath creates real server-side entities for graves with full Geyser compatibility:


Entity Components:

• ItemDisplay entities show the player's helmet/head
• TextDisplay entities show countdown and item count
• Interaction entities handle right-click grave opening
• Fully compatible with Geyser (Bedrock players)

️ Void Death Protection
Smart grave placement system for void deaths:

Protection Features:

• Automatic detection when players die below world minimum height + threshold
• Area search in configurable radius for safe locations using Minecraft's height maps
• Performance optimized with O(1) operations (no loops)
• Safe placement ensures graves spawn on solid ground with air space above

Particle Navigation System
Dynamic particle trails guide players to their graves:

Navigation Features:

• Automatic activation when near graves (configurable distance)
• Ground-following paths that navigate around obstacles
• Distance indicators show remaining distance to grave
• Multiple trail types with customizable particle effects
• Performance optimized with smart rendering limits

Death Backup System
Admin Recovery Tools
Comprehensive backup and recovery system for server administrators:


Backup Features:

• Automatic backups of every death event (stored in SQLite)
• Admin GUI interface for browsing all player deaths
• Inventory restoration with overflow protection system
• Detailed death information including cause, location, time, and XP

Death Information Tracking
Death backups are stored in plugins/RelishDeath/relishdeath.db (SQLite) and include inventory, XP, cause, time, and location.

Trust & Security System
Player Trust Management
Players can share grave access with friends:

Trust Features:

• Individual trust - Add specific players to your trusted list
• Configurable limits - Trust limits per permission group
• Easy management - Simple commands for adding/removing trusted players

Security Options
trust:
enabled: true
max-trusted-players: 10

Black Market System
Expired Grave Trading
When graves expire, they become available for purchase:


Market Features:

• Automatic listing when graves expire naturally
• Economy integration with Vault-compatible plugins
• Configurable pricing based on grave contents value
• Optional listing expiration (expiration-hours, use -1 to keep until purchased)
• Full content transfer - buyer receives all grave items

Market Configuration
economy:
enabled: true
marketplace-enabled: true
black-market:
enabled: true
expiration-hours: -1

graves:
on-expire: black-market

stash:
expiration-hours: 24

Performance & Scalability
⚡ Optimization Features

• Spatial Partitioning - Efficient hologram rendering for 500+ players
• Async Database Operations - Non-blocking SQLite operations
• Height Map Usage - O(1) void protection using Minecraft's cached data
• Entity Culling - Holograms only render when players are nearby
• Particle Optimization - Smart trail rendering with distance limits

Scalability Options

• SQLite for small-medium servers (0-200 players)
• Configurable render distances for performance tuning
• Memory-efficient caching with automatic cleanup

License
RelishDeath is proprietary software. All rights reserved.

License Types
Free Version

• Available without license key
• Includes basic grave system, advanced holograms, particle navigation, remote restoration, void protection, auto-respawn, and core commands
• May be used on unlimited servers
• NOT open source - modification and redistribution prohibited

⭐ Premium Version

• Requires valid license key from M5LB Store
• Includes premium-only features such as Admin Recovery System, Black Market, Trust System, and Economy Integration
• License key tied to purchaser and server count
• NOT open source - modification and redistribution prohibited

For full license terms, see LICENSE file.

Obtain Premium License
To get a premium license key:

• Buy a key from M5LB Store

Made with ❤️ by M5LB