Skip to content
Pratham Anand Basavanal edited this page Nov 10, 2026 · 1 revision

FAQ

Will OptimizeServer change how my server plays?

No. It never removes entities, disables AI, skips ticks, changes view or simulation distance, or edits game rules or world data. These rules are enforced in code and can't be turned off in the config.

Then how does it improve performance?

In three ways:

  1. It shows you exactly what's causing lag (a plugin, entities, chunk generation, GC, the disk, and so on), so you can fix the real cause.
  2. It keeps its own overhead very low: bounded buffers, no new allocations during aggregation, merged queries, and async work.
  3. It works with Spark for profiling and Chunky for pre-generation. Pre-generating chunks ahead of time removes generation lag while players explore.

Why did Spark and Chunky appear in my plugins folder?

OptimizeServer installs them automatically if they're missing, after checking the downloads. To turn this off, set integrations.auto-install.enabled: false. See Installation.

Will Chunky start generating chunks by itself?

No. Pre-generation only runs when an admin uses /os chunks start.

Does it send any data anywhere?

No. Reports are saved locally in plugins/OptimizeServer/reports/. Spark profiles are never uploaded unless you choose to upload one.

It says "conservative safe mode is active". What does that mean?

OptimizeServer didn't fully recognise your server software, or an expected API is missing. Monitoring and diagnostics still work, but conditional optimization modules stay off to be safe. Run /os version to see what was detected.

Does it work on Folia?

Yes. It has a dedicated region-aware scheduler. See Compatibility.

Network ping is high. Can OptimizeServer fix it?

No plugin can lower the physical internet distance between a player and your server. /os network shows whether the delay comes from the player's connection or from server-side lag, which OptimizeServer can help you diagnose.

Why doesn't /os diagnose plugins show exact CPU % per plugin?

Measuring exact CPU time per plugin requires sampling stack traces. Run /os profile start with Spark to get that. Without a profiler, OptimizeServer shows task and worker counts per plugin, and it won't claim CPU shares it can't measure.

How do I report a bug?

Open an issue at https://github.com/NotGamerPratham/OptimzeServer/issues and include:

  • the output of /os version
  • a report from /os report generate
  • any console errors