Skip to content

spigot.yml

advancements:
disable-saving: false#
Prevents saving of Advancements.
disabled: #

- minecraft:story/disabled

A list of strings, each being:

  • A namespace-including Advancement key, For example, “minecraft:adventure/avoid_vibration” would disable the Sneak 100 advancement. The Minecraft Wiki has a list of all the Vanilla advancements, which need the “minecraft:” namespace prepended to them.
  • The literal string ”*”, which disables all Advancements.
  • An Advancement key’s namespace, which disables all advancements inside it. For example, “minecraft” would disable all Vanilla advancements.

if an advancement is disabled without all of it’s children also being disabled console errors occur on load.

commands:
log: true#
Whether to log commands executed by players, in chat or on signs. This currently logs in the format ” issued server command: ”.
replace-commands: #

- setblock - summon - testforblock - tellraw

List of Vanilla commands that should override any plugin commands.
send-namespaced: true#
Whether to send commands with a namespace (like minecraft:give) to the client.
silent-commandblock-console: false#
Whether to log Vanilla command feedback to the Console.
spam-exclusions: #

- /skill

Any chat message or command that prefix matches an entry in this list will be excluded from the built-in spam filter. Commands need a ”/” to be counted as commands.
tab-complete: 0#

How many characters need to be typed before commands tab-complete.

  • < 0: Tab-completion is disabled
  • = 0: Always tab-complete all available commands
  • \> 0 only tab-complete commands after n characters are typed. This behaves as 0 due to client changes.
messages:
outdated-client: Outdated client! Please use {0}#
The kick for a player when they can’t join, as the server version is newer than the client version. The message is formatted with legacy ”&” style formatting, and “\n” for newlines. Additionally, it replaces {0} with the current server version
outdated-server: Outdated server! I'm still on {0}#
The kick for a player when they can’t join, as the server version is older than the client version. The message is formatted with legacy ”&” style formatting, and “\n” for newlines. Additionally, it replaces {0} with the current server version
restart: Server is restarting#
The kick message for players on the server when it starts restarting, or if a player tries to join while the server is still restarting. The message is formatted with legacy ”&” style formatting, and “\n” for newlines.
server-full: The server is full!#
The kick message for a player when they can’t join, as the server doesn’t have any open slots (current-players >= max players) The message is formatted with legacy ”&” style formatting, and “\n” for newlines.
unknown-command: Unknown command. Type "/help" for help.#
The default message sent to a player, when a command they run is not found by the server The message is formatted with legacy ”&” style formatting, and “\n” for newlines.
whitelist: You are not whitelisted on this server!#
The kick message for a player when:

  • The player is unable to join as the whitelist is active.
  • The player was kicked after they are removed from the whitelist, with enforce-whitelist enabled.
  • The player was kicked after the whitelist enables, with enforce-whitelist enabled

The message is formatted with legacy ”&” style formatting, and “\n” for newlines.

players:
disable-saving: false#
Prevents saving player data.
settings:
attribute:
attackDamage:
max: 2048.0#
Overrides the maximum for the attackDamage attribute.
maxAbsorption:
max: 2048.0#
Overrides the maximum for the maxAbsorption attribute.
maxHealth:
max: 1024.0#
Overrides the maximum for the maxHealth attribute.
movementSpeed:
max: 1024.0#
Overrides the maximum for the movementSpeed attribute.
bungeecord: false#

Whether to enable Bungeecord support, enabling:

  • Receiving forwarded player-data and source ips.
  • Support for binding to unix domain sockets.
debug: false#
Enables debug logging, by setting the log level to ALL.
log-named-deaths: true#
Whether to log deaths of entities with custom names to console and latest.log
log-villager-deaths: true#
Whether to log villager deaths and witch transformations to console and latest.log
moved-too-quickly-multiplier: 10.0#
Controls how fast a client can move in one packet. If triggered, the server logs to console and prevents the move.
moved-wrongly-threshold: 0.0625#
Controls how far the client can move per move-packet, defined as the distance in blocks squared. If triggered, the server logs to console and prevents the move.
netty-threads: 4#
Sets number of netty threads.
player-shuffle: 0#
How often to shuffle the list of player connections, in ticks, 0 or less to disable. This prevents players from strategically re-logging to increase their position in the tick order. This can have a performance impact if enabled with low values.
restart-on-crash: true#
Whether to call `restart-script` when the server is killed by the watchdog. Note: this setting doesn’t restart the server if it gets killed externally, like by the OS.
restart-script: ./start.sh#
The script file that is run when the server restarts.

  • On Windows this is passed to `cmd /c start {restart-script}`. Normally, this means specifying a Batch (*.bat) file to be run. See Microsoft’s documentation for specific options.
  • On other platforms, this is passed to `sh {restart-script}`. The option is interpreted as an absolute or relative path to a shell script (*.sh). See your operating system’s documentation for more information (e.g. Man Pages).

For more information on Spigot’s restart system, read this

sample-count: 12#
How many players to display the names of in the player-count hover. The selected players, and their positions in the list, are randomized.
save-user-cache-on-stop-only: false#
If false, the server saves the user-cache on every update.
timeout-time: 60#
Time in seconds since the last server-tick that the server is deemed not-responding by the server, and is stopped/restarted by the watchdog.
user-cache-size: 1000#
How many players to keep in the user cache.
stats:
disable-saving: false#
Whether to prevent saving stats.
forced-stats: {}#

An Object, where:

  • The Keys inside are any “Resource location” from The Minecraft Wiki.
  • The Value for each key is an integer to force the related stat to.
world-settings:
default:
unload-frozen-chunks: false#
Experimental option that controls whether chunks can unload whilst ticks are frozen via /tick freeze.
arrow-despawn-rate: 1200#
The number of ticks before an arrow despawns.
below-zero-generation-in-existing-chunks: true#
Whether to allow conversion of existing chunks to full (post 1.18) height.
dragon-death-sound-radius: 0#
The number of blocks that the dragon death sound is audible. Set to 0 for global (including cross-dimension).
enable-zombie-pigmen-portal-spawns: true#
Whether to allow zombified piglins to spawn inside nether portals. This setting does not affect portal travel for any mobs.
end-portal-sound-radius: 0#
The number of blocks that the end portal opening sound is audible. Set to 0 for global (including cross-dimension).
entity-activation-range:
animals: 32#
The entity activation range for animals.
flying-monsters: 32#
The entity activation range for flying monsters.
ignore-spectators: false#
Whether spectators activate entities within range.
misc: 16#
The entity activation range for misc entities.
monsters: 32#
The entity activation range for monsters.
raiders: 64#
The entity activation range for raiders.
tick-inactive-villagers: true#
Whether to keep ticking villagers that are outside of their activation range.
villagers: 32#
The entity activation range for villagers.
villagers-active-for-panic: true#
Whether to activate villagers when they want to panic.
villagers-work-immunity-after: 100#
The time in ticks a villager has to be inactive and working to be woken up.
villagers-work-immunity-for: 20#
How long a villager should be woken up for, in ticks, after villagers-work-immunity-after.
wake-up-inactive:
animals-every: 1200#
How often an inactive animal outside of range will be woken up, in ticks. This is a minimum due to being limited to animals-max-per-tick.
animals-for: 100#
How long to wake an inactive animal up for, in ticks.
animals-max-per-tick: 4#
A limit of how many inactive animals can be woken up on the same tick.
flying-monsters-every: 200#
How often an inactive flying monster outside of range will be woken up, in ticks. This is a minimum due to being limited to flying-monsters-max-per-tick.
flying-monsters-for: 100#
How long to wake an inactive flying monster up for, in ticks.
flying-monsters-max-per-tick: 8#
A limit of how many inactive flying monsters can be woken up on the same tick.
monsters-every: 400#
How often an inactive monster outside of range will be woken up, in ticks. This is a minimum due to being limited to monsters-max-per-tick.
monsters-for: 100#
How long to wake an inactive monster up for, in ticks.
monsters-max-per-tick: 8#
A limit of how many inactive monsters can be woken up on the same tick.
villagers-every: 600#
How often an inactive villager outside of range will be woken up, in ticks. This is a minimum due to being limited to villagers-max-per-tick
villagers-for: 100#
How long to wake an inactive villager up for, in ticks.
villagers-max-per-tick: 4#
A limit of how many inactive villagers can be woken up on the same tick.
water: 16#
The entity activation range for water mobs.
entity-tracking-range:
animals: 96#
Controls how far in blocks animals are tracked (sent to) the player. This is scaled by the entity-broadcast-range-percentage.
display: 128#
Controls how far in blocks display entities are tracked (sent to) the player. This is scaled by the entity-broadcast-range-percentage.
misc: 96#
Controls how far in blocks misc entities are tracked (sent to) the player. This is scaled by the entity-broadcast-range-percentage.
monsters: 96#
Controls how far in blocks monsters are tracked (sent to) the player. This is scaled by the entity-broadcast-range-percentage.
other: 64#
Controls how far in blocks other entities are tracked (sent to) the player. This is scaled by the entity-broadcast-range-percentage.
players: 128#
Controls how far in blocks players are tracked (sent to) the player. This is scaled by the entity-broadcast-range-percentage.
growth:
bamboo-modifier: 100#
The growth modifier percentage for bamboo, where Vanilla speed is 100%. This option is unable to disable growth at 0%, instead defaulting to 100% The maximum effectiveness is 300%.
beetroot-modifier: 100#
The growth modifier percentage for beetroot, where Vanilla speed is 100%. This option is unable to disable growth at 0%, instead defaulting to 100% The maximum effectiveness is 5100%.
cactus-modifier: 100#
The growth modifier percentage for cactus, where Vanilla speed is 100%. This option is unable to disable growth at 0, instead defaulting to 100% The maximum effectiveness is 1600%.
cane-modifier: 100#
The growth modifier percentage for sugarcane, where Vanilla speed is 100%. This option is unable to disable growth at 0%, instead defaulting to 100% The maximum effectiveness is 1600%.
carrot-modifier: 100#
The growth modifier percentage for carrots, where Vanilla speed is 100%. This option is unable to disable growth, instead defaulting to 100% The maximum effectiveness is 5100%.
cavevines-modifier: 100#
The growth modifier percentage for cave-vines, where Vanilla speed is 100%. This option is unable to disable growth, instead defaulting to 100% The maximum effectiveness is 1000%
cocoa-modifier: 100#
The growth modifier percentage for cocoa beans, where Vanilla speed is 100%. This option is unable to disable growth, instead defaulting to 100% The maximum effectiveness is 500%
glowberry-modifier: 100#
The growth modifier percentage for glow-berries, where Vanilla speed is 100%. This option is unable to disable growth, instead defaulting to 100% The maximum effectiveness is roughly 910%
kelp-modifier: 100#
The growth modifier percentage for kelp, where Vanilla speed is 100%. This option is unable to disable growth, instead defaulting to 100% The maximum effectiveness is roughly 715%
melon-modifier: 100#
The growth modifier percentage for melons, where Vanilla speed is 100%. This option is unable to disable growth, instead defaulting to 100% The maximum effectiveness is 5100%
mushroom-modifier: 100#
The growth modifier percentage for mushrooms, where Vanilla speed is 100%. This option is unable to disable growth, instead defaulting to 100% The maximum effectiveness is 2500%
netherwart-modifier: 100#
The growth modifier percentage for netherwart, where Vanilla speed is 100%. This option is unable to disable growth, instead defaulting to 100% The maximum effectiveness is 1000%
pitcherplant-modifier: 100#
The growth modifier percentage for pitcherplants, where Vanilla speed is 100%. This option is unable to disable growth, instead defaulting to 100% The maximum effectiveness is 5100%
potato-modifier: 100#
The growth modifier percentage for potatoes, where Vanilla speed is 100%. This option is unable to disable growth, instead defaulting to 100% The maximum effectiveness is 5100%
pumpkin-modifier: 100#
The growth modifier percentage for pumpkins, where Vanilla speed is 100%. This option is unable to disable growth, instead defaulting to 100% The maximum effectiveness is 5100%
sapling-modifier: 100#
The growth modifier percentage for saplings, where Vanilla speed is 100%. This option is unable to disable growth, instead defaulting to 100% The maximum effectiveness is 700%
sweetberry-modifier: 100#
The growth modifier percentage for sweet-berries, where Vanilla speed is 100%. This option is unable to disable growth, instead defaulting to 100% The maximum effectiveness is 500%
torchflower-modifier: 100#
The growth modifier percentage for torchflowers, where Vanilla speed is 100%. This option is unable to disable growth, instead defaulting to 100% The maximum effectiveness is 5100%
twistingvines-modifier: 100#
The growth modifier percentage for twisting-vines, where Vanilla speed is 100%. This option is unable to disable growth, instead defaulting to 100% The maximum effectiveness is 1000%
vine-modifier: 100#
The growth modifier percentage for vines, where Vanilla speed is 100%. This option is unable to disable growth, instead defaulting to 100% The maximum effectiveness is 400%
weepingvines-modifier: 100#
The growth modifier percentage for weeping-vines, where Vanilla speed is 100%. This option is unable to disable growth, instead defaulting to 100% The maximum effectiveness is 1000%
wheat-modifier: 100#
The growth modifier percentage for wheat, where Vanilla speed is 100%. This option is unable to disable growth, instead defaulting to 100% The maximum effectiveness is 5100%
hanging-tick-frequency: 100#
How often to tick hanging entities, in ticks.
hopper-amount: 1#
How many items a hopper should move at a time, limited to stack size.
hopper-can-load-chunks: false#
Whether to prevent hoppers from loading chunks.
hunger:
combat-exhaustion: 0.1#
How much exhaustion to give from attacking.
jump-sprint-exhaustion: 0.2#
How much exhaustion to give from sprint jumping.
jump-walk-exhaustion: 0.05#
How much exhaustion to give from jump walking.
other-multiplier: 0.0#
The exhaustion multiplier for normal walking and crouching.
regen-exhaustion: 6.0#
How much exhaustion to give from regenerating health.
sprint-multiplier: 0.1#
The exhaustion multiplier for sprinting on the ground.
swim-multiplier: 0.01#

The exhaustion multiplier for when “swimming”. This occurs when the player is:

  • actually swimming
  • walking underwater (eyes below surface)
  • walking on water (eyes above surface)
item-despawn-rate: 6000#
The default time in ticks it takes an item to despawn. Per-item rates are found in Paper’s per-world config.
max-tick-time:
entity: 50#
This option does not operate, and is non-functional upstream.
tile: 50#
This option does not operate, as it is disabled by a Paper patch.
max-tnt-per-tick: 100#
How many TNT to process per server tick. Set to 0 or less to disable.
merge-radius:
exp: -1#
The range, in blocks, that exp orbs will combine at on initial spawn. This behavior is not present in Vanilla and doesn’t impact the usual merge range once spawned. Set to 0 or less to disable.
item: 0.5#
The range, in blocks, that items will combine within.
mob-spawn-range: 8#
The range, in chunks, from the player, that mobs can spawn.
nerf-spawner-mobs: false#
Disable most AI for spawner spawned mobs.
seed-ancientcity: 20083232#
The per-structure seed for ancient cities.
seed-buriedtreasure: 10387320#
The per-structure seed for buried treasure.
seed-desert: 14357617#
The per-structure seed for desert structures.
seed-endcity: 10387313#
The per-structure seed for end cities.
seed-fossil: 14357921#
The per-structure seed for fossils.
seed-igloo: 14357618#
The per-structure seed for igloos.
seed-jungle: 14357619#
The per-structure seed for jungle structures.
seed-mansion: 10387319#
The per-structure seed for mansions.
seed-mineshaft: default#
The per-structure seed for mineshafts.
seed-monument: 10387313#
The per-structure seed for monuments.
seed-nether: 30084232#
The per-structure seed for the nether structures.
seed-ocean: 14357621#
The per-structure seed for the ocean structures.
seed-outpost: 165745296#
The per-structure seed for outposts.
seed-portal: 34222645#
The per-structure seed for portals.
seed-shipwreck: 165745295#
The per-structure seed for shipwrecks.
seed-slime: 987234911#
The per-structure seed for slime chunks.
seed-stronghold: default#
The per-structure seed for strongholds.
seed-swamp: 14357620#
The per-structure seed for swamp structures.
seed-trialchambers: 94251327#
The per-structure seed for trial chambers.
seed-trailruins: 83469867#
The per-structure seed for trail ruins.
seed-village: 10387312#
The per-structure seed for villages.
simulation-distance: default#
Overrides the simulation distance. Set to -1 or “default” to use the value in server.properties.
thunder-chance: 100000#
The chance of lightning occurring during a thunderstorm, as a probability of 1/ per chunk, every tick.
ticks-per:
hopper-check: 1#
The ticks between checks to pull items.
hopper-transfer: 8#
The ticks between hopper item movements.
trident-despawn-rate: 1200#
The number of ticks before a trident despawns.
verbose: false#
Whether to log world settings when the configuration file is loaded. This normally occurs on startup, `/spigot reload`, and `/reload`.
view-distance: default#
Overrides the view distance. Set to -1 or “default” to use the value in server.properties
wither-spawn-sound-radius: 0#
The number of blocks that the wither spawn sound is audible. Set to 0 for global (including cross-dimension).
zombie-aggressive-towards-villager: true#
Whether zombies try to seek out and attack villagers.
config-version: #
Internal constant for upgrading configuration: Do Not Touch.