DeathChest999

Bug Fixes

• Fixed Permission Enforcement - The deathchest.use permission is now enforced before creating a death chest.
• Fixed Keep Inventory Duplication - Death chests are no longer created when keepInventory is enabled, preventing duplicate item retention.
• Fixed Compass Give-On-Death Setting - compass.give-on-death now correctly gives players a death chest compass after death (when enabled).
• Fixed Protection Toggle Behavior - protection.enabled now properly controls whether non-owners are blocked from opening/breaking death chests.
• Fixed Loot-After-Expire Behavior - protection.allow-loot-after-expire now allows non-owners to access expired chests when enabled.
• Fixed Drop-On-Expire Behavior - protection.drop-items-on-expire now drops stored chest items to the ground when expiration cleanup removes a chest.
• Fixed Chest Inventory Save Targeting - Chest contents are now saved by tracked chest session ID instead of inventory title matching, preventing wrong-chest saves.
• Fixed Admin Chest Editing Persistence - Admin-opened chest inventories now persist changes correctly on close.
• Fixed Owner XP Security - Stored XP is now only returned to the chest owner, not to non-owners or admins.
• Fixed Economy Lockout Edge Case - Paid chests no longer become permanently locked if Vault/economy is unavailable; they auto-unlock instead.
• Fixed Compass Lore Overwrite - Custom compass.lore config lines are now preserved when the compass target updates.
• Fixed Missing Compass Tab Completion - /deathchest compass now appears in tab completion for players with permission.
• Fixed Reload Scheduler Handling - Reload now correctly starts/stops recurring compass, hologram, and ambient tasks based on current config.
• Fixed Economy Default Fallback - economy.cost is now used as the fallback value for unlisted world economy cost settings.
• Fixed Expiring-Soon Timing Validation - Expiring-soon notifications no longer spam from invalid timing combinations (such as notice >= chest lifetime).
• Fixed UUID Crash Paths - Unsafe UUID parsing paths were hardened to prevent command/listener crashes from malformed chest data.
• Fixed Hologram Lifetime Accuracy - Hologram countdown updates now respect each chest's customLifetime value.

New Features

Death Chest Compass

• Players can now obtain a compass that points directly to their nearest death chest
• Use /deathchest compass to receive a tracking compass
• Right-click the compass to manually refresh its target location
• Compass displays target world, coordinates, and distance in the item description
• Compass automatically updates direction periodically while held
• Optional setting to automatically give players a compass when they die

Enhanced Chest Protection

• Other players can no longer open or break death chests that don't belong to them
• Only the chest owner can access their items while the timer is active
• Configurable option to allow other players to loot the chest after the timer expires
• Configurable option to drop items on the ground when a chest expires
• Only the chest owner receives XP stored in the chest

New Commands

• /deathchest compass - Receive a compass that tracks your nearest death chest

New Configuration Options

• compass.enabled - Enable or disable the compass feature
• compass.update-interval - How often the compass updates its target (in ticks)
• compass.give-on-death - Automatically give players a compass when they die
• compass.name - Custom display name for the compass item
• compass.lore - Custom lore lines for the compass item
• protection.enabled - Enable or disable chest protection from other players
• protection.allow-loot-after-expire - Allow non-owners to loot after timer expires
• protection.drop-items-on-expire - Drop items on the ground when chest expires

New Permissions

• deathchest.compass - Allows players to use the compass command

Bug Fixes

• Fixed Armor Duplication - Resolved an issue where armor pieces were being saved to the death chest twice, causing players to receive duplicate armor when retrieving their items

New Features

Customizable Messages System

• Added full message customization through config.yml
• All plugin messages can now be edited by server administrators
• Support for color codes using the ampersand (&) symbol
• Placeholder support for dynamic values including:
  • %player% - Player name
  • %world% - World name
  • %x%, %y%, %z% - Coordinates
  • %time% - Time remaining or delay
  • %items% - Item count
  • %xp% - Experience points
  • %cost% - Economy cost
  • %max% - Maximum chest limit
  • %distance% - Distance to chest
  • %created% - Creation timestamp
  • %count% - Restored chest count
  • %amount% - Item amount
  • %item% - Item name
• Configurable message prefix

Per-World Settings

• Death chests can now be enabled or disabled per world
• Configurable chest lifetime per world
• Configurable economy cost per world
• Configurable XP storage percentage per world
• Default world settings for unlisted worlds
• Useful for disabling death chests in minigame worlds or adjusting settings for different dimensions

Particle and Sound Effects

• Configurable particle effects when a death chest is created
• Configurable particle effects when a death chest is opened
• Configurable particle effects when a death chest expires
• Ambient particle effects around active death chests
• Configurable sound effects for chest creation, opening, and expiration
• Adjustable particle count for all effect types
• Adjustable sound volume and pitch
• Configurable ambient effect interval
• All effects can be individually enabled or disabled

Floating Holograms

• Floating text display above death chests using invisible armor stands
• Displays owner name above the chest
• Displays countdown timer showing time remaining
• Displays item count stored in the chest
• Displays XP amount stored in the chest
• Fully customizable hologram lines through config
• Configurable hologram height offset
• Configurable hologram update interval
• Holograms automatically update to show current time remaining
• Holograms automatically removed when chest expires or is emptied

XP Storage System

• Player experience points are now saved when dying
• XP is stored in the death chest along with items
• XP is returned to the player when opening the death chest
• Configurable XP storage percentage (0-100%)
• Per-world XP storage percentage settings
• XP amount displayed in hologram and info command

Admin Commands

• New /deathchest admin command group for server administrators
• /deathchest admin list - View all active death chests on the server with owner, location, and time remaining
• /deathchest admin delete - Delete a specific player's death chest
• /deathchest admin tp - Teleport to a player's death chest location
• /deathchest admin view - View the contents of a player's death chest without opening it
• /deathchest admin restore - Restore all recently expired death chests
• Admin permission to open other players' death chests
• Admin permission to break other players' death chests

Info Command

• New /deathchest info command for players
• Displays detailed information about all active death chests
• Shows exact chest location with world and coordinates
• Shows detailed time remaining in hours, minutes, and seconds
• Shows total item count stored in each chest
• Shows XP amount stored in each chest
• Shows distance from player's current location to each chest
• Shows creation timestamp for each chest

Expired Chest System

• Expired death chests are now saved to a separate file
• Administrators can restore expired chests using the restore command
• Expired chest data includes original location, contents, owner, and XP
• Restoration creates new death chests with the saved contents

Tab Completion

• Full tab completion support for all commands
• Tab completion for subcommands (list, back, info, reload, admin)
• Tab completion for admin subcommands (list, delete, tp, view, restore)
• Tab completion for player names in admin commands
• Permission-aware tab completion (only shows commands player has access to)

Improvements

Command System

• Reorganized command structure with proper subcommand handling
• Better help messages showing available commands
• Permission-based help display (only shows commands player can use)
• Improved error messages with customizable text
• Console command support where applicable

Chest Management

• Improved chest creation with world settings support
• Better handling of chest contents serialization
• Automatic chest removal when emptied by player
• Improved chest lookup by owner name (supports offline players)
• Added chest ID tracking for better management

Configuration

• Expanded config.yml with all new settings
• Organized configuration sections for clarity
• Default values provided for all settings
• Comments describing each configuration option

Permissions

• New permission: deathchest.admin - Access to admin commands
• New permission: deathchest.admin.open - Open other players' chests
• New permission: deathchest.admin.break - Break other players' chests
• Updated permission hierarchy with deathchest.* wildcard

Data Storage

• New expired_chests.yml file for storing expired chest data
• Improved chests.yml structure with additional data fields
• Added storedXp field to chest data
• Added customLifetime field for per-world lifetime support

---

• Added /deathchest reload command to reload configuration without restarting
• Added prevent-explosions-near configuration option to protect death chests from explosions
• Added teleport-delay configuration option to add delay before teleportation
• Added chest-material configuration option to customize chest appearance
• Added chest-protection-radius configuration option to protect area around death chests
• Added expiration notifications that warn players before death chests expire
• Enhanced chest management with automatic cleanup and limits
• Added teleport cancellation when players move during delayed teleport

Added

• Configuration Option To Put Players DeathChest In A Specific Location
• Configuration Option Of Whether Or Not It Costs Money To Open Your DeathChest

• Implemented custom 54-slot death chest inventory.
• Implemented NBT tag for death chest identification.
• Ensured proper serialization and deserialization of ItemStack objects for persistent storage.
• Added /deathchest back command to teleport to the last death chest.
• Added deathchest.back permission for the /deathchest back command.
• Added coordinate display upon death and for the /deathchest list command.
• Refactored code into ChestManager, PlayerDeathListener, and ChestProtectListener for better organization.
• Removed InventoryManager as its functionality was integrated into ChestManager and ChestProtectListener.

✅ 1. Chest Logging System Added

New file: deathchests.yml

Logs every death chest with:

Player UUID

Chest location(s)

Timestamp

Double chest flag

Status (active, expired, etc.)

Added method: logDeathChest(...)

Added method: updateDeathChestStatus(...)

✅ 2. Compass Support Added

Config option: enable-compass (default true)

New command: /dc999 compass

Gives the player a lodestone compass pointing to their last death chest

Only works if death location is known

✅ 3. Double Chest Handling Improved

Added logic to:

Check if a DoubleChest really formed

If not, fallback to two single chests

Delayed chest merging validation: 3L delay

Each single chest is now saved and removed separately if not merged

Fixed: Duplicate saveChest() call removed

✅ 4. Chest Restoration Improved

All chest chunks are now force-loaded before restoration

Second chest block now validated before placing

Inventory contents now handled safely:

Trims or pads to match correct chest size

Prevents IndexOutOfBoundsException

✅ 5. Better Chest Protection

Owner can open the chest immediately after death ✅

Others are blocked during lock period ✅

Interaction events now notify non-owners of remaining lock time via chat

✅ 6. Safer File I/O

Config saving is now done asynchronously:

saveConfigAsync() for chest.yml

saveDeathChestsConfigAsync() for deathchests.yml

Reduces potential lag or I/O blocking

✅ 7. Config Reload Expanded

/dc999 reload now also reloads:

chest.yml

deathchests.yml

Properly updates all internal variables (lifetime, lock time, compass)

✅ 8. Minor Fixes & Cleanup

Removed redundant import statements

Cleaned up null checks and warnings:

If world doesn’t exist in config, now logs a warning

Death location loading now warns on invalid or missing world

Prevents chest placement in non-air blocks (fails gracefully)

InventoryInteract events now only check "DeathChest" name (not material)

✅ 9. Command Help Improved

/dc999 now shows relevant command list based on compassEnabled

✅ Bug Fixes

Fixed item duplication on death:

Moved event.getDrops().clear() to occur immediately after copying the drops, ensuring items no longer drop both on ground and in chest.

➕ New Features

Automatic double chest creation:

If there are too many items to fit in one chest, the plugin will now attempt to place a second chest adjacent to the first to form a double chest.

If no adjacent space is available, overflow items are dropped naturally.

Chest locking system:

Added lock timer (lock-duration) that prevents other players from opening a death chest for a set time.

Owners can access their chest immediately.

Non-owners are shown a countdown of remaining lock time if they try to open it early.

Owner tracking:

Each chest now saves the UUID of the player who died.

Used to enforce the locking mechanism per player.

Persistent lock + timestamp storage:

Death chests now store the time of creation (timestamp) to calculate remaining lock duration across server restarts.

Double chest restoration:

Both main and secondary chest locations are saved and restored if the plugin or server restarts before chest removal.

New commands:

/dc999 lock_duration — Set how long chests remain locked to their owner (0 disables locking).