Описание
# Easy Server Optimizer (ESO)
**_🛡️ Server-side Only: Required only on the server (dedicated server or the host of a multiplayer world). Clients joining someone else's server do not need to install it — but if you're the host (singleplayer, or "Open to LAN"), you're actually running the server yourself, so installing it there gives you the full optimization benefit._**
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!
**_Note on singleplayer/LAN:_** Since your singleplayer world already runs its own internal server, all core logic (item cleanup, world freeze, villager optimizer, adaptive TPS scaling) works the same as on a dedicated server. The only exceptions are /opt dis and /opt sim (view/sim distance), which don't apply in singleplayer — render distance is controlled by your client's Video Settings instead. **_When you use "Open to LAN," anyone who joins can also use /opt commands._**
## ✨ Key Features
- Smart Entity & Mob Limiter: Auto-clears projectile spam (arrows, tridents, etc.) and caps mobs per chunk before they pile up and cause lag.
- Zero-Lag Item Cleanup: Custom cleanup timing per item type — dynamically modifies lifespans at spawn so items despawn naturally, no tick-spike deletion.
- Auto "Anti-Tick-Slip" (World Freeze): Saves game time when the server's empty; if empty for ≥5 minutes, rolls time back to the moment the last player logged out. Great for mods where mobs/difficulty scale over time — no free progression while nobody's online.
Full command list and details in the table above. 📋
📈 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 won't 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: Safe for heavy modpacks (200+ mods) and 24/7 dedicated servers. Since it operates on standard events without altering vanilla game logic, conflicts are extremely rare.
## ❤️ 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!