RelishDeath

🌟 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) |
| Soft Dependencies | Vault (recommended), SellGUI (optional), RelishEconomy (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 (permission-based)
• ✅ 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 delay
• ✅ 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
• ⭐ Stash - Overflow storage when inventory is full (per-grave packages)
• ⭐ 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 JAR file
2. Place it in your server's plugins folder
3. Start/Restart your server
4. (Optional) For premium features, buy a license key from M5LB Store
5. Place license key in config.yml
6. 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 ⭐ | Open your stash | /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 ⭐ | Open admin death backups GUI | /rd saves |
| /rd license | View license status and premium feature availability | /rd license |

🔧 Configuration

Core Setup

# plugins/RelishDeath/config.yml
language: en
license-key: "INSERT_KEY_HERE"

⏱️ Timers

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

# Continue timer countdown when player is offline
  continue-offline: true

⚰️ Grave Expiration

graves:
  # Options: black-market, stash, drop
  on-expire: black-market

⚡ Timer Permissions

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

🎯 Particle Navigation

particles:
  activation-distance: 50.0
  types:
    far: FLAME
    close: SOUL_FIRE_FLAME
    very-close: END_ROD

🧭 Teleport Mode

teleport:
  # Options: far, close, very-close
  mode: close

🔔 Notifications

notifications:
  periodic-reminders: true
  reminder-intervals: [180, 120, 60]

  reminders:
    display:
      chat: true
      actionbar: false
      title: false
      bossbar: false
    bossbar-seconds: 5

🎒 Stash (Premium)

stash:
  expiration-hours: 24

🛒 Black Market (Premium)

economy:
  enabled: true
  marketplace-enabled: true
  black-market:
    enabled: true
    # Use -1 to keep listings until purchased
    expiration-hours: -1

⚰️ 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

🎒 Stash System ⭐

RelishDeath can safely stash overflow items without overwriting your inventory.

Stash Features:

• Per-grave packages - overflow items stay tied to the grave they came from
• Click-to-claim items - take items one-by-one without losing slots
• Expiration - stash packages are kept for a limited time (configurable)

Command: /rd stash ⭐

🛒 Black Market System ⭐

When graves expire, they can be listed on the black market for other players to 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

💾 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 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

🌍 Multi-Language Support

🗣️ Built-in Languages

• en (English)
• ar (Arabic)

🌐 Custom Languages

1. Create a new file: plugins/RelishDeath/lang/es.yml
2. Set the language in config.yml:

language: es

RelishDeath uses MiniMessage in its language files (<red>, <gold>, <bold>, etc.).

🎨 GUI Features ⭐

RelishDeath premium GUIs are fully MiniMessage-based and include page navigation arrows:

• Black Market GUI - browse listings and purchase full graves
• Stash GUI - open a package and take items by clicking them
• Admin Backups GUI - browse and restore death backups

📈 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
• 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