How to optimize Paper Minecraft server

Since 1.13, Minecraft servers have gotten progressively harder to run.

There are a few ways to make your server run better, we will be outlining some here.

But first, it's good to note that a "perfect" PaperMC optimization guide does not exist, most optimization changes include changing or removing gameplay features. Each PaperMC server will be different, you have to decide how much you want to change and sacrifice for performance.

If you have performance headroom you might even want to do the opposite! For example, maybe you want an extra high view distance because you think it looks cool.

Choosing a PaperMC Server JAR

One of the biggest choices to make before you even start optimizing is choosing the server jar you want to use.

There are a lot of options you can choose from, but for simplicity's sake we're just going to outline the two best known "paths", the bukkit platform, and fabric. See our Server Jars to find PaperMC page if you want to know more.

The gist of it is the bukkit platform is generally recommended for bigger public servers and fabric for smaller servers with friends.
The bukkit platform allows you to use plugins, and fabric allows you to run mods.

For the bukkit platform the Paper jar is recommended, it includes many performance improvements, bug fixes and configuration options
For Fabric check our page.

Guides to optimize your PaperMC server

There are many different options you can utilize to change your servers gameplay and performance.

We recommend checking out https://github.com/YouHaveTrouble/minecraft-optimization for an in depth guide on how to optimize your PaperMC server.

Remember that each server is be different, and that you have to decide for yourself which features you want to change. Don't blindly copy paste values 😉

You can also check this guide which goes way more in depth of what each option does and how each one may affect your server.

What to avoid:

Plugins that promise to fix your lag often end op doing the opposite, stay away from plugins like Clearlagg! - Plugins like these will promise to do things like removing entities. This will in fact help with lag, for a short bit. But your server will immediately try to spawn more entities again, which just results in more lag!

What you should do instead, is change your server options and just lower the max entities allowed.

An analogy by BillyGalbreath:

Lets say IRL you are tasked with keeping 50 trees (pretend these are your entities in game) in your yard, but some guy (clearlagg) comes around every 5 minutes and chops them all down. its your job to make sure there's always 50 trees there at a MINIMUM. so you have to go plant more. then mr clearlagg comes along 5 minutes later and chops them down again. (rinse and repeat)

Same could be said about any mob stacking plugins. imagine you have to keep 50 trees in your land, but some other guy (mob stacker) deletes 49 of them and puts a sign on that 1 remaining that says "x50". theres really only 1 tree there, and you still have to keep a MINIMUM of 50, so you plant 49 more.