Bukkit is a Mod for Minecraft that provides a plugin API for the Minecraft Server that came out in 2011. It provides an easy way to customize the Vanilla experience, allowing you to install plugins that can change every bit of the server. While previously being maintained at https://bukkit.org, the project is now primarily maintained by SpigotMC.
Configuring Bukkit can be a little difficult, so here’s a full breakdown of configuring the
bukkit.yml that’s generated by default when you run Bukkit.
settings: allow-end: true warn-on-overload: true permissions-file: permissions.yml update-folder: update plugin-profiling: false connection-throttle: 4000 query-plugins: true deprecated-verbose: default shutdown-message: Server closed minimum-api: none
This section is used to define generic settings that the Minecraft Server will follow. None of these settings will improve performance, and are just configuration for Bukkit.
Bukkit provides this as a way to disable the end world.
If you don’t need this world and would like the entire end system disabled, you can set this option to
This configuration option is added by Bukkit to alert you when your server is running behind. It will send a message that looks like:
Can't keep up! Is the server overloaded? Running 5000ms or 250 ticks behind
To disable these messages, you can set
This setting sets the default permission file, which is generally used to group permission nodes together. We’re not going to go in-depth on the file format here, but you can find the Bukkit Wiki article here.
Bukkit provides a way to automatically update plugins before they get loaded.
For example if you wanted to update
WorldEdit.jar, simply put the new version in
update/WorldEdit.jar, and the next time the server restarts Bukkit will automatically copy the updated plugin into the
This option will enable the use of Timings to profile plugins, the implementation of this profiler will depend on the Minecraft Server JAR you’re using.
If you’re using Paper or a fork of it, then this option is overwritten by
If you have the issue of players rejoining the server too frequently, this will let you control how often players can join, logout, and join again.
The value is in milliseconds, so if you wanted players to only be able to rejoin every 10s, you would set it to
This option is used when the Minecraft Server is asked about what plugins it has installed in two different spots:
This option is used in several places regarding whether the server will report on a plugin doing deprecated actions.
It should be left to
default unless you have a reason to use it in another mode (
Bukkit allows you to configure the message sent to players when the server shuts down.
If you’d like to use custom colors, you can add them by using the
§ prefix like so:
To maintain compatibility with old plugins, Bukkit has developed a system that allows plugins to define which version of Bukkit they’re based off.
If you’d like to disallow old plugins without a defined API version, or plugins that have defined an older API version, you can set the minimum here.
Valid values as of 1.17 are:
spawn-limits: monsters: 70 animals: 10 water-animals: 15 water-ambient: 20 ambient: 15
This section is used to define how many of each entity type can spawn in the world. This can be used to improve performance a lot, especially because ambient (bats) and water-animals/water-ambient mobs do not need as high of a count as these defaults. Reducing these values can reduce the amount of entities that are attempted to be spawned, improving performance.
chunk-gc: period-in-ticks: 600
chunk-gc.period-in-ticks allows you to configure how long a chunk loaded by a plugin stays loaded.
Generally this shouldn’t need to be changed.
ticks-per: animal-spawns: 400 monster-spawns: 1 water-spawns: 1 water-ambient-spawns: 1 ambient-spawns: 1 autosave: 6000
This section is used to define how often certain systems in the game get ticked. It can be used to tune your server performance, specifically reducing how much mob spawning hurts the performance.
These settings have a few possible options for configuration.
Beyond that, you can raise how often certain types of entities are attempted to be spawned.
For example, I would personally raise
ambient-spawns to be higher, as quick spawning of those entities does not change the experience much.
Bukkit allows you here to configure how often the worlds and player data is saved.
You should set this value as high as you can tolerate data loss, which the default 5 minute (
6000 ticks) is generally a good default for this.
If for some reason you’d like to not save this data, you can set it to
0 to disable the autosave.
This originally was used to define aliases for commands, but like the current value says, has been moved to
You can find the Bukkit Wiki article on that here.
I hope you liked the article! If you have any further questions about configuring your
bukkit.yml, join our Discord and get help from experts!
If you’d like to read more articles about configuring and optimizing your 1.17 Minecraft Server, they’re coming soon!