diff --git a/src/config/paper/bukkit.yml b/src/config/paper/bukkit.yml index f30e17c19..71e06bec6 100644 --- a/src/config/paper/bukkit.yml +++ b/src/config/paper/bukkit.yml @@ -56,7 +56,6 @@ settings: description: >- Specifies the path to the folder where world files are saved. By default, this is the folder where the server JAR file is located. Note: Worlds must be manually moved to this folder for the server to recognize them. - spawn-limits: monsters: default: "70" diff --git a/src/config/paper/commands.yml b/src/config/paper/commands.yml index be5212c4f..337b0df4c 100644 --- a/src/config/paper/commands.yml +++ b/src/config/paper/commands.yml @@ -12,6 +12,10 @@ ignore-vanilla-permissions: default: "false" description: Whether to use Vanilla permission levels when executing commands. aliases: + icanhasbukkit: + default: "[version $1-]" + description: >- + A built-in alias. Set aliases to an empty list ([]) to persistently remove. : default: "[]" description: > @@ -30,8 +34,3 @@ aliases: Each alias registered cannot (easily) be overridden by a plugin. - icanhasbukkit: - default: "[version $1-]" - description: >- - A built-in alias. Set aliases to an empty list ([]) to persistently - remove. diff --git a/src/config/paper/paper-global.yml b/src/config/paper/paper-global.yml index 581128817..2f9002859 100644 --- a/src/config/paper/paper-global.yml +++ b/src/config/paper/paper-global.yml @@ -43,20 +43,6 @@ anticheat: description: >- Controls whether the item count of items with the model `minecraft:elytra` should be hidden from other players. block-updates: - disable-noteblock-updates: - default: "false" - description: >- - Whether to disable any form of block updates for note blocks on the - server. Disabling block updates leads to note blocks no longer updating - their block state, allowing for technically invalid note blocks to remain - in the world, which might be useful for mapmakers. - disable-tripwire-updates: - default: "false" - description: >- - Whether to disable any form of block updates for tripwires on the server. - Disabling block updates leads to tripwires no longer updating their block - state, allowing for technically invalid tripwires to remain in the world, - which might be useful for mapmakers. disable-chorus-plant-updates: default: "false" description: >- @@ -71,6 +57,20 @@ block-updates: server. Disabling block updates leads to mushroom blocks no longer updating their block state, allowing for technically invalid mushroom block configurations to remain in the world, which might be useful for mapmakers. + disable-noteblock-updates: + default: "false" + description: >- + Whether to disable any form of block updates for note blocks on the + server. Disabling block updates leads to note blocks no longer updating + their block state, allowing for technically invalid note blocks to remain + in the world, which might be useful for mapmakers. + disable-tripwire-updates: + default: "false" + description: >- + Whether to disable any form of block updates for tripwires on the server. + Disabling block updates leads to tripwires no longer updating their block + state, allowing for technically invalid tripwires to remain in the world, + which might be useful for mapmakers. chunk-loading-advanced: auto-config-send-distance: default: "true" @@ -173,20 +173,6 @@ console: default: "false" description: Whether the console command sender has all permissions item-validation: - display-name: - vanilla: "2147483647" - default: "8192" - description: The maximum length of an item's display name in characters - lore-line: - vanilla: "2147483647" - default: "8192" - description: The maximum length of a lore line in characters - resolve-selectors-in-books: - vanilla: "true" - default: "false" - description: >- - Whether to resolve selectors in books. With this enabled, players given - creative mode will be able to crash the server in yet another way book: author: vanilla: "2147483647" @@ -214,6 +200,20 @@ item-validation: Each page has this multiple of bytes from the last page as its contribution to the allowed byte total for a book (with the first page being having a multiplier of 1.0) + display-name: + vanilla: "2147483647" + default: "8192" + description: The maximum length of an item's display name in characters + lore-line: + vanilla: "2147483647" + default: "8192" + description: The maximum length of a lore line in characters + resolve-selectors-in-books: + vanilla: "true" + default: "false" + description: >- + Whether to resolve selectors in books. With this enabled, players given + creative mode will be able to crash the server in yet another way logging: deobfuscate-stacktraces: default: "true" @@ -221,21 +221,6 @@ logging: Whether to remap Spigot mapped stacktraces to Mojang mappings in logging. Has no impact on Mojang mapped servers messages: - no-permission: - default: >- - I'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: >- - Default message sent to players when they have insufficient permissions - for an action, formatted with - [MiniMessage](https://docs.advntr.dev/minimessage/). Plugins may override - this for their commands - use-display-name-in-quit-message: - default: "false" - description: >- - Whether the server should use the player's display name (set by plugins) - or actual name in quit messages kick: authentication-servers-down: default: "" @@ -259,14 +244,44 @@ messages: description: >- Message sent to players who are detected riding a flying vehicle. Formatted using [MiniMessage](https://docs.advntr.dev/minimessage/). + no-permission: + default: >- + I'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: >- + Default message sent to players when they have insufficient permissions + for an action, formatted with + [MiniMessage](https://docs.advntr.dev/minimessage/). Plugins may override + this for their commands + use-display-name-in-quit-message: + default: "false" + description: >- + Whether the server should use the player's display name (set by plugins) + or actual name in quit messages misc: - fix-entity-position-desync: - vanilla: "false" - default: "true" + chat-threads: + chat-executor-core-size: + default: "-1" + description: The minimum number of threads to keep in the chat thread pool + chat-executor-max-size: + default: "-1" + description: >- + The maximum number of threads to allow in the chat thread pool. The + default value is -1, which means no maximum + client-interaction-leniency-distance: + default: default description: >- - Causes the server to lose the same precision that the client does for - entities preventing desync. Fixes - [MC-4](https://bugs.mojang.com/browse/MC-4) + Defines the leniency distance added on the server to the interaction range of a + player when validating interact packets. + compression-level: + default: default + description: >- + A higher compression level means less data transmitted at the cost of more + CPU time. The default value is -1, which means that the server will use + the default value of the defined compressor. Note that Paper is currently + using the Velocity compressor, which uses a default compression level of 6 + as a middle ground between performance and data transmission. load-permissions-yml-before-plugins: default: "true" description: >- @@ -280,9 +295,23 @@ misc: tick. If more players join, they will be postponed until later ticks to join but not kicked. This is not related to connection throttling found in bukkit.yml + prevent-negative-villager-demand: + default: "false" + description: >- + Fixes MC-163962. Prevents the villager demand from going + negative, but may introduce parity issues with Vanilla. region-file-cache-size: default: "256" description: The maximum size of the region file cache + send-full-pos-for-item-entities: + default: "false" + description: Whether to send the full position for item entities + strict-advancement-dimension-check: + default: "false" + description: >- + Disables the attempts to translate worlds that use the same generation as + the Overworld, The Nether, or The End to general dimensions rather than + the specific dimension key of the world. use-alternative-luck-formula: default: "false" description: >- @@ -294,34 +323,6 @@ misc: description: >- Whether phantoms, wandering traders, etc. should be able to spawn in custom overworlds. Defaults to false in order to match Vanilla behavior - strict-advancement-dimension-check: - default: "false" - description: >- - Disables the attempts to translate worlds that use the same generation as - the Overworld, The Nether, or The End to general dimensions rather than - the specific dimension key of the world. - chat-threads: - chat-executor-core-size: - default: "-1" - description: The minimum number of threads to keep in the chat thread pool - chat-executor-max-size: - default: "-1" - description: >- - The maximum number of threads to allow in the chat thread pool. The - default value is -1, which means no maximum - client-interaction-leniency-distance: - default: default - description: >- - Defines the leniency distance added on the server to the interaction range of a - player when validating interact packets. - compression-level: - default: default - description: >- - A higher compression level means less data transmitted at the cost of more - CPU time. The default value is -1, which means that the server will use - the default value of the defined compressor. Note that Paper is currently - using the Velocity compressor, which uses a default compression level of 6 - as a middle ground between performance and data transmission. xp-orb-groups-per-area: default: default description: >- @@ -382,18 +383,18 @@ player-auto-save: How often player data should be saved in ticks. A value of -1 will use ticks-per.autosave in bukkit.yml proxies: - proxy-protocol: - default: "false" - description: >- - Whether the server should process [PROXY Protocol](https://www.haproxy.org/download/1.8/doc/proxy-protocol.txt) - messages. This is completely unrelated to Velocity or BungeeCord. Only - enable this if you are using HAProxy or similar bungee-cord: online-mode: default: "true" description: >- Instructs the server how to handle player UUIDs and data when behind BungeeCord. Always set to match your proxy's online-mode setting + proxy-protocol: + default: "false" + description: >- + Whether the server should process [PROXY Protocol](https://www.haproxy.org/download/1.8/doc/proxy-protocol.txt) + messages. This is completely unrelated to Velocity or BungeeCord. Only + enable this if you are using HAProxy or similar velocity: enabled: default: "false" @@ -451,45 +452,14 @@ spam-limiter: The number that the internal tab spam counter can reach until the server kicks the player for spam spark: - enabled: - default: "true" - description: Whether the bundled spark profiler should be enabled. enable-immediately: default: "false" description: >- Whether the bundled spark profiler should be enabled as soon as possible. This can be useful for profiling the server during startup. By default, spark is enabled once the server has finished starting up (when the **Done (X.XXXs)! For help, type "help"** message is sent in the console). -timings: enabled: - default: "false" - description: Controls the global enable state of Timings - hidden-config-entries: - default: "[database, proxies.velocity.secret]" - 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. This value is - validated server-side. Large reports will be rejected - server-name: - default: Unknown Server - description: Instructs Timings on what to put in for the server name - server-name-privacy: - default: "false" - description: Instructs Timings to hide server name information in reports - url: - default: "https://timings.aikar.co" - description: >- - Specifies the URL of the [Timings Viewer](https://github.com/aikar/timings) - server where Timings reports are sent - 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" + description: Whether the bundled spark profiler should be enabled. unsupported-settings: inline-docs-warning: color: red @@ -517,39 +487,39 @@ unsupported-settings: description: >- Whether to allow duplication of TNT, carpets, and rails. This does not control sand duplication - skip-vanilla-damage-tick-when-shield-blocked: + allow-unsafe-end-portal-teleportation: + vanilla: "true" default: "false" description: >- - Whether the server should skip damage ticks when entities are blocking damage - via a shield. While Vanilla does process a damage tick, this behavior was a long - standing bug in Paper. Enabling this option means that the damage tick will be - skipped, which may result in rapid damage on shields due to the missing invulnerability. - perform-username-validation: - vanilla: "false" - default: "true" - description: >- - Whether the server should validate usernames. While this may allow users - with special characters in their name to join, it can also cause issues - with commands and plugins + This setting allows for exploits related to end portal teleportation to be + possible, for example sand duplication. This + setting is not recommended to be enabled, but is provided for those who + wish to use it. compression-format: default: ZLIB description: >- Allows the server to customize the format of saved region files. This supports ZLIB, GZIP, LZ4 and NONE, where None namely allows for compression to be disabled - allow-unsafe-end-portal-teleportation: - vanilla: "true" - default: "false" + perform-username-validation: + vanilla: "false" + default: "true" description: >- - This setting allows for exploits related to end portal teleportation to be - possible, for example sand duplication. This - setting is not recommended to be enabled, but is provided for those who - wish to use it. + Whether the server should validate usernames. While this may allow users + with special characters in their name to join, it can also cause issues + with commands and plugins skip-tripwire-hook-placement-validation: vanilla: "true" default: "false" description: >- This setting allows for exploits related to tripwire hook duping to be enabled. + skip-vanilla-damage-tick-when-shield-blocked: + default: "false" + description: >- + Whether the server should skip damage ticks when entities are blocking damage + via a shield. While Vanilla does process a damage tick, this behavior was a long + standing bug in Paper. Enabling this option means that the damage tick will be + skipped, which may result in rapid damage on shields due to the missing invulnerability. update-equipment-on-player-actions: vanilla: "false" default: "true" diff --git a/src/config/paper/paper-world-defaults.yml b/src/config/paper/paper-world-defaults.yml index 8b469bd01..ee38bdcca 100644 --- a/src/config/paper/paper-world-defaults.yml +++ b/src/config/paper/paper-world-defaults.yml @@ -12,35 +12,6 @@ anticheat: replace both hidden-blocks and replacement-blocks with randomly generated hidden-blocks. Similarly to engine mode 2, mode 3 will replace each chunk layer with a random block from the hidden-blocks list. - max-block-height: - default: "64" - description: >- - Sets the maximum height (y coordinate, starting from the bottom of the - world) to which anti-xray will operate. Only integer multiples of 16 are - accepted. All other values will be rounded down. The [Minecraft Wiki - page about Ore](https://minecraft.wiki/w/Ore) may be helpful in - determining the best value for you - update-radius: - default: "2" - description: >- - Radius for block updates which will be sent containing real block data - when the client interacts with a block. Only values 0, 1, and 2 are - accepted. Values smaller than 0 will be rounded up to 0, while values - larger than 2 will be rounded down to 2. 0 is only designed for testing - purposes. Do not use it in production - lava-obscures: - default: "false" - description: >- - Whether to obfuscate blocks touching lava. Does not work well with - non-stone-like ore textures. This is because lava, while being mostly - opaque, does not cover blocks fully at the surface - use-permission: - default: "false" - description: >- - Whether to allow players with the paper.antixray.bypass permission to - bypass anti-xray. Checking this permission is disabled by default as - legacy permission plugins may struggle with the number of checks made. - This should only be used with modern permission plugins hidden-blocks: default: >- [copper_ore, deepslate_copper_ore, raw_copper_block, gold_ore, @@ -62,6 +33,20 @@ anticheat: engine-mode: 3 is very similar to 2, but these blocks will be randomly placed where each vertical chunk layer will take the same block from the list. + lava-obscures: + default: "false" + description: >- + Whether to obfuscate blocks touching lava. Does not work well with + non-stone-like ore textures. This is because lava, while being mostly + opaque, does not cover blocks fully at the surface + max-block-height: + default: "64" + description: >- + Sets the maximum height (y coordinate, starting from the bottom of the + world) to which anti-xray will operate. Only integer multiples of 16 are + accepted. All other values will be rounded down. The [Minecraft Wiki + page about Ore](https://minecraft.wiki/w/Ore) may be helpful in + determining the best value for you replacement-blocks: default: "[stone, oak_planks, deepslate]" description: >- @@ -76,6 +61,21 @@ anticheat: With engine-mode: 3, the behavior is the same as engine-mode: 2, but the replacement-blocks list is used to determine which blocks are used for each vertical chunk layer. + update-radius: + default: "2" + description: >- + Radius for block updates which will be sent containing real block data + when the client interacts with a block. Only values 0, 1, and 2 are + accepted. Values smaller than 0 will be rounded up to 0, while values + larger than 2 will be rounded down to 2. 0 is only designed for testing + purposes. Do not use it in production + use-permission: + default: "false" + description: >- + Whether to allow players with the paper.antixray.bypass permission to + bypass anti-xray. Checking this permission is disabled by default as + legacy permission plugins may struggle with the number of checks made. + This should only be used with modern permission plugins chunks: auto-save-interval: default: default @@ -108,6 +108,11 @@ chunks: this instance means static or unchanging. This is **not** fixing a bug. The timer is increased when chunks are kept loaded because of player activity + flush-regions-on-save: + default: "false" + description: >- + Sets whether the server will flush chunks to disk when they are saved. + This may have a performance impact max-auto-save-chunks-per-tick: vanilla: "200" default: "24" @@ -119,11 +124,6 @@ chunks: description: >- Sets whether the server will prevent players from moving into unloaded chunks or not - flush-regions-on-save: - default: "false" - description: >- - Sets whether the server will flush chunks to disk when they are saved. - This may have a performance impact collisions: allow-player-cramming-damage: vanilla: "true" @@ -153,13 +153,13 @@ collisions: default: "false" description: Only calculate collisions if a player is one of the two entities colliding command-blocks: - permissions-level: - default: "2" - description: "Default Vanilla permission level for command blocks." force-follow-perm-level: default: "true" description: "Require that command blocks meet both the Bukkit permission requirements and the Vanilla permission level. Otherwise, only 1 of those is required." + permissions-level: + default: "2" + description: "Default Vanilla permission level for command blocks." entities: armor-stands: do-collision-entity-lookups: @@ -170,18 +170,21 @@ entities: description: >- Disable to prevent armor stands from ticking. Can improve performance with many armor stands - markers: - tick: + behavior: + allow-spider-world-border-climbing: default: "true" description: >- - Disable to prevent markers from ticking. This may affect how they behave - as passengers of other entities - behavior: + Whether spiders should be able to climb on the world border, as if it + were a regular wall. baby-zombie-movement-modifier: default: "0.5" description: >- Modifies the speed that baby zombies move at, where 0.5 is 50% faster than the mob base speed, and -0.4 would be 40% slower + cooldown-failed-beehive-releases: + default: "true" + vanilla: "false" + description: Adds a cooldown to bees being released after a failed release, which can occur if the hive is blocked or it being night. disable-chest-cat-detection: default: "false" description: Allows you to open chests even if they have a cat sitting on top of them @@ -193,11 +196,6 @@ entities: description: >- Instructs the server to disable critical hits in PvP, treating them as normal hits instead - allow-spider-world-border-climbing: - default: "true" - description: >- - Whether spiders should be able to climb on the world border, as if it - were a regular wall. door-breaking-difficulty: vindicator: default: "[NORMAL, HARD]" @@ -220,18 +218,18 @@ entities: into a single orb. This is especially noticeable when defeating boss monsters mobs-can-always-pick-up-loot: - zombies: - default: "false" - description: >- - Instructs the server to allow zombies to pick up loot. If set to - false, the probability that a zombie picks up items depends on the - world's difficulty (Vanilla behavior) skeletons: default: "false" description: >- Instructs the server to allow skeletons to pick up loot. If set to false, the probability that a skeleton picks up items depends on the world's difficulty (Vanilla behavior) + zombies: + default: "false" + description: >- + Instructs the server to allow zombies to pick up loot. If set to + false, the probability that a zombie picks up items depends on the + world's difficulty (Vanilla behavior) nerf-pigmen-from-nether-portals: default: "false" description: "Removes AI from pigmen spawned via nether portals " @@ -254,11 +252,12 @@ entities: vanilla: "false" default: "true" description: "Prevents phantoms from attacking players who have slept " - player-insomnia-start-ticks: - default: "72000" - description: | - Number of ticks a player must stay awake before phantoms can start spawning. - Default (72000) is 3 Minecraft days, -1 disables phantom spawning. + phantoms-spawn-attempt-max-seconds: + default: "119" + description: Sets the maximum number of seconds between phantom spawn attempts + phantoms-spawn-attempt-min-seconds: + default: "60" + description: Sets the minimum number of seconds between phantom spawn attempts piglins-guard-chests: default: "true" description: If piglins should attempt to guard chests when angered @@ -283,6 +282,11 @@ entities: per-player: default: "false" description: Sets the start to be independent for each player + player-insomnia-start-ticks: + default: "72000" + description: | + Number of ticks a player must stay awake before phantoms can start spawning. + Default (72000) is 3 Minecraft days, -1 disables phantom spawning. should-remove-dragon: default: "false" description: Sets whether to remove the dragon if it exists without a portal @@ -304,19 +308,12 @@ entities: Sets whether zombies and zombified piglins should target turtle eggs. Setting this to false may help with performance, as they won't search for nearby eggs - phantoms-spawn-attempt-max-seconds: - default: "119" - description: Sets the maximum number of seconds between phantom spawn attempts - phantoms-spawn-attempt-min-seconds: - default: "60" - description: Sets the minimum number of seconds between phantom spawn attempts - cooldown-failed-beehive-releases: + markers: + tick: default: "true" - vanilla: "false" - description: Adds a cooldown to bees being released after a failed release, which can occur if the hive is blocked or it being night. - entities-target-with-follow-range: - default: "false" - description: "Sets whether the server should use follow range when targeting entities " + description: >- + Disable to prevent markers from ticking. This may affect how they behave + as passengers of other entities mob-effects: immune-to-wither-effect: default: "true" @@ -367,49 +364,6 @@ entities: description: >- The rate, in ticks, at which arrows shot from players in creative mode are despawned - ticks-per-spawn: - ambient: - default: "-1" - description: | - Determines how many ticks there are between attempts to spawn ambient mobs (bats). - Default (-1) uses - [bukkit.yml spawn rate](/paper/reference/bukkit-configuration#ticks_per_ambient_spawns). - axolotls: - default: "-1" - description: | - Determines how many ticks there are between attempts to spawn axolotls. - Default (-1) uses - [bukkit.yml spawn rate](/paper/reference/bukkit-configuration#ticks_per_axolotl_spawns). - creature: - default: "-1" - description: | - Determines how many ticks there are between attempts to spawn passive creatures (animals). - Default (-1) uses - [bukkit.yml spawn rate](/paper/reference/bukkit-configuration#ticks_per_animal_spawns). - monster: - default: "-1" - description: | - Determines how many ticks there are between attempts to spawn hostile monsters. - Default (-1) uses - [bukkit.yml spawn rate](/paper/reference/bukkit-configuration#ticks_per_monster_spawns). - underground_water_creature: - default: "-1" - description: | - Determines how many ticks there are between attempts to spawn underground water creatures (glow squid). - Default (-1) uses - [bukkit.yml spawn rate](/paper/reference/bukkit-configuration#ticks_per_water_underground_creature_spawns). - water_ambient: - default: "-1" - description: | - Determines how many ticks there are between attempts to spawn ambient water mobs (tropical fish). - Default (-1) uses - [bukkit.yml spawn rate](/paper/reference/bukkit-configuration#ticks_per_water_ambient_spawns). - water_creature: - default: "-1" - description: | - Determines how many ticks there are between attempts to spawn water creatures (squid, dolphins). - Default (-1) uses - [bukkit.yml spawn rate](/paper/reference/bukkit-configuration#ticks_per_water_spawns). despawn-range-shape: default: ELLIPSOID description: >- @@ -627,6 +581,49 @@ entities: except that it can be configured per world. A value of -1 will use the value in bukkit.yml + ticks-per-spawn: + ambient: + default: "-1" + description: | + Determines how many ticks there are between attempts to spawn ambient mobs (bats). + Default (-1) uses + [bukkit.yml spawn rate](/paper/reference/bukkit-configuration#ticks_per_ambient_spawns). + axolotls: + default: "-1" + description: | + Determines how many ticks there are between attempts to spawn axolotls. + Default (-1) uses + [bukkit.yml spawn rate](/paper/reference/bukkit-configuration#ticks_per_axolotl_spawns). + creature: + default: "-1" + description: | + Determines how many ticks there are between attempts to spawn passive creatures (animals). + Default (-1) uses + [bukkit.yml spawn rate](/paper/reference/bukkit-configuration#ticks_per_animal_spawns). + monster: + default: "-1" + description: | + Determines how many ticks there are between attempts to spawn hostile monsters. + Default (-1) uses + [bukkit.yml spawn rate](/paper/reference/bukkit-configuration#ticks_per_monster_spawns). + underground_water_creature: + default: "-1" + description: | + Determines how many ticks there are between attempts to spawn underground water creatures (glow squid). + Default (-1) uses + [bukkit.yml spawn rate](/paper/reference/bukkit-configuration#ticks_per_water_underground_creature_spawns). + water_ambient: + default: "-1" + description: | + Determines how many ticks there are between attempts to spawn ambient water mobs (tropical fish). + Default (-1) uses + [bukkit.yml spawn rate](/paper/reference/bukkit-configuration#ticks_per_water_ambient_spawns). + water_creature: + default: "-1" + description: | + Determines how many ticks there are between attempts to spawn water creatures (squid, dolphins). + Default (-1) uses + [bukkit.yml spawn rate](/paper/reference/bukkit-configuration#ticks_per_water_spawns). wandering-trader: spawn-chance-failure-increment: default: "25" @@ -659,11 +656,6 @@ entities: default value defers to Minecraft's default setting, which as of 1.12 is the sea level of the world (usually Y: 64) tracking-range-y: - enabled: - default: "false" - description: >- - Enables separate ranges for tracking ranges in the vertical (Y) - direction. animal: default: default description: >- @@ -674,26 +666,31 @@ entities: description: >- Controls how far vertically in blocks display entities are tracked (sent to) the player. - monster: - default: default - description: >- - Controls how far vertically in blocks monsters are tracked (sent to) the - player. - player: - default: default + enabled: + default: "false" description: >- - Controls how far vertically in blocks players are tracked (sent to) the - player. + Enables separate ranges for tracking ranges in the vertical (Y) + direction. misc: default: default description: >- Controls how far vertically in blocks miscellaneous are tracked (sent to) the player. + monster: + default: default + description: >- + Controls how far vertically in blocks monsters are tracked (sent to) the + player. other: default: default description: >- Controls how far vertically in blocks other entities are tracked (sent to) the player. + player: + default: default + description: >- + Controls how far vertically in blocks players are tracked (sent to) the + player. environment: disable-explosion-knockback: default: "false" @@ -708,11 +705,9 @@ environment: disable-thunder: default: "false" description: Disables thunderstorms - locate-structures-outside-world-border: - default: "false" - description: >- - If the server should be able to locate structures in chunks that are outside - the world border. + fire-tick-delay: + default: "30" + description: Sets the minimum delay between fire ticks frosted-ice: delay: max: @@ -727,6 +722,23 @@ environment: generate-flat-bedrock: default: "false" description: Instructs the server to generate bedrock as a single flat layer + locate-structures-outside-world-border: + default: "false" + description: >- + If the server should be able to locate structures in chunks that are outside + the world border. + max-block-ticks: + default: "65536" + description: >- + The maximum number of block ticks that can be processed in a single tick. + This is a safety measure to prevent the server from hanging when there is + a large amount of block updates. + max-fluid-ticks: + default: "65536" + description: >- + The maximum number of fluid ticks that can be processed in a single tick. + This is a safety measure to prevent the server from hanging when there is + a large number of fluid updates. nether-ceiling-void-damage-height: default: disabled description: >- @@ -786,21 +798,6 @@ environment: water-over-lava-flow-speed: default: "5" description: Sets the speed at which water flows while over lava - fire-tick-delay: - default: "30" - description: Sets the minimum delay between fire ticks - max-fluid-ticks: - default: "65536" - description: >- - The maximum number of fluid ticks that can be processed in a single tick. - This is a safety measure to prevent the server from hanging when there is - a large number of fluid updates. - max-block-ticks: - default: "65536" - description: >- - The maximum number of block ticks that can be processed in a single tick. - This is a safety measure to prevent the server from hanging when there is - a large amount of block updates. feature-seeds: generate-random-seeds-for-all: default: "false" @@ -956,6 +953,20 @@ misc: are placed on the portal frame before any attempt is made at respawning the ender dragon. Enabling this setting allows remote ender dragon respawning to work again. + alternate-current-update-order: + default: HORIZONTAL_FIRST_OUTWARD + description: >- + Controls the order in which Alternate Current updates wires and neighboring blocks. + Only has an effect when using the "ALTERNATE_CURRENT" redstone implementation. + This can be one of the following values: + + - **HORIZONTAL_FIRST_OUTWARD** + + - **HORIZONTAL_FIRST_INWARD** + + - **VERTICAL_FIRST_OUTWARD** + + - **VERTICAL_FIRST_INWARD** disable-end-credits: default: "false" description: >- @@ -1008,20 +1019,6 @@ misc: on the Mojira bug tracker give an overview of the Eigencraft implementation. - [Alternate Current](https://github.com/SpaceWalkerRS/alternate-current/blob/main/README.md) - alternate-current-update-order: - default: HORIZONTAL_FIRST_OUTWARD - description: >- - Controls the order in which Alternate Current updates wires and neighboring blocks. - Only has an effect when using the "ALTERNATE_CURRENT" redstone implementation. - This can be one of the following values: - - - **HORIZONTAL_FIRST_OUTWARD** - - - **HORIZONTAL_FIRST_INWARD** - - - **VERTICAL_FIRST_OUTWARD** - - - **VERTICAL_FIRST_INWARD** shield-blocking-delay: default: "5" description: >- @@ -1079,6 +1076,12 @@ tick-rates: Higher values than 1 can cause item desync/ghosting or make block breaking progress appear to reset randomly. It can also create visual artifacts mimicking server lag to clients, despite this not being the case. + dry-farmland: + default: "1" + description: | + Controls how frequently dry farmland blocks are ticked. + Higher values slow down the rate at which farmland checks for moisture updates. + Default (1) uses Vanilla behavior, -1 disables dry farmland random ticks. grass-spread: default: "1" description: >- @@ -1089,18 +1092,6 @@ tick-rates: description: >- How often mob spawners should tick to calculate available spawn areas and spawn new entities into the world. A value of -1 will disable all spawners - dry-farmland: - default: "1" - description: | - Controls how frequently dry farmland blocks are ticked. - Higher values slow down the rate at which farmland checks for moisture updates. - Default (1) uses Vanilla behavior, -1 disables dry farmland random ticks. - wet-farmland: - default: "1" - description: | - Controls how frequently wet farmland blocks are ticked. - Higher values slow down the rate at which farmland checks for moisture updates. - Default (1) uses Vanilla behavior, -1 disables wet farmland random ticks. sensor: villager: secondarypoisensor: @@ -1114,6 +1105,12 @@ tick-rates: description: >- Sets the sensor tick rate of an entity. -1 uses Vanilla. See timings for the names. Might change between updates! + wet-farmland: + default: "1" + description: | + Controls how frequently wet farmland blocks are ticked. + Higher values slow down the rate at which farmland checks for moisture updates. + Default (1) uses Vanilla behavior, -1 disables wet farmland random ticks. unsupported-settings: inline-docs-warning: color: red diff --git a/src/config/paper/spigot.yml b/src/config/paper/spigot.yml index 881f651f8..c61393989 100644 --- a/src/config/paper/spigot.yml +++ b/src/config/paper/spigot.yml @@ -1,3 +1,102 @@ +settings: + debug: + default: "false" + description: "Enables debug logging, by setting the log level to ALL." + save-user-cache-on-stop-only: + default: "false" + description: "If false, the server saves the user-cache on every update." + sample-count: + default: "12" + description: >- + How many players to display the names of in the player-count hover. The + selected players, and their positions in the list, are randomized. + timeout-time: + default: "60" + description: >- + 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. + restart-on-crash: + default: "true" + description: >- + 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: + default: ./start.sh + description: >- + 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](https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/start) + 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](https://man.archlinux.org/man/sh.1p#command_file)). + + + For more information on Spigot's restart system, read + [this](https://gist.github.com/Prof-Bloodstone/6367eb4016eaf9d1646a88772cdbbac5) + log-villager-deaths: + default: "true" + description: >- + Whether to log villager deaths and witch transformations to console and + latest.log + log-named-deaths: + default: "true" + description: >- + Whether to log deaths of entities with custom names to console and + latest.log + bungeecord: + default: "false" + description: |- + Whether to enable Bungeecord support, enabling: + - Receiving forwarded player-data and source ips. + - Support for binding to unix domain sockets. + attribute: + maxAbsorption: + max: + default: "2048.0" + description: Overrides the maximum for the maxAbsorption attribute. + maxHealth: + max: + default: "1024.0" + description: Overrides the maximum for the maxHealth attribute. + movementSpeed: + max: + default: "1024.0" + description: Overrides the maximum for the movementSpeed attribute. + attackDamage: + max: + default: "2048.0" + description: Overrides the maximum for the attackDamage attribute. + netty-threads: + default: "4" + description: Sets number of netty threads. + player-shuffle: + default: "0" + description: >- + 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. + user-cache-size: + default: "1000" + description: How many players to keep in the user cache. + moved-too-quickly-multiplier: + default: "10.0" + description: >- + Controls how fast a client can move in one packet. If triggered, the + server logs to console and prevents the move. + moved-wrongly-threshold: + default: "0.0625" + description: >- + 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. advancements: disable-saving: default: "false" @@ -21,46 +120,36 @@ advancements: if an advancement is disabled without all of it's children also being disabled console errors occur on load. -commands: - log: - default: "true" - description: >- - Whether to log commands executed by players, in chat or on signs. This - _currently_ logs in the format "\ issued server command: - \". - replace-commands: - default: "[setblock,summon,testforblock,tellraw]" - description: List of Vanilla commands that should override any plugin commands. - send-namespaced: - default: "true" - description: >- - Whether to send commands with a namespace (like minecraft:give) to the - client. - silent-commandblock-console: - default: "false" - description: Whether to log Vanilla command feedback to the Console. - enable-spam-exclusions: - default: "false" - description: Whether to apply spam exclusions from [`commands.spam-exclusions`](#commands_spam_exclusions). - spam-exclusions: - default: "[/skill]" +messages: + whitelist: + default: You are not whitelisted on this server! description: >- - Any chat message or command that prefix matches an entry in this list will - be excluded from the built-in spam filter. + The kick message for a player when: - Commands need a "/" to be counted as commands. - tab-complete: - default: "0" - description: >- - How many characters need to be typed before commands tab-complete. + - The player is unable to join as the whitelist is active. - - < 0: Tab-completion is disabled + - The player was kicked after they are removed from the whitelist, with + enforce-whitelist enabled. - - = 0: Always tab-complete all available commands + - The player was kicked after the whitelist enables, with + enforce-whitelist enabled - - \\> 0 only tab-complete commands after n characters are typed. This - behaves as 0 due to client changes. -messages: + + The message is formatted with legacy "&" style formatting, and "\\n" for + newlines. + unknown-command: + default: Unknown command. Type "/help" for help. + description: >- + NOTE: This setting no longer has any effect. The functionality should instead + be replaced by a plugin. + server-full: + default: The server is full! + description: >- + 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. outdated-client: default: "Outdated client! Please use {0}" description: >- @@ -85,198 +174,183 @@ messages: The message is formatted with legacy "&" style formatting, and "\\n" for newlines. - server-full: - default: The server is full! - description: >- - 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: - default: Unknown command. Type "/help" for help. - description: >- - 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: - default: You are not whitelisted on this server! - description: >- - 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: - default: "false" - description: Prevents saving player data. -settings: - attribute: - attackDamage: - max: - default: "2048.0" - description: Overrides the maximum for the attackDamage attribute. - maxAbsorption: - max: - default: "2048.0" - description: Overrides the maximum for the maxAbsorption attribute. - maxHealth: - max: - default: "1024.0" - description: Overrides the maximum for the maxHealth attribute. - movementSpeed: - max: - default: "1024.0" - description: Overrides the maximum for the movementSpeed attribute. - bungeecord: - default: "false" - description: |- - Whether to enable Bungeecord support, enabling: - - Receiving forwarded player-data and source ips. - - Support for binding to unix domain sockets. - debug: - default: "false" - description: "Enables debug logging, by setting the log level to ALL." - log-named-deaths: - default: "true" - description: >- - Whether to log deaths of entities with custom names to console and - latest.log - log-villager-deaths: - default: "true" - description: >- - Whether to log villager deaths and witch transformations to console and - latest.log - moved-too-quickly-multiplier: - default: "10.0" - description: >- - Controls how fast a client can move in one packet. If triggered, the - server logs to console and prevents the move. - moved-wrongly-threshold: - default: "0.0625" - description: >- - 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: - default: "4" - description: Sets number of netty threads. - player-shuffle: - default: "0" - description: >- - 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: - default: "true" - description: >- - 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: - default: ./start.sh - description: >- - 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](https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/start) - 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](https://man.archlinux.org/man/sh.1p#command_file)). - - - For more information on Spigot's restart system, read - [this](https://gist.github.com/Prof-Bloodstone/6367eb4016eaf9d1646a88772cdbbac5) - sample-count: - default: "12" - description: >- - 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: - default: "false" - description: "If false, the server saves the user-cache on every update." - timeout-time: - default: "60" - description: >- - 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: - default: "1000" - description: How many players to keep in the user cache. -stats: - disable-saving: - default: "false" - description: Whether to prevent saving stats. - forced-stats: - default: "{}" - description: >- - An Object, where: - - - The Keys inside are any "Resource location" from [The Minecraft - Wiki](https://minecraft.wiki/w/Statistics#List_of_custom_statistic_names). - - - The Value for each key is an integer to force the related stat to. world-settings: default: - unload-frozen-chunks: - default: "false" - description: Experimental option that controls whether chunks can unload whilst ticks are frozen via /tick freeze. - arrow-despawn-rate: - default: "1200" - description: The number of ticks before an arrow despawns. below-zero-generation-in-existing-chunks: default: "true" description: >- Whether to allow conversion of existing chunks to full (post 1.18) height. - dragon-death-sound-radius: - default: "0" - description: >- - The number of blocks that the dragon death sound is audible. Set to 0 - for global (including cross-dimension). + merge-radius: + exp: + default: "-1" + description: >- + 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: + default: "0.5" + description: "The range, in blocks, that items will combine within." + ticks-per: + hopper-check: + default: "1" + description: The ticks between checks to pull items. + hopper-transfer: + default: "8" + description: The ticks between hopper item movements. + hopper-amount: + default: "1" + description: "How many items a hopper should move at a time, limited to stack size." + hopper-can-load-chunks: + default: "false" + description: Whether to prevent hoppers from loading chunks. + hunger: + combat-exhaustion: + default: "0.1" + description: How much exhaustion to give from attacking. + jump-sprint-exhaustion: + default: "0.2" + description: How much exhaustion to give from sprint jumping. + jump-walk-exhaustion: + default: "0.05" + description: How much exhaustion to give from jump walking. + other-multiplier: + default: "0.0" + description: The exhaustion multiplier for normal walking and crouching. + regen-exhaustion: + default: "6.0" + description: How much exhaustion to give from regenerating health. + sprint-multiplier: + default: "0.1" + description: The exhaustion multiplier for sprinting on the ground. + swim-multiplier: + default: "0.01" + description: >- + 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) enable-zombie-pigmen-portal-spawns: default: "true" description: >- Whether to allow zombified piglins to spawn inside nether portals. This setting does not affect portal travel for any mobs. + zombie-aggressive-towards-villager: + default: "true" + description: Whether zombies try to seek out and attack villagers. + dragon-death-sound-radius: + default: "0" + description: >- + The number of blocks that the dragon death sound is audible. Set to 0 + for global (including cross-dimension). This setting has no effect if + the gamerule globalSoundEvents is set to true, which is the default. end-portal-sound-radius: default: "0" description: >- - The number of blocks that the end portal opening sound is audible. Set - to 0 for global (including cross-dimension). + The number of blocks that the end portal opening sound is audible. Set + to 0 for global (including cross-dimension). This setting has no effect if + the gamerule globalSoundEvents is set to true, which is the default. + hanging-tick-frequency: + default: "100" + description: "How often to tick hanging entities, in ticks." + wither-spawn-sound-radius: + default: "0" + description: >- + The number of blocks that the wither spawn sound is audible. Set to 0 + for global (including cross-dimension). This setting has no effect if + the gamerule globalSoundEvents is set to true, which is the default. + item-despawn-rate: + default: "6000" + description: >- + The default time in ticks it takes an item to despawn. Per-item rates + are found in Paper's [per-world + config](/paper/reference/world-configuration#entities_spawning_alt_item_despawn_rate). + mob-spawn-range: + default: "8" + description: "The range, in chunks, from the player, that mobs can spawn." + arrow-despawn-rate: + default: "1200" + description: The number of ticks before an arrow despawns. + trident-despawn-rate: + default: "1200" + description: The number of ticks before a trident despawns. + seed-village: + default: "10387312" + description: The per-structure seed for villages. + seed-desert: + default: "14357617" + description: The per-structure seed for desert structures. + seed-igloo: + default: "14357618" + description: The per-structure seed for igloos. + seed-jungle: + default: "14357619" + description: The per-structure seed for jungle structures. + seed-swamp: + default: "14357620" + description: The per-structure seed for swamp structures. + seed-monument: + default: "10387313" + description: The per-structure seed for monuments. + seed-shipwreck: + default: "165745295" + description: The per-structure seed for shipwrecks. + seed-ocean: + default: "14357621" + description: The per-structure seed for the ocean structures. + seed-outpost: + default: "165745296" + description: The per-structure seed for outposts. + seed-endcity: + default: "10387313" + description: The per-structure seed for end cities. + seed-slime: + default: "987234911" + description: The per-structure seed for slime chunks. + seed-nether: + default: "30084232" + description: The per-structure seed for the nether structures. + seed-mansion: + default: "10387319" + description: The per-structure seed for mansions. + seed-fossil: + default: "14357921" + description: The per-structure seed for fossils. + seed-portal: + default: "34222645" + description: The per-structure seed for portals. + seed-ancientcity: + default: "20083232" + description: The per-structure seed for ancient cities. + seed-trailruins: + default: "83469867" + description: The per-structure seed for trail ruins. + seed-trialchambers: + default: "94251327" + description: The per-structure seed for trial chambers. + seed-buriedtreasure: + default: "10387320" + description: The per-structure seed for buried treasure. + seed-mineshaft: + default: default + description: The per-structure seed for mineshafts. + seed-stronghold: + default: default + description: The per-structure seed for strongholds. + thunder-chance: + default: "100000" + description: >- + The chance of lightning occurring during a thunderstorm, as a + probability of 1/\ per chunk, every tick. entity-activation-range: animals: vanilla: "0" default: "32" description: The entity activation range for animals. - flying-monsters: - vanilla: "0" - default: "32" - description: The entity activation range for flying monsters. - ignore-spectators: - default: "false" - description: Whether spectators activate entities within range. - misc: - vanilla: "0" - default: "16" - description: The entity activation range for misc entities. monsters: vanilla: "0" default: "32" @@ -285,28 +359,22 @@ world-settings: vanilla: "0" default: "64" description: The entity activation range for raiders. - tick-inactive-villagers: - default: "true" - description: >- - Whether to keep ticking villagers that are outside of their activation - range. + misc: + vanilla: "0" + default: "16" + description: The entity activation range for misc entities. + water: + vanilla: "0" + default: "16" + description: The entity activation range for water mobs. villagers: vanilla: "0" default: "32" description: The entity activation range for villagers. - villagers-active-for-panic: - default: "true" - description: Whether to activate villagers when they want to panic. - villagers-work-immunity-after: - default: "100" - description: >- - The time in ticks a villager has to be inactive and working to be - woken up. - villagers-work-immunity-for: - default: "20" - description: >- - How long a villager should be woken up for, in ticks, after - villagers-work-immunity-after. + flying-monsters: + vanilla: "0" + default: "32" + description: The entity activation range for flying monsters. wake-up-inactive: animals-every: default: "1200" @@ -364,22 +432,51 @@ world-settings: description: >- A limit of how many inactive villagers can be woken up on the same tick. - water: - vanilla: "0" - default: "16" - description: The entity activation range for water mobs. + villagers-work-immunity-after: + default: "100" + description: >- + The time in ticks a villager has to be inactive and working to be + woken up. + villagers-work-immunity-for: + default: "20" + description: >- + How long a villager should be woken up for, in ticks, after + villagers-work-immunity-after. + villagers-active-for-panic: + default: "true" + description: Whether to activate villagers when they want to panic. + tick-inactive-villagers: + default: "true" + description: >- + Whether to keep ticking villagers that are outside of their activation + range. + ignore-spectators: + default: "false" + description: Whether spectators activate entities within range. + nerf-spawner-mobs: + default: "false" + description: Disable most AI for spawner spawned mobs. + unload-frozen-chunks: + default: "false" + description: Experimental option that controls whether chunks can unload whilst ticks are frozen via /tick freeze. entity-tracking-range: + players: + default: "128" + description: >- + Controls how far in blocks players are tracked (sent to) the player. + This is scaled by the + [entity-broadcast-range-percentage](/paper/reference/server-properties#entity_broadcast_range_percentage). animals: default: "96" description: >- Controls how far in blocks animals are tracked (sent to) the player. This is scaled by the [entity-broadcast-range-percentage](/paper/reference/server-properties#entity_broadcast_range_percentage). - display: - default: "128" + monsters: + default: "96" description: >- - Controls how far in blocks display entities are tracked (sent to) the - player. This is scaled by the + Controls how far in blocks monsters are tracked (sent to) the player. + This is scaled by the [entity-broadcast-range-percentage](/paper/reference/server-properties#entity_broadcast_range_percentage). misc: default: "96" @@ -387,11 +484,11 @@ world-settings: Controls how far in blocks misc entities are tracked (sent to) the player. This is scaled by the [entity-broadcast-range-percentage](/paper/reference/server-properties#entity_broadcast_range_percentage). - monsters: - default: "96" + display: + default: "128" description: >- - Controls how far in blocks monsters are tracked (sent to) the player. - This is scaled by the + Controls how far in blocks display entities are tracked (sent to) the + player. This is scaled by the [entity-broadcast-range-percentage](/paper/reference/server-properties#entity_broadcast_range_percentage). other: default: "64" @@ -399,29 +496,7 @@ world-settings: Controls how far in blocks other entities are tracked (sent to) the player. This is scaled by the [entity-broadcast-range-percentage](/paper/reference/server-properties#entity_broadcast_range_percentage). - players: - default: "128" - description: >- - Controls how far in blocks players are tracked (sent to) the player. - This is scaled by the - [entity-broadcast-range-percentage](/paper/reference/server-properties#entity_broadcast_range_percentage). growth: - bamboo-modifier: - default: "100" - description: >- - 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: - default: "100" - description: >- - 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: default: "100" description: >- @@ -438,101 +513,108 @@ world-settings: defaulting to 100% The maximum effectiveness is 1600%. - carrot-modifier: + melon-modifier: default: "100" description: >- - The growth modifier percentage for carrots, where Vanilla speed is + 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%. - cavevines-modifier: + The maximum effectiveness is 5100% + mushroom-modifier: default: "100" description: >- - The growth modifier percentage for cave-vines, where Vanilla speed is + 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 1000% - cocoa-modifier: + The maximum effectiveness is 2500% + pumpkin-modifier: default: "100" description: >- - The growth modifier percentage for cocoa beans, where Vanilla speed is + 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 500% - glowberry-modifier: - default: "100" - description: >- - 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: + The maximum effectiveness is 5100% + sapling-modifier: default: "100" description: >- - The growth modifier percentage for kelp, where Vanilla speed is 100%. - This option is unable to disable growth, instead defaulting to 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 roughly 715% - melon-modifier: + The maximum effectiveness is 700% + beetroot-modifier: default: "100" description: >- - The growth modifier percentage for melons, where Vanilla speed is - 100%. This option is unable to disable growth, instead defaulting to - 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% - mushroom-modifier: + The maximum effectiveness is 5100%. + carrot-modifier: default: "100" description: >- - The growth modifier percentage for mushrooms, where Vanilla speed is + 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 2500% - netherwart-modifier: + The maximum effectiveness is 5100%. + potato-modifier: default: "100" description: >- - The growth modifier percentage for netherwart, where Vanilla speed is + 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 1000% - pitcherplant-modifier: + The maximum effectiveness is 5100% + torchflower-modifier: default: "100" description: >- - The growth modifier percentage for pitcherplants, where Vanilla speed + 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% - potato-modifier: + wheat-modifier: default: "100" description: >- - The growth modifier percentage for potatoes, where Vanilla speed is - 100%. This option is unable to disable growth, instead defaulting to - 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% - pumpkin-modifier: + netherwart-modifier: default: "100" description: >- - The growth modifier percentage for pumpkins, where Vanilla speed is + 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 5100% - sapling-modifier: + The maximum effectiveness is 1000% + vine-modifier: default: "100" description: >- - The growth modifier percentage for saplings, where Vanilla speed is + 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% + cocoa-modifier: + default: "100" + description: >- + 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 700% + The maximum effectiveness is 500% + bamboo-modifier: + default: "100" + description: >- + 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%. sweetberry-modifier: default: "100" description: >- @@ -541,14 +623,13 @@ world-settings: to 100% The maximum effectiveness is 500% - torchflower-modifier: + kelp-modifier: default: "100" description: >- - The growth modifier percentage for torchflowers, where Vanilla speed - is 100%. This option is unable to disable growth, instead defaulting - to 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 5100% + The maximum effectiveness is roughly 715% twistingvines-modifier: default: "100" description: >- @@ -557,13 +638,6 @@ world-settings: to 100% The maximum effectiveness is 1000% - vine-modifier: - default: "100" - description: >- - 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: default: "100" description: >- @@ -572,187 +646,111 @@ world-settings: to 100% The maximum effectiveness is 1000% - wheat-modifier: + cavevines-modifier: default: "100" description: >- - The growth modifier percentage for wheat, where Vanilla speed is 100%. - This option is unable to disable growth, instead defaulting to 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 5100% - hanging-tick-frequency: - default: "100" - description: "How often to tick hanging entities, in ticks." - hopper-amount: - default: "1" - description: "How many items a hopper should move at a time, limited to stack size." - hopper-can-load-chunks: - default: "false" - description: Whether to prevent hoppers from loading chunks. - hunger: - combat-exhaustion: - default: "0.1" - description: How much exhaustion to give from attacking. - jump-sprint-exhaustion: - default: "0.2" - description: How much exhaustion to give from sprint jumping. - jump-walk-exhaustion: - default: "0.05" - description: How much exhaustion to give from jump walking. - other-multiplier: - default: "0.0" - description: The exhaustion multiplier for normal walking and crouching. - regen-exhaustion: - default: "6.0" - description: How much exhaustion to give from regenerating health. - sprint-multiplier: - default: "0.1" - description: The exhaustion multiplier for sprinting on the ground. - swim-multiplier: - default: "0.01" + The maximum effectiveness is 1000% + glowberry-modifier: + default: "100" description: >- - The exhaustion multiplier for when "swimming". This occurs when the - player is: - - - actually swimming + The growth modifier percentage for glow-berries, where Vanilla speed + is 100%. This option is unable to disable growth, instead defaulting + to 100% - - walking underwater (eyes below surface) + The maximum effectiveness is roughly 910% + pitcherplant-modifier: + default: "100" + description: >- + The growth modifier percentage for pitcherplants, where Vanilla speed + is 100%. This option is unable to disable growth, instead defaulting + to 100% - - walking on water (eyes above surface) - item-despawn-rate: - default: "6000" - description: >- - The default time in ticks it takes an item to despawn. Per-item rates - are found in Paper's [per-world - config](/paper/reference/world-configuration#entities_spawning_alt_item_despawn_rate). + The maximum effectiveness is 5100% max-tick-time: - entity: - default: "50" - description: "This option does not operate, and is non-functional upstream." tile: default: "50" description: "This option does not operate, as it is disabled by a Paper patch." + entity: + default: "50" + description: "This option does not operate, and is non-functional upstream." max-tnt-per-tick: vanilla: "-1" default: "100" description: How many TNT to process per server tick. Set to 0 or less to disable. - merge-radius: - exp: - default: "-1" - description: >- - 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: - default: "0.5" - description: "The range, in blocks, that items will combine within." - mob-spawn-range: - default: "8" - description: "The range, in chunks, from the player, that mobs can spawn." - nerf-spawner-mobs: - default: "false" - description: Disable most AI for spawner spawned mobs. - seed-ancientcity: - default: "20083232" - description: The per-structure seed for ancient cities. - seed-buriedtreasure: - default: "10387320" - description: The per-structure seed for buried treasure. - seed-desert: - default: "14357617" - description: The per-structure seed for desert structures. - seed-endcity: - default: "10387313" - description: The per-structure seed for end cities. - seed-fossil: - default: "14357921" - description: The per-structure seed for fossils. - seed-igloo: - default: "14357618" - description: The per-structure seed for igloos. - seed-jungle: - default: "14357619" - description: The per-structure seed for jungle structures. - seed-mansion: - default: "10387319" - description: The per-structure seed for mansions. - seed-mineshaft: - default: default - description: The per-structure seed for mineshafts. - seed-monument: - default: "10387313" - description: The per-structure seed for monuments. - seed-nether: - default: "30084232" - description: The per-structure seed for the nether structures. - seed-ocean: - default: "14357621" - description: The per-structure seed for the ocean structures. - seed-outpost: - default: "165745296" - description: The per-structure seed for outposts. - seed-portal: - default: "34222645" - description: The per-structure seed for portals. - seed-shipwreck: - default: "165745295" - description: The per-structure seed for shipwrecks. - seed-slime: - default: "987234911" - description: The per-structure seed for slime chunks. - seed-stronghold: + view-distance: default: default - description: The per-structure seed for strongholds. - seed-swamp: - default: "14357620" - description: The per-structure seed for swamp structures. - seed-trialchambers: - default: "94251327" - description: The per-structure seed for trial chambers. - seed-trailruins: - default: "83469867" - description: The per-structure seed for trail ruins. - seed-village: - default: "10387312" - description: The per-structure seed for villages. + description: >- + Overrides the view distance. Set to -1 or "default" to use the value in + [server.properties](/paper/reference/server-properties#view_distance) simulation-distance: default: default description: >- Overrides the simulation distance. Set to -1 or "default" to use the value in [server.properties](/paper/reference/server-properties#simulation_distance). - thunder-chance: - default: "100000" - description: >- - The chance of lightning occurring during a thunderstorm, as a - probability of 1/\ per chunk, every tick. - ticks-per: - hopper-check: - default: "1" - description: The ticks between checks to pull items. - hopper-transfer: - default: "8" - description: The ticks between hopper item movements. - trident-despawn-rate: - default: "1200" - description: The number of ticks before a trident despawns. verbose: default: "false" description: >- Whether to log world settings when the configuration file is loaded. This normally occurs on startup, \`/spigot reload\`, and \`/reload\`. - view-distance: - default: default - description: >- - Overrides the view distance. Set to -1 or "default" to use the value in - [server.properties](/paper/reference/server-properties#view_distance) - wither-spawn-sound-radius: - default: "0" - description: >- - The number of blocks that the wither spawn sound is audible. Set to 0 - for global (including cross-dimension). - zombie-aggressive-towards-villager: - default: "true" - description: Whether zombies try to seek out and attack villagers. +players: + disable-saving: + default: "false" + description: Prevents saving player data. config-version: default: "" description: "Internal constant for upgrading configuration: **Do Not Touch**." +stats: + disable-saving: + default: "false" + description: Whether to prevent saving stats. + forced-stats: + default: "{}" + description: >- + An Object, where: + + - The Keys inside are any "Resource location" from [The Minecraft + Wiki](https://minecraft.wiki/w/Statistics#List_of_custom_statistic_names). + + - The Value for each key is an integer to force the related stat to. +commands: + tab-complete: + default: "0" + description: >- + 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. + send-namespaced: + default: "true" + description: >- + Whether to send commands with a namespace (like minecraft:give) to the + client. + log: + default: "true" + description: >- + Whether to log commands executed by players, in chat or on signs. This + _currently_ logs in the format "\ issued server command: + \". + replace-commands: + default: "[setblock,summon,testforblock,tellraw]" + description: List of Vanilla commands that should override any plugin commands. + spam-exclusions: + default: "[/skill]" + description: >- + 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. + silent-commandblock-console: + default: "false" + description: Whether to log Vanilla command feedback to the Console. + enable-spam-exclusions: + default: "false" + description: Whether to apply spam exclusions from [`commands.spam-exclusions`](#commands_spam_exclusions).