Skip to main content
To optimise bukkit.yml, lower the spawn-limits (for example monsters from 70 to 50) and raise ticks-per.monster-spawns from 1 to 4 so the server tries to spawn mobs less often. These two changes cut the number of mobs the server has to run, which is one of the main causes of lag. bukkit.yml sits in the main folder of Paper, Purpur, Spigot and other plugin servers.

How to edit bukkit.yml safely

1

Make a backup

Click Backups, then Create backup.
2

Stop the server

Click Stop. A running server can overwrite your edits.
3

Edit the file

In Files, click bukkit.yml, change the values and click Save Content. YAML uses spaces, not tabs: keep the indentation exactly as it is.
4

Start and test

Start the server and watch the console for errors. Check TPS with spark tps.
Every save keeps the old version. Click History in the file editor to compare or restore an earlier version of bukkit.yml.

spawn-limits set how many mobs of each type can exist around players. On Paper, limits count per player by default.

ticks-per sets how often (in ticks; 20 ticks = 1 second) the server tries to spawn each mob type.

Other useful bukkit.yml settings

Don’t go too low. Very low monster limits make Survival feel empty and break mob farms players rely on. Change one value at a time and test.

How to check that your changes worked

  1. Before you change anything, run spark tps and note TPS and tick times at a busy time.
  2. Make your changes and restart.
  3. At a similar busy time, run spark tps again. Lower tick times (MSPT) mean the server has more headroom.
  4. Ask players whether mob farms and the Survival experience still feel right.
If nothing improves, entities probably aren’t the cause. Run the spark profiler to find what is.

Does Paper override bukkit.yml?

Paper has its own spawn settings in config/paper-world-defaults.yml. By default these leave the limits to bukkit.yml, and entities.spawning.per-player-mob-spawns is true, so the limits in bukkit.yml count per player. If you or a plugin changed Paper’s spawn settings, they can take priority. Check both files if your changes seem to have no effect.

Frequently asked questions

Where is bukkit.yml?

In the main folder of your server, next to server.properties. It is created the first time a Paper, Purpur or Spigot server starts. Vanilla, Fabric, Forge and NeoForge servers don’t have it.

What are the best bukkit.yml settings?

For most servers: monsters: 50, animals: 8, water-ambient: 5, ambient: 1 and monster-spawns: 4. Then check TPS and adjust.

How do I fix “Connection throttled! Please wait before reconnecting”?

Wait a few seconds before you reconnect. The wait is settings.connection-throttle (4,000 ms by default). Behind a proxy such as Velocity, set it to -1 on the backends so the proxy’s single address isn’t throttled.

Do I need to restart after editing bukkit.yml?

Yes. Stop the server before you edit and start it afterwards. Don’t use /reload.

Minecraft server guide

Every Minecraft guide in one place.

spigot.yml settings

Entity activation and merge radius.

Fix server lag

The full lag checklist.

spark profiler

Measure the effect of your changes.

Use the file manager

Edit files and restore old versions.
Checked against the official PaperMC bukkit.yml reference on 29 October 2026, and the file steps tested on our Game Panel (Minecraft 26.1, Paper and Fabric). Defaults may change in future versions.

Need Extra Help?

If you encounter any issues, our support team is ready to assist:

Save on Your Hosting

Ready to upgrade your hosting? Use code KB20 at checkout for 20% off your first order!

Last Updated: October 2026