---

✨ What is QuickPearls?

QuickPearls is the most advanced, high-performance Ender Pearl management plugin designed for modern networks. It replaces buggy vanilla pearl mechanics with a dynamic, packet-level architecture supporting intense anti-glitch protection, custom physics, and smart cooldowns.

Whether you run a Survival, Lifesteal, Duels, or Practice server, QuickPearls is the universal solution to eliminate pearl exploits and improve the gameplay experience.

---

🛡️ Core Anti-Glitch Engine

Protect your players and their bases. Prevent players from glitching into grief-protected regions, claims, or exploiting Minecraft's physics.

• Zero TPS Drop: Intercepts pearls directly at the packet level (via Netty/PacketEvents) for blazing-fast physics calculation without lagging your server.
• Wall & Gate Fixes: Instantly denies and refunds pearls attempting to pass through solid walls, glass panes, or fence gates.
• Complex Container Fixes: Prevents glitching through chests or hoppers placed under blocks.
• Suffocation Prevention: Automatically cancels pearls that land in risky, 1x1, or suffocating locations.

---

🌍 Universal Gamemode Features

Perfectly adaptable for any server type, from peaceful SMPs to hardcore PvP.

• Auto-Language System: Automatically detects the player's client language (es, en, pt, ru...) to serve translated messages dynamically without global overrides.
• Auto-Launch on Interactables: Throw pearls instantly even when right-clicking Chests, Furnaces, Anvils, or Crafting Tables (No more opening UIs by accident!).
• Custom Pearl-Thru: Grant pearls the ability to pass cleanly through specific transparent blocks like string, cobwebs, or slabs.
• Smart Refund System: Seamlessly returns the Ender Pearl, clears the active cooldown, and executes custom console commands when a pearl fails to land safely.
• Endermite & Damage Control: Disable annoying Endermite spawns or customize the exact fall damage taken when pearling.

---

⏱️ Advanced Cooldown System

A highly optimized, integrated cooldown system tailored for your needs.

• Fully customizable duration.
• Optional Action Bar or visual displays for the cooldown.
• Kohi-Style & Lazarus Compatible: Perfect for competitive servers, featuring classic visual displays and seamless, silent hook integration with Lazarus core.
• PlaceholderAPI Support: Use %quickpearls_cooldown% in your scoreboards or menus.

---

🧩 Commands & Permissions

Command	Aliases	Function	Permission
/quickpearls lang <lang>	/qp lang	Forces a global language or sets it to auto-detect	QuickPearls.admin
/quickpearls clear <player>	/qp clear	Clears the active pearl cooldown for a specific player	QuickPearls.admin
/quickpearls reload	/qp reload	Reloads configurations and languages	QuickPearls.admin
/quickpearls <setting> <value>	/qp <setting>	In-game dynamic configuration editor	QuickPearls.admin

---

📦 Advanced Block Interaction

Fully configurable physics and block interactions:

1. Crit Blocks & Diagonals: Fine-tuned collision detection for stairs, slabs, beds, and anvils so pearls land exactly where they should.
2. Entity Teleportation Checks: Strict checks for entity collisions, stopping players from using entities to glitch into tight spaces.
3. Visual Aesthetics: Full HEX Color Support (&#RRGGBB) in all plugin messages.

---