G1ax Crystal Optimizer

🚀 Overview

G1ax Crystal Optimizer is a client-side Fabric performance mod designed to optimize crystal PvP gameplay. By bypassing client-side placement cooldowns, predicting crystal breaks, and managing packet traffic dynamically, it provides a highly responsive PvP experience. Running entirely client-side, it offers customizable modes to align with different server rules and anticheat configurations.

---

📊 Performance Comparison (90ms AsiaPrac)

With Mod	Without Mod
!With Mod	!Without Mod

---

🤔 Why Choose G1ax Crystal Optimizer?

• ⚡ Zero Visual Delay: Instantly removes broken crystals visually on the client side, eliminating delay while waiting for server verification.
• 📶 Dynamic Latency Adaptation: Evaluates real-time connection latency using a moving average and automatically adjusts packet rates (2–4 packets per tick).
• 🛡️ Anticheat Compliance: Provides a lightweight tweak mode that bypasses hardcoded cooldowns while retaining vanilla validation paths.
• 🔧 Startup Safeguards: Built-in environment scanner checks Minecraft versions, Fabric API, and mixin targets to prevent client crashes.
• 🤝 Seamless Coexistence: Fully compatible with other PvP helper mods without thread contention or rendering crashes.

---

⚡ Mode Configuration

Configure the mod's behavior dynamically in-game with /g1axoptimizer <default|tweak|off>:

🛡️ /g1axoptimizer tweak — AC-Safe Mode

Specifically designed for competitive environments with strict server anticheat solutions.

• Bypasses Placement Cooldown: Resets Minecraft's hardcoded itemUseCooldown (4 ticks/200ms) to trigger placement checks every tick (~50ms).
• 100% Vanilla Code Paths: Uses the default client logic and placing mechanics. No custom packet injection, no predictive client-side entity removals, and no structural modifications.

---

🚀 /g1axoptimizer default — Full Performance Mode

Optimized for anarchy and PvP servers where custom optimization mods are permitted.

• Client-Side Visual Removal: Instantly removes broken crystals visually, providing zero-delay feedback without waiting for server response packets.
• Direct Block Interaction: Bypasses default validation paths to send direct block interaction requests.
• Performance Guard: Dynamically schedules packet rates and predictions using a nanosecond-precision adaptive EMA guard.

---

❌ /g1axoptimizer off — Vanilla Behavior

Disables all optimizations. Restores the default Minecraft PvP engine.

Feature	tweak Mode	default Mode	off (Vanilla)
Bypass itemUseCooldown	Every Tick (~50ms)	Every Tick (~50ms)	Vanilla (4 Ticks / 200ms)
Visual Client-Side Break Prediction	❌	✅	❌
Direct Packet Routing	❌	✅	❌
Ping-Adaptive Packet Rates	❌	✅	❌
Strict Vanilla Validation Path	✅	❌	✅

---

🔧 Installation

1. Install Fabric Loader for Minecraft 1.21.1+
2. Download Fabric API
3. Download G1ax Crystal Optimizer
4. Place the .jar files in your .minecraft/mods folder
5. Run the game and configure with /g1axoptimizer!

---