Easy Server Optimizer (ESO)

Easy Server Optimizer (ESO)

High-Performance Deep-Pipeline Optimization Mod for Minecraft 1.20.1 (Forge)

ESO is a lightweight, zero-dependency server-side optimization mod designed specifically for heavy 1.20.1 modpacks and dedicated servers. It goes beyond basic mob limiters by directly overhauling low-level Netty network pipelines, native hardware compression, chunk streaming, and real-time TPS scaling.

🛡️ Server-Side Required, Client-Optional:

Works 100% server-side on dedicated servers or singleplayer worlds. If clients also install ESO, it automatically unlocks bidirectional optimizations (Zstd Level 3 compression negotiation and client-side entity motion interpolation).

🚀 Deep-Level Engine Overhauls

• Hardware-Accelerated Native Compression: Bundled native libdeflate 1.25 (Server-Only fallback) and auto-negotiated Zstd Level 3 (Server + Client). Compresses packets directly via Off-Heap Direct-Buffers, cutting compression CPU overhead by up to 80% without generating JVM heap garbage.

• Directional Flight Corridors (flightchunks): Uses player velocity vectors to predict and pre-load chunks ahead during high-speed travel (Elytra/Creative), eliminating stutter while suppressing tens of thousands of redundant chunk-unload packets.

• Netty Pipeline Flush Batching: Intelligent 2ms / 128-request packet batching that prevents socket congestion and stabilizes packet flow under heavy loads.

• Distance-Aware Motion Snapshots & Interpolation: Cuts distant entity movement packets by over 60% when running Server + Client, relying on smooth client-side trajectory interpolation (up to 12 ticks).

• Smart Mob & AI Logic: Includes collective Zombie Flock pathfinding ($A^*$ shared leader routes), automated projectile limiters, and smart local XP merging.

📈 Adaptive Real-Time TPS Scaling

ESO continuously monitors server tick health and dynamically adapts constraints:

• 🟢 Normal TPS: Unrestricted simulation distances and full mob tick fidelity.

• 🟡 Minor Drops: Gentle, dynamic reduction of non-essential view and simulation distances.

• 🟠 Severe Drops: Stricter entity limits, aggressive item lifespans, and background AI throttling.

• 🔴 Critical Lag: Emergency safeguards (temporary pause on daylight/weather calculations, non-essential entity tick freezing).

Manual commands are available via /eso or /opt, but the mod works completely out of the box with zero configuration required.

🖥️ Platform Support

• Windows (x86_64): Full native hardware acceleration out of the box (libdeflate & Zstd).

• Linux & Other Platforms: Fully compatible with all core optimizations (Flight Corridors, Netty batching, AI & TPS scaling). Packet compression gracefully falls back to optimized direct-buffer Deflater pathways.

⚠️ Compatibility & Incompatibilities

To prevent pipeline collisions, packet drops, or duplicate logic loops:

• ❌ Krypton / Krypton Reforged: Incompatible / Do NOT install together. ESO already implements low-level Netty batching and native compression. Running both causes Netty pipeline hook collisions.

• ⚠️ Connectivity / Packet Fixer: Redundant. Avoid installing third-party packet manipulators alongside ESO.

• ℹ️ Simple Mob Limiters / Despawn Tweaks: Redundant. Built-in projectile caps, flock pathfinding, and adaptive item lifespans already handle entity bloat natively.

• ✅ Fully Compatible With: FerriteCore, ModernFix, Embeddium/Rubidium, Canary/Radon, and all standard tech/magic/dimension modpacks.

❤️ Feedback & Benchmarks

Run /eso bench in-game to measure compression times, packet drops, and network throughput on your machine. Feel free to leave issue reports, benchmark logs, and suggestions!

Easy Server Optimizer (ESO)

High-performance, deep-pipeline optimization mod for Minecraft (Forge)

ESO is a lightweight, zero-dependency, server-side optimization mod for heavy modpacks and dedicated servers. It goes beyond basic mob limiters by overhauling low-level Netty pipelines, packet compression, chunk streaming, and TPS scaling in real time.

🛡️ Server-side required, client optional Works fully server-side on dedicated servers or singleplayer. If clients also install ESO, it unlocks bidirectional optimizations (Zstd Level 3 negotiation and client-side entity motion interpolation).

🚀 Features

Native compression: Bundled libdeflate 1.25 (server-only) and auto-negotiated Zstd Level 3 (server + client). Uses off-heap direct buffers to cut compression CPU overhead by up to 80% without creating heap garbage.

Flight corridors: Predicts player velocity and pre-loads chunks ahead during fast travel (Elytra/Creative), removing stutter and reducing redundant chunk-unload packets.

Netty flush batching: 2ms / 128-request packet batching to prevent socket congestion under load.

Distance-aware motion snapshots: Cuts distant entity movement packets by over 60% (server + client) using client-side interpolation of up to 12 ticks.

Smart mob and AI logic: Zombie flock pathfinding (shared A* leader routes), projectile limiters, and local XP merging.

📈 Adaptive TPS scaling

🟢 Normal: Full simulation distance and mob tick fidelity.

🟡 Minor drops: Gently reduces non-essential view and simulation distance.

🟠 Severe drops: Stricter entity limits, shorter item lifespans, background AI throttling.

🔴 Critical lag: Emergency safeguards (pauses daylight/weather calculations, freezes non-essential entity ticks). Works out of the box with zero configuration. Manual control via /eso or /opt.

🖥️ Platform support

Windows (x86_64): Full native acceleration (libdeflate and Zstd).

Linux and others: All core optimizations work; compression falls back to optimized direct-buffer Deflater.

⚠️ Compatibility

❌ Krypton / Krypton Reforged: Incompatible. Both hook the Netty pipeline and will collide.

⚠️ Connectivity / Packet Fixer: Redundant, avoid installing alongside ESO.

ℹ️ Simple Mob Limiters / Despawn Tweaks: Redundant, since ESO has built-in projectile caps, flock pathfinding, and adaptive item lifespans.

✅ Compatible with: FerriteCore, ModernFix, Embeddium/Rubidium, Canary/Radon, and standard tech/magic/dimension modpacks.

❤️ Feedback

Run /eso bench in-game to measure compression time, packet drops, and throughput. Issue reports, benchmark logs, and suggestions are welcome!