RelishDeath

<div align="center"> ## ⚰️ Advanced Death Inventory Protection • Graves • Holograms • Particle Trails !(https://github.com/iM5LB/RelishDeath/blob/main/docs/assets/RelishDeathBanner.png?raw=true) (https://github.com/iM5LB/RelishDeath/raw/main/docs/assets/M5LBStore.png)](https://m5lb.run.place) (https://img.shields.io/badge/Discord-Support-7289da?style=for-the-badge&logo=discord)](https://discord.gg/hjKcHavRjT) (https://img.shields.io/badge/Docs-Read-9a1218?style=for-the-badge&logo=gitbook)](https://im5lb.github.io/RelishDeath) (https://img.shields.io/badge/🐛%20Issues-Report-orange?style=for-the-badge)](https://github.com/iM5LB/relishdeath/issues) (https://img.shields.io/badge/Store-License%20Keys-gold?style=for-the-badge)](https://m5lb.run.place/?buy=relish-death) (https://img.shields.io/badge/💖%20Donate-Love-ff69b4?style=for-the-badge)](https://creators.sa/m5lb) </div> --- ## 🌟 **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 (https://m5lb.run.place/?buy=relish-death) 5. **Place license key** 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 | `