Easy Server Optimizer(ESO)

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!