📝 Changelog — QuickPearl v1.5

Version v1.5 has been successfully compiled! All reported critical bugs have been resolved, and the plugin has been optimized for professional server environments.

🛠️ Bug Fixes (1.21.4+)

• Fix: False "Unsafe Location" Detections: Implemented Impact Location Normalization (Internal Floor). The plugin now correctly identifies the player's ground level in 1.21.4+, eliminating false positives on flat terrain.
• Fix: Movement & Double Pearls: Optimized the full-body validation (detecting both feet and head) to allow natural landings even if the player is jumping or moving during impact.
• Fix: Ignored Cooldown Bug: Fixed a logic error where the cooldown was applied and cancelled events even when disabled in the config.yml.
• Fix: Distance Refund Bug: Corrected the distance calculation from 3D to 2D. Pearls thrown from heights (like mountains) are no longer unfairly blocked by vertical distance.

✨ New Features & Improvements

• Smart Distance System:
  • max-teleport-distance: Now set to 0 (Unlimited) by default for HCF/PvP environments.
  • show-distance-messages: Added a toggle option to silence distance-related error messages.
  • teleport-too-far: Added a specific custom message for distance errors, making them distinct from physical safety errors (like lava or suffocation).
• Expanded Material Support (1.8 - 1.21.4):
  • Added over 50 modern materials (Crimson, Warped, Blackstone, Tuff, Cherry, Bamboo, etc.) to the logic for Slabs, Stairs, and Fence Gates.
  • Universal validation for vegetation, flowers, and grass (e.g., SHORT_GRASS, FERNS, etc.) across all versions.
• Memory Optimization (OriginManager):
  • Migrated from Entity to UUID keys to prevent memory leaks during chunk unloads.
  • Implemented a Timestamp-based cleanup system (60s) to remove data for pearls that never impact.

📦 Delivery

• File: target/QuickPearl.jar
• Version: 1.5
• Status: Stable / Production-Ready

---

Everything is ready! The plugin has been packaged and the changelog is complete. You can now deploy version 1.5 to your server.