💎 FastCrystals — Next-Gen Crystal PvP Optimization

FastCrystals is a high-performance network optimization plugin specifically designed to refine Crystal PvP on modern Minecraft server software (Paper, Purpur, Folia). By utilizing asynchronous packet interception at the network layer, FastCrystals completely eliminates latency delay and smoothens crystal explosion sequences, delivering an ultra-responsive combat experience regardless of player ping.

⚠️ CRITICAL REQUIREMENT FastCrystals strictly requires the ProtocolLib plugin to function. Without it, the network packet interception system cannot initialize, and the plugin will safely disable itself during startup to preserve your server's stability.

---

⚙️ How It Works (Under the Hood)

FastCrystals operates on a modern architecture divided into three major components:

1. Async Packet Interception Layer

In vanilla Minecraft, when a player punches an End Crystal, the action is processed on the server's main tick loop. If the server experiences a drop in TPS or if the player's connection is unstable, this processing is delayed. FastCrystals leverages ProtocolLib to intercept the PacketType.Play.Client.USE_ENTITY packet the millisecond it arrives from the network card, handling impact validation asynchronously without blocking or lagging the server's core thread.

2. Live Dynamic Profiling

The plugin does not treat every connection the same. It continuously monitors each player's real-time latency to automatically assign a tailored optimization strategy:

• SAFE & BALANCED Profiles (Low to Medium Ping): Utilizes a Soft Sync or Burst Sync technique (grouping 1 to 2 packets) to ensure explosions are validated instantly.
• HIGH & MAX Profiles (High Ping): Activates advanced hitbox tracking and target prediction algorithms. Even if a player suffers from high network latency, the plugin anticipates their movement and hits to register actions fairly on the server side, breaking the natural disadvantage of high-ping users.
• BEDROCK Profile (Geyser/Floodgate): Mobile and console players handle packet scheduling and death statuses differently than Java Edition players. FastCrystals applies a dedicated override layer to prevent Bedrock users from experiencing visual desynchronization (desync) during intense crystal pacing.

3. Native Folia Support (Multi-Threading)

Unlike older optimization tools, FastCrystals is built ground-up with native Folia compatibility. Entity tracking tasks and distance calculations utilize Paper/Folia's regional scheduling APIs, ensuring absolute stability even on high-count multi-threaded server environments.

---

💻 Commands

The plugin centralizes all features into a single, clean command equipped with smart tab-completion:

Command	Description	Permission
/fastcrystals (or /fc, /fastcrystal)	Opens the interactive user Graphical Interface (GUI).	fastcrystals.use
/fastcrystals stats	Displays live performance statistics and crystal tracker states (Admins).	fastcrystals.admin

---

🔑 Permissions

Permissions are streamlined to fit seamlessly into any modern permission management setup (like LuckPerms):

• fastcrystals.use
  • Description: Allows players to access the main interface and toggle their own optimization module on or off.
  • Default Status: Granted to everyone (true).
• fastcrystals.admin
  • Description: Grants access to network monitoring tools, global system statistics, and server-side performance diagnostics.
  • Default Status: Restricted to operators (op).

---

🖥️ Graphical User Interface (GUI)

Executing the main player command opens an elegant 27-slot menu interface:

• Green Button (Lime Stained Glass Pane): Enables the optimization module.
• Red Button (Red Stained Glass Pane): Disables the module, returning the player to native Minecraft crystal processing.
• Central Compass: Displays a live dashboard (Live Profile) showing the player's current ping, active packet sync strategy, and detected platform (Java or Bedrock via Floodgate).