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.

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.

 
  • yml, option, minecraft, bukkit, papermc, spigot, additional, options, configuration, server, pterodactyl, sapling servers
  • 0 Users Found This Useful
Was this answer helpful?

Related Articles

Uploading & installing Custom Modpacks

Putting a custom modpack on your server is very easy and can be done by following steps below:1....

How to install Plugins on your Minecraft Server in Pterodactyl Panel

We have an easy to use one-click Plugin installation page, that will instantly download the...

How to upload & enable custom Minecraft Versions or modpacks in Pterodactyl Panel

Once you have downloaded the Minecraft modpack or version that you want to use, you will need to...

Powered by WHMCompleteSolution