Gravewarden

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](https://github.com/zNxki/Gravewarden/issues)!

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: ```yaml 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!

Version 1.0.1 - The Soul & Stability Update

This update introduces major requested features and addresses critical stability issues for a smoother experience.

New Features

🔮 Experience Storage: Your graves now store Total Experience*! Reclaiming your grave will restore your XP levels along with your items. 📦 Improved Item Restoration:* Refined the logic to ensure items return to their original slots even more reliably.

Bug Fixes

🛡️ NPE Fix (ColorUtils):* Resolved a critical NullPointerException in the color processing system that occurred when certain messages were missing or null. 🧹 Data Safety:* Improved the internal handling of grave IDs to prevent "ghost" holograms after a server restart. --- If you enjoy GraveWarden, consider leaving a star on GitHub!