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 | Command | Description | Permission | |---------|-------------|------------| | `/backup` | Creates a manual backup of all worlds | `eternaldeathdrops.backup` | | `/cleareternaldrops` | Removes all eternal death drop items from the server | `eternaldeathdrops.clear` | | `/eternaldeathdrops reload` | Reloads the plugin configuration from disk | `eternaldeathdrops.reload` | 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: ```yaml # 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