New to CraftNodes? Use code WELCOME10 at checkout for 10% off your first month.

Back to Blog

May 13, 2026

How to Configure Paper's Performance Settings for Maximum TPS

Optimise Paper server settings for maximum TPS. Configure paper-global.yml, paper-world-defaults.yml, and spigot.yml for the best performance.


paper-world-defaults.yml

This file contains world-specific defaults that apply to all worlds. Key settings:

  • max-auto-save-chunks-per-tick: 8 — Reduce for better TPS during auto-save
  • prevent-moving-into-unloaded-chunks: true — Prevent player movement into unloaded areas
  • entity-per-chunk-save-limit — Limit entities saved per chunk to prevent lag on load

spigot.yml Optimization

  • mob-spawn-range: 6 — Reduce mob spawn range to improve TPS
  • entity-activation-range — Reduce activation range for animals, monsters, and villagers
  • merge-radius — Merge nearby dropped items and experience orbs

bukkit.yml

  • spawn-limits — Reduce global mob caps from defaults
  • chunk-gc.period-in-ticks: 400 — How often to garbage collect chunks

Paper Async Features

Paper includes async chunk loading enabled by default. This significantly improves performance when players explore or chunks load/unload. Ensure your Paper version is up to date to benefit from the latest async improvements.


All posts

CraftNodes Blog