What it does
Watches your server's RAM and TPS, then automatically adjusts view distance, sim distance, and mob AI to keep performance stable. Three levels:
| State | Trigger | What changes |
|---|---|---|
| Healthy | RAM < 70%, TPS = 20 | View 10, sim 8. Re-enables AI for all non-boss mobs. |
| Moderate | RAM > 80% or TPS = 18 | View 8, sim 6. Disables AI for mobs 64+ blocks from players. |
| Critical | RAM > 92% or TPS < 15 | View 5, sim 4. Pauses non-essential AI, clears ground items older than 2 min. |
Mobs stay in the world — AI just gets paused via setAI(false). Only items get removed, and only in critical mode.
Config
thresholds:
ram:
moderate: 80.0
critical: 92.0
tps:
moderate: 18.0
critical: 15.0
distances:
view:
min: 4
max: 16
simulation:
min: 4
max: 12
optimization:
check_interval_ticks: 200 # 10 seconds
chunk_unload_delay_minutes: 5
ground_item_clear_minutes: 2
settings:
debug: false
Commands
/smartoptimizer reload— reload config/smartoptimizer status— current state
Install
- Drop the jar in
plugins/ - Restart or
/reload - Edit
plugins/SmartOptimizer/config.yml
Requirements
- Paper/Spigot/Purpur/Bukkit 1.19+
- Java 17+
Partners
- Use my code for 35% off your first month
