ConfigOptimizer

ConfigOptimizer detects your server software (Bukkit, Spigot, Paper, Purpur, and their forks), applies battle-tested performance tweaks from the community optimization guide, and restarts your server so changes take effect instantly. Everything is safely backed up before any modification.

How it works

1. Smart Detection — Scans for unique classes to identify your server type: Purpur → Paper → Spigot → Bukkit. Forks are automatically recognized (e.g., a Purpur fork is treated as Purpur)

2. Targeted Patches — Only applies settings relevant to your server. Paper gets Paper + Spigot + Bukkit patches; Purpur gets everything including Purpur-specific settings; Bukkit applies server.properties + bukkit.yml tweaks. No cross-contamination.

3. Needs Check — Reads every config file (server.properties, bukkit.yml, spigot.yml, paper-world-defaults.yml, paper-global.yml, purpur.yml) and compares current values against optimized targets. If everything is already optimal, the plugin disables itself and does nothing.

4. Automatic Backup — Before any write, copies every affected file to plugins/ConfigOptimizer/backups/<date>/ with full directory structure preserved. Rollback is a simple copy-paste away.

5. Guided Restart — After applying patches, schedules a clean server shutdown 2 seconds later so all new settings take effect on next boot.

6. Self-Disabling — Once optimizations are applied, the plugin shuts itself down. It only runs again if configs are reset or changed.

What gets optimized

Over 100 individual settings across all config files:

| Config | Highlights |
|--------|-----------|
| server.properties | simulation-distance, view-distance, network-compression-threshold |
| bukkit.yml | spawn limits, tick rates for all mob categories |
| spigot.yml | entity activation/tracking ranges, merge radius, hopper timings, mob-spawn-range |
| paper-world-defaults.yml | chunk unloading, despawn ranges, per-player mob spawns, entity-per-chunk-save limits, alt-item-despawn, redstone impl, anti-xray, nether roof damage, tick rates, armor stands, explosions, treasure maps, hopper behavior |
| paper-global.yml | velocity settings (disabled by default) |
| purpur.yml | alternate keepalive, zombie behavior, portal usage, villager lobotomize, dolphin treasure search, teleport-if-outside-border |

Usage

1. Drop the jar into plugins/
2. Restart the server
3. ConfigOptimizer detects, backs up, patches, and restarts — all automatically

Requirements

• Java 21+
• Bukkit / Spigot / Paper / Purpur (or any fork)
• No configuration needed — zero setup

FAQ

Q: Will this break my server?
A: All values are based on the well-known community optimization guide. Backups are created automatically before any change.

Q: Does it work on forks?
A: Yes. The detector checks for parent software classes, so any fork of Paper or Purpur is correctly identified.

Q: Can I run it again after changing configs?
A: Yes, Go to the plugins/ConfigOptimizer folder and delete a file called "OPTIMIZATIONSAPPLIED", and after that reboot the server.