OptimizeServer

OptimizeServer

Performance engineering, bottleneck diagnostics, and safe execution optimization for Minecraft servers.

by NotGamerPratham

Modrinth |
GitHub Releases |
Source Code

What is OptimizeServer?

OptimizeServer helps your server run its normal workload more efficiently. It finds bottlenecks, cuts down on unnecessary monitoring overhead, and gives you diagnostics backed by real measurements.
It does not change vanilla gameplay.

Gameplay Preservation Guarantee

OptimizeServer
never:

• skips ticks or fakes TPS readings
• removes entities or disables mob AI
• reduces view or simulation distance
• forces System.gc() or silently changes world configuration

Redstone, mob AI, spawning, world generation, chunk loading, combat, and physics all behave exactly as in vanilla.

Features

• Real-time monitoring: TPS and MSPT over 5s, 30s, 1m, 5m, and 15m windows (P50/P95/P99), plus CPU, memory/GC, network RTT, chunks, entities, tasks, and storage
• Diagnostics engine: classifies bottlenecks as CPU, memory, GC, chunks, entities, plugin tasks, storage, or network, with recommendations backed by evidence
• Reversible optimizations: 9 internal modules with before/after measurements and one-command rollback
• Folia support: a dedicated scheduler layer for global-region, region, entity, and async tasks
• Spark & Chunky integration: if Spark and Chunky are missing, they are downloaded automatically and checked with SHA-512 before installing
• Local reports: diagnostic reports are saved on your server, and no data is sent to external services

Compatibility

• Platforms: Spigot, Paper, Purpur, Pufferfish, Airplane, Folia, Leaves, Gale (unknown forks run in conservative safe mode)
• Minecraft: 1.8.8 – 1.21.x+
• Java: 8, 11, 16, 17, 21, 25+

Commands

Main command:
/optimizeserver (alias
/os)

• /os status | tps | mspt | cpu | memory | network | entities
• /os chunks [status|recommend|start|pause|cancel]
• /os diagnose [full|cpu|memory|chunks|entities|plugins]
• /os profile <start|stop|status|memory> | /os health
• /os optimize [status|list|enable|disable|rollback]
• /os report <generate|history> | /os reload | /os version | /os help

All permissions fall under
optimizeserver.admin and default to op.

Installation

• Drop OptimizeServer.jar into your plugins/ folder.
• Restart the server. If Spark and Chunky are missing, they are installed automatically.
• Edit plugins/OptimizeServer/config.yml if you need to.

Support & Source

Open-source under the MIT License. Please report bugs and request features on
GitHub Issues.