chore: cleanup config files

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"

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.
   <alias name>:
     default: "[<commands to run>]"
     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.

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,28 +200,27 @@ 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"
     description: >-
       Whether to remap Spigot mapped stacktraces to Mojang mappings in logging.
       Has no impact on Mojang mapped servers
 messages:
-  no-permission:
-    default: >-
-      <red>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: "<lang:multiplayer.disconnect.authservers_down>"
@@ -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: >-
+      <red>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"