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)