Death On The Spot

DeathOnTheSpot v1.3.5 - You choose where your bits go when you die. Nobody wants their bits to fall in the wrong hands!

DeathOnTheSpot is a Kotlin-based Minecraft plugin for Paper servers that revolutionizes death mechanics. Instead of scattering items across the world, players' inventories are securely saved upon death and can be retrieved from a designated "death chest" set by administrators.

This plugin is the first of "Matt's Plugins" - expect more to come!

Key Features

- Secure Inventory Preservation: No more lost items! Full inventories are serialized to JSON and stored persistently - Admin-Controlled Retrieval: Set a death chest location with /setdeathchest – players interact with it to access a virtual GUI for safe item recovery - Double Chest Support: Automatic detection and configuration of double chests with 54-slot per page storage capacity - Advanced GUI System: Two view modes - "All Together" and "By Death" with intelligent item stacking and prioritization - One-by-One Retrieval: Items are removed from storage only when claimed, preventing accidental loss - Automatic Cleanup: Data files are deleted once inventories are fully retrieved - Comprehensive Admin Tools: Full command suite for managing death chests and player data - Migration System: Seamless upgrades from previous versions with automatic data migration

How It Works

1. Player dies → Inventory saved to plugins/DeathOnTheSpot/death_data/{UUID}.json 2. Admin sets chest with /setdeathchest while looking at a chest block 3. Players right-click the chest → Open advanced GUI → Click items to retrieve 4. Items vanish from storage upon claim with proper amount tracking 5. Double chest detection automatically handles adjacent chest placement

Commands & Permissions

- /setdeathchest - Set death chest location (deathonthespot.setchest) - /deathchest <list|clear|view|reload|upgrade> - Admin management (deathonthespot.admin) - /deathchest upgrade - Upgrade to double chest (deathonthespot.upgrade)

Installation

- Requires: Java 21+, Paper 1.21.10+ - Setup: Drop JAR into plugins/, restart server, configure chest location - Migration: Automatic upgrade from previous versions with backup creation

Dependencies

- Paper API (server-provided) - Kotlin Stdlib 2.1.0, Jackson 2.15.2 (bundled in JAR)