🪦 GraveWarden v1.3.1 - The "Safe & Sound" Update

This update focuses on grave security and player experience. Your graves are now virtually indestructible, and finding them has never been easier!

🛡️ Grave Protection (Indestructible!)

• Explosion Proof: TNT, Creepers, and Fireballs can no longer destroy graves.
• Environmental Safety: Added protection against Fire, Lava Flow, and Water washing away your grave.
• Safe Respawn: Graves now intelligently find a safe spot if you die in the Void or inside Lava. No more unreachable items!

📍 New Distance Tracker

• Action Bar HUD: A new real-time tracker shows you exactly how many meters are left until you reach your items.
• Visual Feedback: Receive a title notification and a sound effect once you arrive at your grave.
• Configurable: Toggle it on/off and customize the messages in the config.yml.

⚙️ Configuration & Localization

• Full English Support: All messages are now in English by default.
• Custom Placeholders: Use {blocks} in the action bar to show real-time distance.
• Clean Config: Structure updated to v1.3.1 with organized sections for protections and tracker.

🛠️ Bug Fixes

• Fixed a logic error where graves would sometimes remain in memory after being collected.
• Improved chunk loading performance when spawning holograms.

If you enjoy the plugin, please consider leaving a star on GitHub! 🌟

💀 The Management Update - Version 1.3.0

This version introduces a complete command system and a visual interface to manage active graves, making it easier than ever to keep track of your "restless souls".

🖥️ New Command System

• Unified Command: Added /gravewarden (with /grave alias) as the main entry point.
• Interactive Help: New /grave help command to display all available sub-commands.
• Update Integration: Admins will now see a real-time update status (Latest vs Outdated) directly in the main command output.

📦 Grave Management & GUI

• Grave List GUI: Added /grave list to open a visual inventory showing all your active graves.
• Admin Inspection: Admins can use /grave list <player> to view and manage graves of other players.
• Grave Removal: * /grave remove <player>: Clear all graves for a specific player.
  • /grave remove-all: Global wipe of all graves and holograms on the server.

🛠️ Technical Improvements

• Centralized Configuration: All command messages are now fully translatable and managed via ConfigManager.
• Async Update Checks: The update checker now runs on a separate thread to prevent server lag during startup or command execution.
• Permission Overhaul: Fine-tuned permission nodes for every sub-command (list, list.others, remove, remove.all).
• Config Placeholder Fix: Resolved an issue where some placeholders in config.yml were failing to render correctly in-game.

Gravewarden is now more powerful and admin-friendly. Don't forget to update your config.yml to see the new message keys!

🛡️ Inventory & Drop Security - Version 1.2.4

This update reinforces the "Soul Bound" nature of the Soul Compass by blocking all possible ways to drop, store, or lose the item via GUI manipulation and container interactions.

🔒 Anti-Exploit & Container Fixes

• Container Storage Protection: The Soul Compass can no longer be placed inside Chests, Furnaces, Hoppers, or any other external storage. It is strictly bound to the player's inventory.
• Anti-Shift-Click: Implemented logic to block "Shift-Click" movements that would allow the compass to bypass normal inventory checks and enter containers.
• Mouse Drag Protection: Fixed a bypass where players could drop the Soul Compass by dragging it outside the inventory window.
• Cursor Cleanup: The compass is now safely removed from the player's cursor if a drop attempt is cancelled, preventing "ghost item" glitches.

💬 Unified Feedback & Config

• Smart Notifications: Added specific messages to distinguish between a "Restricted" action (trying to store it) and a "Removal" action (trying to drop it).
• New Config Keys:
  • messages.soul-compass-removed: Sent when the compass is destroyed due to a drop attempt.
  • messages.soul-compass-restricted: Sent when an attempt to store the compass in a container is blocked.

These changes ensure the Soul Compass remains a personal tracking tool and cannot be exploited, shared with other players, or accidentally lost in storage.

🧹 Final Refactor - Version 1.2.3

This update completes the transition to the new configuration architecture, ensuring 100% coverage of the centralized management system.

🛠️ Full Enum Integration

• Legacy Code Cleanup: Converted all remaining methods and utility classes to use the Config Enum system.
• Zero Direct Access: Eliminated the last remaining direct calls to getConfig(), ensuring that every configuration check now benefits from built-in null-safety and default value fallbacks.
• Consistency Pass: Standardized how strings, booleans, and numbers are retrieved across the entire codebase (Holograms, Graves, and Soul Compasses).

🚀 Performance & Safety

• Optimized Lookups: By routing all config requests through the Enum system, we've unified the logic for color processing and placeholder replacement.
• Rock-Solid Stability: This final step removes any possibility of NullPointerExceptions caused by missing config keys in older config.yml files.

The refactor is now complete. The plugin is more stable, faster, and significantly easier to maintain.

🏗️ Technical Refactor - Version 1.2.2

This version focuses on internal code quality and long-term maintainability by restructuring how the plugin handles configuration data.

🛠️ Internal Refactor: Centralized Configuration

• Config Enum Implementation: Replaced all direct Gravewarden.getInstance().getConfig().get() calls with a centralized Config Enum system.
• Improved Maintainability: All configuration keys and their default values are now managed in a single location, reducing the risk of NullPointerExceptions and typos.
• Better Performance: Streamlined the way the plugin accesses settings, leading to slightly faster event handling during player deaths and grave interactions.
• Stronger Type Safety: The new system ensures that the plugin always receives the expected data type (String, Boolean, or Double) from the configuration files.

🔧 Stability Improvements

• Default Value Fallbacks: Every configuration entry now has a hardcoded fallback within the Config Enum, ensuring the plugin remains functional even if the config.yml is missing keys or becomes corrupted.

This is a technical update. No changes to your existing config.yml are required, but the plugin is now more robust against configuration errors.

🐛 Bug Fix Update - Version 1.2.1

This update addresses critical stability issues found in the previous release, specifically targeting crashes related to configuration loading and color formatting.

🛡️ Bug Fixes

• Resolved Critical NPE: Fixed a NullPointerException that occurred when sending death or interaction messages if the configuration keys were missing or improperly loaded.
• Safe Configuration Loading: Added robust null-checks for all configurable messages. The plugin will now use internal default messages if a config value is missing, preventing the entire event from failing.
• HEX Parsing Fix: Corrected the ColorUtils logic to safely handle HEX color codes and prevent crashes during string processing.
• Improved Null Safety: Implemented Objects.requireNonNull protections and fallback strings across all Event Listeners.

⚙️ Technical Changes

• Optimized the order of operations in DeathListener to ensure the grave is fully registered before attempting to notify the player.
• Refined the GraveInteractListener to handle unexpected null states gracefully when players interact with legacy or corrupted head blocks.

Note for Admins: If you previously experienced crashes when a player died, this update is mandatory. It is recommended to let the plugin regenerate your config.yml or ensure all message keys are correctly placed under the messages: section.

Found a bug? Report it on GitHub!

🛠️ Version 1.2.0 - The Navigation Update

This update introduces a major quality-of-life feature: the Soul Compass, along with improved stability and automatic configuration management.

✨ New Feature: Soul Compass 🧭

Never lose your death location again! Upon respawning, you will receive a magical compass that points directly to your grave across all dimensions (Overworld, Nether, and End).

• Cross-Dimensional Tracking: Works even if your grave is in a different dimension.
• Auto-Cleanup: The compass is automatically removed from your inventory once the grave is reclaimed.
• Smart Identification: Uses persistent data (PDC) to ensure it only interacts with GraveWarden compasses.
• Vanishing Curse: Automatically disappears if you die again while searching, preventing inventory clutter.

🔄 Automatic Config Updates

No more deleting your config.yml every time there's an update! The plugin now automatically injects new sections while preserving your existing settings.

The following section has been added to your config:

messages:
    soul-compass-pointing: "&#7df9ff&l» &7Your &fSoul Compass &7is pointing to your grave."

items:
  soul-compass: # Navigate to your grave when you respawn
    enabled: true
    settings:
      name: "&#7df9ff&lSoul Compass"
      model: 0
      lore:
        - "&7It points toward your soul at:"
        - "&b{x} {y} {z}"
        - ""
        - "&8&oWill be consumed upon retrieval."

🛠️ Version 1.1.0

✨ New Features

• 🌐 Modrinth Update Checker: Added an async system to notify you when a new version is available.
• 🔄 Config Updater: Missing keys are now automatically added to your config.yml without resetting your existing settings.
• 📜 New Config Options: - Added update-checker (boolean) to toggle update notifications.

Check the project description for the updated configuration examples!