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
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)
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.ymltweaks. No cross-contamination.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.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.Guided Restart — After applying patches, schedules a clean server shutdown 2 seconds later so all new settings take effect on next boot.
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
- Drop the jar into
plugins/ - Restart the server
- 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.
