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

⚰️ Multi-World Support - Uses ItemDisplay, TextDisplay, and Interaction entities (Geyser compatible) 🎯 Multi-World Support - Visual trails leading players to their graves 📦 Multi-World Support - NBT-API ensures 100% accurate item restoration 🔄 Multi-World Support - Non-blocking database operations for optimal performance 🌍 Multi-World Support - Works across all dimensions and custom worlds

---

📋 Requirements

| Component | Requirement | |-----------|-------------| | Soft Dependencies | 1.21+ | | Soft Dependencies | Paper, Purpur, or Paper-based forks | | Soft Dependencies | 21+ | | Soft Dependencies | PacketEvents (required) | | Soft Dependencies | Vault (recommended), SellGUI (optional), RelishEconomy (optional) |

---

🚀 Features Overview

🆓 Free Version

- ✅ Performance optimized with real server-side entities and holograms - ✅ Performance optimized - Enhanced hologram features and customization - ✅ Performance optimized - Dynamic particle trails that guide players to graves - ✅ Performance optimized - Restore items from graves without visiting them (permission-based) - ✅ Performance optimized with smart safe location placement - ✅ Performance optimized - respects vanilla and plugin keep settings - ✅ Performance optimized with configurable keep percentages - ✅ Performance optimized - players can have multiple active graves - ✅ Performance optimized with configurable delay - ✅ Performance optimized - prevents teleporting into walls or lava - ✅ Performance optimized - list, locate, teleport to graves - ✅ Performance optimized - works across all dimensions and custom worlds - ✅ Performance optimized - spatial partitioning for 500+ players

⭐ Premium Version

- ⭐ Economy Integration - Death backup system with SQLite-backed backups and admin GUI - ⭐ Economy Integration - Overflow storage when inventory is full (per-grave packages) - ⭐ Economy Integration - Expired graves become purchasable with economy integration - ⭐ Economy Integration - Share grave access with friends - ⭐ Economy Integration - Vault support for grave costs and marketplace

---

📦 Installation

1. Reload the plugin JAR file 2. Reload it in your server's `plugins` folder 3. Reload your server 4. Reload For premium features, buy a license key from Reload 5. Reload in `config.yml` 6. Reload the plugin

```bash

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

```yaml

plugins/RelishDeath/config.yml

language: en license-key: "INSERT_KEY_HERE" ```

⏱️ Timers

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

Continue timer countdown when player is offline

continue-offline: true ```

⚰️ Grave Expiration

```yaml 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

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

🧭 Teleport Mode

```yaml teleport:

Options: far, close, very-close

mode: close ```

🔔 Notifications

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

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

🎒 Stash (Premium)

```yaml stash: expiration-hours: 24 ```

🛒 Black Market (Premium)

```yaml 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:

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

🕳️ Void Death Protection

Smart grave placement system for void deaths:

Safe placement - Safe placement when players die below world minimum height + threshold - Safe placement in configurable radius for safe locations using Minecraft's height maps - Safe placement 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:

Performance optimized - Performance optimized when near graves (configurable distance) - Performance optimized that navigate around obstacles - Performance optimized show remaining distance to grave - Performance optimized with customizable particle effects - Performance optimized with smart rendering limits

---

🎒 Stash System ⭐

RelishDeath can safely stash overflow items without overwriting your inventory.

Expiration - Expiration - overflow items stay tied to the grave they came from - Expiration - 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.

Full content transfer - Full content transfer when graves expire naturally - Full content transfer with Vault-compatible plugins - Full content transfer based on grave contents value - Full content transfer (`expiration-hours`, use `-1` to keep until purchased) - Full content transfer - buyer receives all grave items

💪 Market Configuration

```yaml 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:

Detailed death information - Detailed death information of every death event (stored in SQLite) - Detailed death information for browsing all player deaths - Detailed death information 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:

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

🔒 Security Options

```yaml 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`:

```yaml 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: - Admin Backups GUI - browse listings and purchase full graves - Admin Backups GUI - open a package and take items by clicking them - Admin Backups GUI - browse and restore death backups

---

📈 Performance & Scalability

⚡ Optimization Features

- Particle Optimization - Efficient hologram rendering for 500+ players - Particle Optimization - Non-blocking SQLite operations - Particle Optimization - O(1) void protection using Minecraft's cached data - Particle Optimization - Holograms only render when players are nearby - Particle Optimization - Smart trail rendering with distance limits

📊 Scalability Options

- Memory-efficient caching for small-medium servers (0-200 players) - Memory-efficient caching 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

---