SafeChest

📜 Changelog - SafeChest v0.0.2

This is a MAJOR update. Version 0.0.2 introduces powerful new features, fixes a critical duplication bug, and adds essential admin tools. If you’re running v0.0.1, upgrading is mandatory.

---

✅ New Features

1. Group-Based Configuration System
   Introduces groups.yml, allowing admins to define custom settings per permission group (angelchest.group.<name>).

   • Configure different chest durations (e.g., 5 min for default, 10 min for VIP, infinite for Admin).
   • Set maximum active chests per player (e.g., 5 for default, 20 for Admin).
   • Define individual prices for /actp and /acfetch per group.

2. New Command: /acpreview
   Opens a virtual inventory showing the full contents of your last SafeChest (main inventory, armor, off-hand).

   • Completely read-only — players cannot take or modify items.

3. New Command: /aclist
   Displays a formatted, clickable list of all your active SafeChests in the current world.

   • Shows location (X, Y, Z), item count, and time remaining.
   • Click any entry to teleport directly to that chest (if you have angelchest.tp permission).

4. Vault Economy Integration
   Adds full support for Vault-compatible economies (EssentialsX, CMI, etc.).

   • /actp and /acfetch can now have configurable costs.
   • Players receive clear messages for insufficient funds or successful payments.
   • Gracefully disables if Vault is not installed.

5. Interactive Death Messages
   Upon death, players receive a rich chat message with clickable buttons:

   • [TP]: Run /actp instantly.
   • [FETCH]: Run /acfetch instantly.
   • [PREVIEW]: Run /acpreview instantly.
   • Hover tooltips explain each action.

6. Configurable Hologram Text
   The hologram text above chests is now fully customizable in config.yml.

   • Supports placeholders: {player}, {items}, {time}.
   • Supports Minecraft color codes (&) and multi-line text (though only the first line is displayed due to Minecraft limitations).

7. New Command: /safechest reload
   Allows server admins to reload all plugin configurations (config.yml, groups.yml, lang.yml) without restarting the server.

   • Permission: angelchest.reload.
   • Automatically clears expired chests from cache after reload.

8. Enhanced Configuration Options

   • Added max-allowed-angelchests: Limits the number of active chests a player can have.
   • Added material: Lets you change the chest block type (e.g., BARREL, TRAPPED_CHEST).

---

🐛 Bug Fixes

1. CRITICAL DUPLICATION BUG FIXED
   In v0.0.1, items were both saved in the chest AND dropped on the ground upon death, allowing players to duplicate their entire inventory.
   FIX: The plugin now:

   • Clears all drops from the death event.
   • Sets dropped experience to 0.
   • Uses setKeepInventory(true) to take full control of item handling.
     This fix is essential for server integrity.

2. Unsafe Teleportation Fix
   The /actp command could teleport players inside solid blocks.
   FIX: The plugin now searches for a safe spot (up to 2 blocks above or adjacent) before teleporting.

3. Configuration Type Error
   The price-fetch value in config was being read as a string, causing errors with decimal values.
   FIX: Now correctly reads as a double.

4. Chest Protection Reinforcement
   Improved protection logic to prevent protected chests from being broken by explosions (Creeper, TNT) or other players, even in edge cases.

---

🎨 Quality of Life Improvements

1. Visual Particle Effects

   • ❤️ Heart particles spawn when a SafeChest is created.
   • ✨ End Rod particles spawn when inventory is restored from a chest.

2. Fully Localizable Messages
   All plugin messages are now loaded from lang.yml, making it easy to translate or customize every text string.

3. Improved Data Persistence
   Optimized the hybrid (memory + database) storage system to ensure chests load reliably, even during database initialization.

4. Vault Compatibility Graceful Degradation
   If Vault is not present, economy features are silently disabled without spamming errors.

5. Hologram Timer Update
   The countdown timer on the hologram now updates every second for a more dynamic and accurate display.

---

🚀 Summary

SafeChest v0.0.2 is not just an update — it’s a complete evolution of the plugin. From fixing the game-breaking duplication bug to adding enterprise-grade features like group configurations, economy support, and a reload command, this version is stable, fair, and ready for production servers of any size.

Upgrade today and give your players the safety net they deserve — without compromising your server’s balance.