Minecraft Server Optimization: Lag Fix Settings (Paper, Purpur)

Pick the server type and player count; get lag-reducing settings for server.properties, bukkit.yml, spigot.yml, paper and purpur with their reasons.

The values were generated based on the setting names in the Paper 26.3 and Purpur 26.3 source code. Next to each setting the reason is written; apply only the ones that fit your server, not all of them. Back up the config folder before changing anything.

Why does a Minecraft server lag?

The server updates the world 20 times per second (20 TPS). If an update exceeds 50 milliseconds, the server falls behind and players feel lag. The biggest consumers of this time are: loaded chunk count (view and simulation distance), mobs (especially villagers and mob farms), hoppers and redstone, items on the ground and generating new chunks.

  1. Measure first: Type /spark profiler start, and after 5 minutes /spark profiler stop. The report shows which plugin or mob the time goes to.
  2. Pre-generate the world: Generate everything inside the border in advance with the Chunky plugin; the load that occurs while players explore disappears.
  3. Lower the distances: simulation-distance is the setting that reduces lag the most; view-distance affects network and RAM.
  4. Tune afterwards: The values below are a starting point; measure again with spark and fine-tune.

On Paper 26.x running on Java 25, Aikar flags are no longer required; Paper recommends trying without flags first. For the startup file see Start Command, for RAM RAM Calculator, for error logs Log Analysis.

Guides related to this tool

Frequently Asked Questions

Why is my Minecraft server lagging?

The most common causes: a high simulation distance, lots of mobs (especially villager and mob farms), hoppers and redstone, items on the ground and new chunk generation. Measure with spark first to find the cause.

What is TPS, and what should it be?

TPS is how many times per second the server updates; the ideal value is 20. Below 18, players feel it as lag.

Should I lower view-distance or simulation-distance?

For CPU lag, simulation-distance is more effective (around 5 is enough). view-distance affects network and RAM use; around 8 suits most servers.

Other Minecraft Server Tools

Is your server ready? Add your server to the list, collect votes and automatically reward your players. All tools →