RelishDeath

Minecraft 版本： 1.19 1.19.1 1.19.2 1.19.3 1.19.4 1.20 1.20.1 1.20.2 1.20.3 1.20.4 1.20.5 1.20.6 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11 26.1 26.1.1 26.1.2 26.2

平台： bukkit paper purpur spigot

标签： storage technology utility

? 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

? 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

? Admin Commands

? 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

? Integrations

? PacketEvents

RelishDeath uses PacketEvents for its grave visuals and particle effects.

?️ Vault API

Vault enables economy pricing for premium features such as the black market.

? RelishCurrencies

Optional integration for servers using RelishCurrencies as their economy layer.

? SellGUI

Optional integration for item value calculation when pricing black market listings.

? 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