Aikar Flags for Paper JVM tuning to reduce lag spikes in Minecraft

What to understand (so it’s not just “magic words”):

• -Xms / -Xmx set the heap size. Paper’s guidance is to keep them equal for consistency.

• The rest mainly tunes G1GC to avoid huge pause spikes and keep behavior steadier under load.

How much RAM should you allocate

This is where people speedrun their own outage.

Paper’s guidance:

• Do not allocate all available memory on a shared host.

• Reduce Xms/Xmx by roughly 1000–1500MB below what your host claims you have, to avoid OOM or the OOM killer, and to leave room for the OS.

• Paper recommends 6–10GB minimum even for low player counts, because G1GC generally operates better with more memory—up to a point (after that, diminishing returns).

Example: host says “8GB”? Paper’s doc literally suggests ~6500MB for safety.

Generate a clean start script (instead of hand-editing)

Paper says this page is explanatory, and points you to a script generator for building a proper start script.
If you want a dead-simple generator UI, flags.sh generates Minecraft server start scripts too.

Enable GC logging to diagnose “lag spikes” for real

If you suspect GC pauses, turn on GC logging and check what’s happening during spikes.

Paper includes a Java 11+ GC logging option on the same page.

What this gives you:

• A rolling log of GC activity you can correlate with TPS drops and player spikes (instead of guessing).

Common mistakes with Aikar Flags

• Setting Xmx to “all my RAM” → OS starves, OOMKiller shows up, server dies.

• Thinking more RAM always = more performance → Paper explicitly calls out diminishing returns.

• Mixing random JVM flags from old Reddit posts → Paper warns flags can change behavior; use a known baseline first.

Conclusion

Aikar Flags are still a solid baseline for Paper: start with the recommended command, size memory safely (leave headroom), and enable GC logs if you’re chasing spikes. That combo fixes a surprising amount of “mystery lag” without touching gameplay settings.