Easy Server Optimizer (ClearLagg for Forge)

"🛡️ Server-side Only: This mod is only required on the server. Clients do not need to install it!"

Easy Server Optimizer (ESO) is an ultra-lightweight, zero-dependency (no library/architectury required) server-side optimization mod for Minecraft. It dynamically monitors server TPS and applies smart optimizations in real-time. Just install and forget!

✨ Key Features

Zero-Lag Item Cleanup: Unlike traditional lag-clearing mods that cause lag spikes when deleting items, ESO dynamically modifies item lifespans at spawn time so the game engine removes them naturally with zero tick spikes.
Auto "Anti-Tick-Slip" (World Freeze): When the server is empty, it saves the game time. If the server remains empty for >= 5 minutes, it rolls back time to the exact moment the last player logged out upon their return. Perfect for apocalypse modpacks!
Smart Villager Optimizer: Freezes stationary Villagers (NoAi = true) to eliminate trading hall lag, and automatically unfreezes them for 60 seconds when players interact (right-click) with them for trades and restocking.
Dynamic Mob Capper: Dynamically limits the number of mobs allowed per chunk (default 40, adjustable in-game) to prevent massive entity build-up. Ignores custom-named pets/bosses.
Built-in Lag Finder (/opt find): Instantly scan and find the top 3 laggiest chunks and top 5 most crowded entity types on your server.

📈 Adaptive TPS Optimization

The mod automatically adapts to server performance in real-time:

🟢 Good TPS → Normal gameplay, gentle scaling.
🟡 Minor TPS Drop → Scaled rendering & simulation distances.
🟠 Severe TPS Drop → Stronger optimization rules applied.
🔴 Extreme TPS Drop → Emergency safeguards activated (temporary weather/daylight cycle pause, safe entity freezing).

Note: Use /opt auto off, then other commands will work more accurately, and will not be overwritten.

Manual commands are available (via /opt) but never required.

⚙️ Compatibility & Config

Config Path: config/optserver-server.toml (Configure whitelisted items with custom lifespans).
Compatibility: 100% compatible with all common performance mods (Lithium, FerriteCore, Spark, etc.). Safe for large modpacks and 24/7 dedicated servers.

❤️ Feedback & Support

Thank you for choosing Easy Server Optimizer! Feel free to leave a comment with server feedback, suggestions, or issues. Your feedback helps us improve the mod!