Customizable Options available for Paper/Spigot/Bukkit Minecraft Servers

When using Bukkit, Spigot or Paper versions of Minecraft Servers, there is an additional file created in your servers File Manager for server customization, depending on the version of Minecraft Server you’re running, these are different;

PaperMC: paper.yml

Bukkit: bukkit.yml

Spigot: spigot.yml

There are many different options available for customising these files, some of these options and what they do, are listed below;

See the full list of available configuration options

verbose

default: false
description: Sets whether the server should dump all configuration values to the server log on startup.

load-permissions-yml-before-plugins

default: true
description: Loads bukkit’s permission.yml file before plugins, allowing them to check permissions immediately on enable.

bungee-online-mode

default: true
description: Instructs the server how to handle player UUIDs and data when behind bungee. Set to match your proxy’s online-mode setting.

region-file-cache-size

default: 256
description: Sets the maximum size of the region file cache.

incoming-packet-spam-threshold

default: 300
description: Sets the threshold at which the server will consider incoming packets as spam and ignore them.

save-player-data

default: true
description: Sets whether the server should save player data, such as inventories, experience, and advancements.

use-alternative-luck-formula

default: false
description: Use alternative luck formula by Aikar, allowing luck to be applied to items that have no quality defined. Makes major changes to fishing formulas.

use-versioned-world

default: false
description: Sets whether the server should save your world in version-specific directories.
warning: This setting is highly experimental! Don’t use this in a production environment!

suggest-player-names-when-null-tab-completions

default: true
description: Instructs the server to return a list of players when tab-completing if the plugin has no tab completions of its own.

enable-player-collisions

default: true
description: Sets whether the server should allow players to collide with one another.
warning: This setting can be broken by plugins interacting with the scoreboard, double check plugins when troubleshooting this value.

save-empty-scoreboard-teams

default: false
description: Some scoreboard plugins leave hundreds of empty scoreboard teams around, dramatically slowing down login times. This sets whether the server should remove those empty teams automatically.

velocity-support

enabled
- default: false
- description: Set this to true if this server is behind a Velocity proxy.
online-mode
- default: true
- description: Instructs the server how to handle player UUIDs and data when behind velocity. Set to match your proxy’s online-mode setting.
secret
- default: ‘ ‘ (empty string)
- description: The secret string that is shared by your Velocity proxy and this server. This needs to match your proxy’s forwarding-secret setting.

async-chunks

enabled
- default: true
- description: Sets whether the server should load and save chunks asynchronously, improving performance.
load-threads
- default: -1
- description: The number of threads the server should use for world saving and loading. This is set to (number of processors – 1) by default.

watchdog

early-warning-every
- default: 5000
- description: The interval in milliseconds between printed thread dumps while the server is hanging.
early-warning-delay
- default: 10000
- description: The number of milliseconds before the watchdog thread starts printing thread dumps after the server starts hanging.

spam-limiter

tab-spam-increment
- default: 1
- description: The number that the internal tab spam counter increases by when a player presses tab in the chat window.
tab-spam-limit
- default: 500
- description: The number that the internal tab spam counter can reach until the server kicks the player for spam.

book-size

page-max
- default: 2560
- description: The max number of bytes a single page in a book can contribute to the allowed byte total for a book.
total-multiplier
- default: 0.98
- description: Each page has this multiple of bytes from the last page as it’s contribution to the allowed byte total for a book (with the first page being having a multiplier of 1.0).

messages

no-permission
- default: ‘&cI’‘m sorry, but you do not have permission to perform this command. Please contact the server administrators if you believe that this is in error.’
- description: The message the server sends to requestors with insufficient permissions.
kick
- authentication-servers-down
  - default: ‘ ‘ (empty string)
  - note: The default value instructs the server to send the vanilla translateable kick message.
  - description: Message to kick a player with when they are disconnected because the Mojang authentication servers are down.
- connection-throttle
  - default: Connection throttled! Please wait before reconnecting.
  - description: Message to use when kicking a player when their connection is throttled.
- flying-player
  - default: Flying is not enabled on this server
  - description: Message to use when kicking a player for flying.
- flying-vehicle
  - default: Flying is not enabled on this server
  - description: Message to use when kicking a player’s vehicle for flying.

timings

enabled
- default: true
- description: Controls the global enable state of the Timings platform.
verbose
- default: true
- description: Instructs Timings to provide more specific information in its reports. For example, specific entity types causing lag rather than just “entities”.
server-name-privacy
- default: false
- description: Instructs Timings to hide server name information in reports.
hidden-config-entries
- default: { database, settings.bungeecord-addresses }
- description: Configuration entries to hide in Timings reports.
history-interval
- default: 300
- description: The interval in seconds between individual points in the Timings report.
history-length
- default: 3600
- description: The total amount of data to keep for a single report.
- warning: This value is validated server side, massive reports will be rejected by the report site.
server-name
- default: Unknown Server
- description: Instructs timings on what to put in for the server name.

World Settings

World settings are configured on a per-world basis. The child-node default is used for all worlds that do not have their own specific settings.

per-player-mob-spawns

default: false
description: Determines whether the mob limit (in bukkit.yml) is counted per-player or for the entire server.

disable-teleportation-suffocation-check

default: false
description: Disables the suffocation check the server performs before teleporting a player.
note: While useful to keep your players out of walls, leaving this feature on may allow players to teleport through solid materials by logging out in specific locations.

optimize-explosions

default: false
description: Instructs the server to cache entity lookups during an explosion, rather than recalculating throughout the process. This speeds up explosions significantly.

portal-search-radius

default: 128
description: The maximum range the server will use to look for an existing nether portal. If it can’t find one in that range, it will generate a new one.

fixed-chunk-inhabited-time

default: -1
description: If 0 or greater, set the chunk inhabited time to a fixed number.
note: The timer is increased when chunks are kept loaded because of player activity.

use-vanilla-world-scoreboard-name-coloring

default: false
description: Instructs the server to use the vanilla scoreboard for player nickname coloring.
note: Useful when playing on adventure maps made for the vanilla server and client.

remove-corrupt-tile-entities

default: false
description: Instructs the server to automatically remove tile entities it detects as broken and cannot fix.

enable-treasure-maps

default: true
description: Allows villagers to trade treasure maps.

treasure-maps-return-already-discovered

default: false
description: Instructs the server to target the first treasure location found, rather than the first undiscovered one. Vanilla mechanics normally find the first undiscovered location, which may lead to structures that were not fully looted, and can also fail with a world border set. Enabling this will make the map simply find the closest target structure, regardless if it has been loaded or not already.

experience-merge-max-value

default: -1
description: Instructs the server put a maximum value on experience orbs, preventing them all from merging down into 1 single orb.
note: The default value instructs the server to use no max value, allowing them to merge down into a single orb. This is especially noticeable when defeating boss monsters.

prevent-moving-into-unloaded-chunks

default: false
description: Sets whether the server will prevent players from moving into unloaded chunks or not.

max-auto-save-chunks-per-tick

default: 24
description: The maximum number of chunks the auto-save system will save in a single tick.

falling-block-height-nerf

default: 0
note: Values less than 1, will disable this feature.
description: The height at which falling blocks will be removed from the server.

tnt-entity-height-nerf

default: 0
note: Values less than 1, will disable this feature.
description: The height at which Primed TNT entities will be removed from the server.

filter-nbt-data-from-spawn-eggs-and-related

default: true
description: Instructs the server to remove certain NBT data from spawn-eggs, falling-blocks, and other often abused items in creative mode.
note: Some adventure maps may require this be turned off to function correctly, but we do not recommend turning it off on a public server.

max-entity-collisions

default: 8
description: Instructs the server to stop processing collisions after this value is reached.

disable-creeper-lingering-effect

default: false
description: Disables creepers randomly leaving behind a lingering area effect cloud.