✨ Overview

QuickPearls is the definitive enterprise-grade Ender Pearl management system designed for modern Minecraft networks. Built on a high-throughput, packet-level architecture via Netty and PacketEvents, it completely eliminates vanilla teleport exploits, base-phasing glitches, and suffocation bugs while delivering 100% authentic, uninterrupted projectile physics with zero TPS impact across all versions from 1.8 up to 26.3+.

Whether you operate a competitive HCF, Practice, Duels, Lifesteal, BoxPvP, or Survival SMP server, QuickPearls delivers the precision, performance, and customization your players expect.

🚀 Key Features

• 🎯 Continuous Trajectory Engine:

  • Pearls fly cleanly through open fence gates, cobwebs, tripwire/string, and tall plants without losing momentum, dropping to the floor, or stopping prematurely.
  • Preserves authentic downward gravity ($-0.03$ blocks/tick) and exact 3D vector trajectories, allowing seamless diagonal and side-angle throws without magnetic centering or horizontal flattening.

• 🛡️ Packet-Level Anti-Glitch & Anti-Phase:

  • Intercepts pearl collisions directly at the network pipeline to stop players from glitching into claimed bases, grief-protected regions, or unrendered chunks.
  • Blocks wall-phasing through solid blocks, glass panes, closed fence gates, trapdoors, and containers placed below blocks (chests, hoppers).

• 💸 Smart Refund & Anti-Suffocation System:

  • Automatically detects unsafe landings, 1x1 traps, or suffocating blocks (such as blind half-slab alcoves).
  • Safely cancels the teleport, returns the Ender Pearl to the player's inventory, clears active cooldowns, and can trigger custom console commands.

• ⚡ Auto-Launch on Interactables:

  • Allows players to throw pearls even when right-clicking interactive blocks like Chests, Furnaces, Anvils, Hoppers, or Crafting Tables without accidentally opening the container GUI during combat.

• ⏱️ Competitive Cooldown System:

  • Fully customizable duration with sub-second decimal precision.
  • Includes classic Kohi/Lazarus item name countdowns, action bar alerts, and native PlaceholderAPI integration (%quickpearls_cooldown%).

• 🌍 Dynamic Multi-Language Detection:

  • Automatically detects each player's client language (English, Spanish, Portuguese, French, Russian, Chinese) to deliver native localized messages without requiring global server overrides.

• ⚙️ Fine-Tuned Block Physics (Pearl-Thru):

  • Custom collision detection for stairs, slabs, beds, and anvils, allowing legitimate tactical penetrations (e.g., throwing through open slab slits) while blocking illegal phase exploits.

🧩 Commands & Permissions

All administrative commands require the QuickPearls.admin permission (granted to operators by default).

📊 PlaceholderAPI Support

QuickPearls seamlessly exposes placeholders for scoreboards, action bars, tablists, and menus:

• %quickpearls_cooldown% — Remaining cooldown in seconds (e.g. 12.4).
• %quickpearls_cooldown_formatted% — Pre-formatted time string (e.g. 12s).

💬 Community & Support

Have questions, encountered a bug, or want to suggest new features? Join our official community Discord!

👉 Click here to join the QuickPearls Discord
Get fast developer assistance, report issues, and vote on upcoming features!