Eternal death drops

EternalDeathDrops – Backup & Eternal Death Drops

EternalDeathDrops is a lightweight, performance‑optimized plugin that combines two essential features for server administrators:

• Automated world backups – create scheduled backups of your worlds with custom categories and retention policies.
• Eternal death drops – items dropped on death never despawn (or have a configurable lifetime), ensuring no loot is lost.

✨ Features

• Flexible backup system

  • Built‑in categories: startup, hourly, manual
  • Fully customizable categories with independent intervals, folder names, and max backup count
  • Configurable world list – backup only the worlds you specify
  • Smart save‑wait algorithm (monitors .mca and .dat files) with adjustable stability checks and timeouts
  • Asynchronous ZIP compression with adjustable level (0–9)
  • Automatic cleanup of old backups

• Eternal death drops

  • Items dropped by players are marked as "eternal" – they will never despawn (or will despawn after a customizable time in ticks)
  • Persistent metadata across server restarts – items keep their lifetime counter
  • Full support for item pickups – metadata is removed when picked up, and the item returns to normal behaviour
  • Fully customizable and includes many features!

• Performance first

  • All heavy operations (backup creation, old backup deletion) run asynchronously
  • ChunkLoadEvent only processes items in the loaded chunk, not the whole world
  • Minimal impact on MSPT – tested with 150 simultaneous player deaths with full inventories – MSPT increased by only ~14% (from ~7.X ms to 8.0 ms) during normal chunk loading, and up to 30 ms when loading chunks with thousands of items (which would drop client FPS from 120 to below 1).

• Full configurability

  • All features can be enabled/disabled via config.yml
  • Set your own world folders, lifetime ticks, backup intervals, retention limits, and compression level

📖 Commands

All commands require op by default.

🔐 Permissions

• eternaldeathdrops.backup – allows using /backup
• eternaldeathdrops.clear – allows using /cleareternaldrops
• eternaldeathdrops.reload – allows using /eternaldeathdrops reload

⚡ Performance

• Tested on paper 1.21.11 with 6000 stacks of items in one chunk and mspt increased by 10-20%(from ~9-10 mspt to ~10-12 mspt).
• Tested with default config.
• Backups can be produced in up to 3 seconds of waiting from /backup to .zip file in backup directory.

🔧 Compatibility

• Plugin was coded on just bukkit api so it compatible with Bukkit, Paper, Purpur, Spigot and other server-cores that have bukkit api in them(do not compatible with folia).
• Plugin uses only 1.14+ bukkit api so it can be used in various servers.

⚙️ Configuration

The plugin generates a default config.yml on first run. Key settings:

# Enable/disable plugin features
features:
  backup: true          # Enable automated backups. Default: true
  eternal-items: true   # Enable eternal death drops. Default: true

# World folders to backup (list of folder names in server root)
# If not specified or empty, default worlds will be used: world, world_nether, world_the_end
worlds:
  - "world"
  - "world_nether"
  - "world_the_end"

# Lifetime of eternal items in ticks (0 = forever, 20 ticks = 1 second)
eternal-lifetime-ticks: 0

# Time beetween checks for expired items and time beetween ticking timers(default = 20 ticks = 1 second)
# The higher this value the more performance, but it can cause smaller accuracy of lifetime timers
time-between-checks: 20

# This option controls do timers of item's lifetime tick in only
# loaded chunks(default = true)
do-items-only-tick-in-loaded-chunks: true

# This option controls can other players pickup your death's items( default = true)
can-other-players-pickup-death-drops: true

# This option controls can mobs pickup playrs death's items(default = true)
can-other-mobs-pickup-death-drops: true

# These options controls how items spread after death(default values are equal to vanilla)
death-item-spread:
  x: 0.5          # Random offset on X axis (total range = ±x/2). Default: 0.5
  y: 0.2          # Vertical offset added to the drop position. Default: 0.2
  z: 0.5          # Random offset on Z axis (total range = ±z/2). Default: 0.5

do-items-glow: false # If true, items will glow white when dropped. Default: false

# Maximum number of backups to keep for each category (set to 0 to disable the category)
max-backups:
  startup: 3
  hourly: 3
  manual: 3

# Interval for hourly backup in ticks (0 = disabled, 20 ticks = 1 second)
hourly-interval: 72000   # 1 hour

# Timeout for waiting for save completion in ticks.
# If set to 0 or negative, the default (600 ticks = 30 seconds) will be used.
# Increase this value if you see frequent timeout warnings.
save-timeout-ticks: 600

# Number of consecutive checks (every 200ms) that must show no changes
# to consider save completed. Default 10 = 2 seconds of stability.
stability-checks: 10

# Delay after stability is achieved, in ticks (20 ticks = 1 second).
# This extra wait ensures all data is flushed. Default 20 = 1 second.
post-stability-delay: 20

# ZIP compression level (0 = no compression, 9 = maximum, default 6)
compression-level: 6

# Custom backup categories (all disabled by default)
# You can create as many of those as you need
custom-categories:
  custom1:
    enabled: false
    interval: 36000      # 30 minutes
    folder-name: "custom1_backups"
    max_backups: 3
  custom2:
    enabled: false
    interval: 144000     # 2 hours
    folder-name: "custom2_backups"
    max_backups: 3

# Options below are WIP and do not affect anything yet
# These options control how glowing effect will be applied to items
item-glowing:
  enabled: false
  color:
    static: true # If true, the color will be the same for all items
    color: "000000" # Only for static color. Default: "000000"
    based-on-the-dimensions: false # If true, the color will be based on the dimension player died in or items in. Default: false
    based-on-the-player-dim: true # If true, the color will be based on the player death location's dimension. Default: true
    bosed-on-the-items-dim: false # If true, the color will be based on the item location's dimension. Default: false
    dimensions: # Controls the color for dimensions. Default values: "- overworld: LIME"\n- "nether: RED"\n- "end: BLACK". Handle only minecraft's teams colors
      - "overworld: LIME"
      - "nether: RED"
      - "end: PURPLE"
    based-on-the-owner: false # If true color will be based on the owner of the item. Default: false
#  only-to-owner: false # If true, the glowing effect will only be visible to the owner of the item. Default: false