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.Recommended spawn-limits
spawn-limits set how many mobs of each type can exist around players. On Paper, limits count per player by default.
Recommended ticks-per values
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
- Before you change anything, run
spark tpsand note TPS and tick times at a busy time. - Make your changes and restart.
- At a similar busy time, run
spark tpsagain. Lower tick times (MSPT) mean the server has more headroom. - Ask players whether mob farms and the Survival experience still feel right.
Does Paper override bukkit.yml?
Paper has its own spawn settings inconfig/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 toserver.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 issettings.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.
Related guides
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:- Live Chat: Quick assistance via our website.
- Support Ticket: Open a Ticket
- Discord: Join our Community
- Email: support@freakhosting.com
Last Updated: October 2026