# 🚀 QuickPearls v1.2 — Trajectory, Performance & 26.X Update Welcome to **QuickPearls v1.2**! This release brings a massive overhaul to projectile trajectory mechanics, full compatibility with modern **Minecraft 26.X+**, deep internal optimizations with dead code removal, and new configuration options. --- ### ⚠️ IMPORTANT: Configuration & Language Notice Due to newly added trajectory options, performance toggles, and new administrative command messages, **it is strongly recommended to delete or regenerate your existing `config.yml` and the `/lang/` folder** so QuickPearls can generate the updated files with all new settings. --- ### ✨ What's New & Improved? * **🎯 Continuous Trajectory Engine (`ContinueTrajectory: true`):** * Pearls now fly smoothly straight through **open fence gates, cobwebs, string/tripwire, and plants** without dying, cutting short, or triggering premature teleports. * The pearl maintains its flight into the distance and only teleports the player where it actually lands on solid ground. * **📐 True Ballistic Parabola:** * Strict preservation of vertical downward gravity (-0.03 blocks/tick). Pearls never flatten horizontally, hover, or "fly straight" when crossing doors or obstacles. * Natural parabolic descent remains 100% continuous from the throw to the landing spot. * **🧭 Pure Vector Direction (Zero Angle Drift):** * Pearls thrown diagonally or from the side through corridors and doors preserve their exact horizontal trajectory angle without being pulled or magnetically snapped to the center of the block. * **⚡ Modern Minecraft 26.X+ Compatibility:** * Native compatibility verified and fine-tuned for modern **Minecraft 26.X+** releases alongside complete legacy support all the way back to **1.8**. * **⚡ Codebase Optimization & Dead Code Removal:** * Deep refactor eliminating redundant loops, dead classes, and legacy overhead for lower JVM memory footprint and maximum server tick throughput. * **🛠️ Modular Command System:** * Clean, high-performance subcommand architecture: * `/qp status` — Real-time active pearl metrics. * `/qp check <player>` — View active cooldown duration. * `/qp clear <player>` — Reset a player's cooldown. * `/qp setcooldown <player> <sec>` — Assign a custom cooldown. * `/qp refund <player>` — Manually refund an Ender Pearl. * `/qp get <setting>` & `/qp set <setting> <value>` — Live in-game config editor. * `/qp lang <lang|auto>` — Language controller. * `/qp reload` — Reload configs and translations. --- ### 🐛 Bug Fixes & Stability * **Fixed Cobweb Momentum Loss:** Neutralized vanilla friction that previously slowed pearl velocity by up to 95% and dragged it into the grass below. * **Fixed Open Fence Gate Collisions:** Overcame legacy server raytrace bugs that treated open fence gates as solid obstacles. * **Fixed Downward Velocity Flattening:** Eliminated internal vertical clamping that caused pearls to float horizontally after crossing gates. * **Fixed Legacy 1.8 Engine Errors:** Resolved `NoSuchMethodError` and PaperSpigot `EntityProjectile` initialization edge-cases. * **Enhanced Suffocation Safeguards:** Added strict clearance checks for half-slabs and 1-block wall alcoves to protect players from suffocation damage. --- ### 💬 Community & Support Need assistance, found a bug, or have a suggestion? 👉 **[Join the Official QuickPearls Discord](https://discord.com/invite/ZRe3RnubdW)**

### 🐛 Bug Fixes * **Fixed console error (`NullPointerException`):** Resolved a critical issue in the Anti-Glitch engine that occurred when processing an ender pearl teleport if the player wasn't looking at a valid block (e.g., throwing a pearl into the air). * **Stability Improvements:** Added internal safety checks when interacting with packets (NMS) to get the target block, preventing the `PlayerTeleportEvent` from failing unexpectedly under certain conditions.

# 🎉 Initial Release (v1.0) Welcome to the very first official release of **QuickPearls**! After extensive development and optimization, we are thrilled to release the most advanced and high-performance Ender Pearl system available for modern networks. ### 🚀 What's in this release? * **Core Anti-Glitch Engine:** Fully functional and tested engine to prevent players from glitching through walls, fence gates, and complex container setups. * **Smart Refund System:** Automatically detects suffocating pearls and seamlessly refunds them to the player. * **PacketEvents Integration:** Blazing fast physics processing at the network level with zero TPS drop. * **Dynamic Physics Control:** Customizable collision boxes for stairs, slabs, beds, and anvils (Pearl Thru). * **Auto-Language System:** Multi-language support (English, Spanish, Portuguese, French, Russian, Chinese) dynamically served based on the player's client settings. * **Complete Cross-Version Support:** Fully compatible from `1.8` all the way up to `1.21.x+` on Spigot, Paper, and Purpur. Thank you for choosing QuickPearls! If you encounter any issues or have feature requests, please report them in our support channels.