Smart Optimizer

Smart Optimizer watches your server's RAM and TPS and lowers view distance, simulation distance and mob AI when things start getting heavy. Once the server recovers it puts everything back to normal.

Works on Paper (and its forks) and Fabric, for MC 1.20.1 up to 26.2+.

How it works

Every 10 seconds (configurable) it checks the server and picks a level:

• Healthy (RAM under 80%, TPS 18 or higher): view 10, sim 8, all mob AI enabled
• Moderate (RAM over 80% or TPS under 18): view 8, sim 6, AI disabled for mobs more than 64 blocks from any player
• Critical (RAM over 92% or TPS under 15): view 5, sim 4, non-essential AI paused, ground items older than 2 minutes get cleared

It also unloads chunks in dimensions that haven't had any players in them for 5+ minutes.

Mobs never get killed or removed, their AI is just paused and turned back on when the server is healthy again. The only thing that ever gets deleted is old ground items, and only in critical mode.

Downloads

Jar Minecraft Platform Java SmartOptimizer.jar 1.20.1 – 26.2+ Paper, Folia, Purpur, Pufferfish, Spigot, Bukkit 17+ SmartOptimizer-Fabric.jar 26.1 – 26.2+ Fabric Loader ≥ 0.19 + Fabric API 25+ SmartOptimizer-Fabric-legacy.jar 1.20.1 – 1.21.11 Fabric Loader ≥ 0.15 + Fabric API 17+

• Pick the .jar file that fits your version and platform. Configurations will be listed below

Config

thresholds: ram: moderate: 80.0 # % RAM usage to trigger moderate critical: 92.0 # % RAM usage to trigger critical tps: moderate: 18.0 critical: 15.0 distances: view: min: 4 max: 16 simulation: min: 4 max: 12 optimization: check_interval_ticks: 200 # 200 ticks = 10 seconds chunk_unload_delay_minutes: 5 # unload chunks in empty dimensions after this long ground_item_clear_minutes: 2 # only applies in critical mode settings: debug: false

If you set something out of range it gets clamped to a safe value, it won't break anything.

Commands

• /smartoptimizer status shows current RAM, TPS and optimization level
• /smartoptimizer reload reloads the config

Aliases are /so and /smartopt. Both commands need smartoptimizer.admin, which defaults to op.

Partners

Use my code for 35% off your first month.