Smart Optimizer

A Bukkit/Paper plugin that dynamically optimizes your Minecraft server based on real-time RAM and TPS usage.

Features

Hardware Detection

Monitors RAM usage using Runtime.getRuntime()
Tracks TPS using MinecraftServer.getServer().tickTimes
Real-time performance metrics collection

Dynamic Scaling Levels

Level 1 (Healthy):

Triggered when RAM usage < 70% and TPS is 20
Maintains View Distance of 10 and Simulation Distance of 8
All mob AI enabled

Level 2 (Moderate):

Triggered when RAM usage > 80% or TPS drops to 18
Reduces View Distance to 8 and Simulation Distance to 6
Disables AI for distant mobs (>64 blocks away)

Level 3 (Critical):

Triggered when RAM usage > 92% or TPS drops below 15
Reduces View Distance to 5 and Simulation Distance to 4
Pauses non-essential mob AI
Clears ground items older than 2 minutes

Visual Integrity

Uses entity.setAI(false) instead of deleting entities
World feels "full" to players even during optimization
Only hard-clears items in Level 3 critical mode

Configuration

All settings are customizable via config.yml:

# Performance thresholds
thresholds:
  ram:
    moderate: 80.0
    critical: 92.0
  tps:
    moderate: 18.0
    critical: 15.0

# Distance settings
distances:
  view:
    min: 4
    max: 16
  simulation:
    min: 4
    max: 12

# Optimization settings
optimization:
  check_interval_ticks: 200        # 10 seconds
  chunk_unload_delay_minutes: 5
  ground_item_clear_minutes: 2

Commands

/smartoptimizer reload - Reload configuration
/smartoptimizer status - Show current optimization status

Installation

Download the latest SmartOptimizer-{version}.jar
Place it in your server's plugins folder
Restart the server or reload plugins
Customize plugins/SmartOptimizer/config.yml as needed

Requirements

Minecraft 1.19+ (Paper/Spigot/Purpur/Bukkit)
Java 17+
No additional dependencies

Development

Built with Maven. Use mvn clean package to build the plugin.

License

This project is open source. Feel free to contribute and improve!