QuickPearl v1.5.1: The Realism Update

This update focuses on making ender pearl physics feel natural and eliminating false "Unsafe Location" detections.

🚀 Key Improvements

• Vanilla Impact Physics: Removed the artificial +1.0 Y normalization. Players now teleport to the exact impact point with a tiny directional offset to prevent clipping, mimicking vanilla behavior.
• Smart Void Detection: Fixed a bug where hitting high vertical walls (towers, mountains) triggered a false "Unsafe Location" due to the void protection system. The system now recognizes adjacent solid structures.
• Low Ceiling Support: You can now pearl into 2-block high spaces and tunnels without being blocked by safety checks.

🛠️ Technical Fixes

• Refactored SecurityUtil.java to include a proximity block check for vertical surfaces.
• Updated PearlRefundUtil.java to allow feet-level block overlap as long as the head-level area is breathable.
• Compatibility confirmed for Minecraft 1.8.x up to 1.21.x.

📝 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.

🚀 Initial Release - v1.0

First public release of QuickPearl (Modern & Legacy).

✨ Core Features

• Advanced EnderPearl system with real momentum-based physics
• Organic pass-through system (cobwebs, slabs, strings)
• Ultimate anti-glitch protection (fencegate, ceiling, hopper exploits)
• Smart landing system with anti-suffocation protection
• Intelligent pearl refund system for invalid or blocked locations
• Configurable cooldown system with visual feedback (Kohi-style)
• Customizable damage system (self & other entities)
• Endermite spawn control system

🧩 Integrations

• Full support for WorldGuard (WG6 & WG7+)
• Native support for PlaceholderAPI

⚙️ Configuration

• Fully customizable config.yml
• Support for colors, values and gameplay tuning

⚡ Performance

• Designed with 0 TPS impact
• Async calculations and optimized execution
• Tested for competitive environments

📌 Notes

• This is the first official public release
• Previous versions were used for internal testing and development

---

💬 Support

Need help or found a bug?
Join our Discord: Click here