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

Плагины/QuickPearl