Merge branch 'main' into feature/oversized-item-component-sanitizer-dont-sanitize

Author: Doc94

astro.config.ts

@@ -156,7 +156,7 @@ export default defineConfig({
                     },
                     {
                       label: "Miscellaneous",
-                      items: ["paper/misc/paper-bug-fixes", "paper/faq"],
+                      items: ["paper/misc/update-checker", "paper/misc/paper-bug-fixes", "paper/faq"],
                     },
                   ],
                 },

src/config/paper/paper-global.yml

@@ -364,11 +364,10 @@ packet-limiter:
           DROP which will ignore packets over the limit, and KICK which will kick
           players for exceeding the limit
       interval:
-        vanilla: "0.000001"
+        vanilla: "-1"
         default: "7.0"
         description: The interval, in seconds, for which max-packet-rate should apply
       max-packet-rate:
-        vanilla: "999999.0"
         default: "500.0"
         description: The number of packets allowed per player within the interval
 player-auto-save:
@@ -427,7 +426,7 @@ scoreboards:
       will incur a performance degradation
 spam-limiter:
   incoming-packet-threshold:
-    vanilla: "2147483647"
+    vanilla: "disabled"
     default: "300"
     description: >-
       Sets the threshold at which the server will consider incoming packets spam
@@ -535,6 +534,11 @@ unsupported-settings:
       This setting controls if equipment should be updated when handling certain player
       actions. If set to false this will allow players to exploit attributes by e.g.
       switching equipment before using it.
+update-checker:
+  enabled:
+    default: "true"
+    description: >-
+      Whether Paper should check for updates automatically on startup. See [here](/paper/misc/update-checker/) for more information.
 watchdog:
   early-warning-delay:
     default: "10000"

src/content/docs/paper/admin/misc/update-checker.md

@@ -0,0 +1,36 @@
+---
+title: Update checker
+description: Documentation for Paper's built-in automatic update checker.
+slug: paper/misc/update-checker
+---
+
+Since 1.21.11, Paper includes a built-in update checker that notifies server administrators on startup when a new version of Paper is available.
+
+## How it works
+
+When the server starts, Paper will check its current version against the latest available version in the stable channel on the PaperMC servers.
+If a newer version is found, a notification message will be printed to the console and server logs.
+
+Additionally, you can manually check for updates at any time by running the `version` command in the server console (or in-game with appropriate `minecraft.command.version` permissions).
+
+## What is sent
+
+The update checker sends the following information to the PaperMC servers:
+- Current Paper version
+- Your servers client IP (as for any http request)
+
+This information is not currently stored or analyzed by PaperMC, though requests pass through CloudFlare.
+
+## Configuration
+The update checker can be disabled in the `paper-global.yml` configuration file. The relevant section is as follows:
+
+```yaml title="config/paper-global.yml"
+update-checker:
+  enabled: false
+```
+
+Alternatively you can disable the update checker by adding the following JVM argument when starting your server:
+
+```bash
+-Dpaper.disableStartupVersionCheck
+```

src/content/docs/paper/admin/reference/system-properties.md

@@ -194,6 +194,11 @@ It also remaps plugin CB calls to remove the version information.
 - **default**: `false`
 - **description**: Allows you to bypass the Java version check. See [here](/paper/faq#unsupported-java-detected-what-do-i-do) for more info.
 
+#### paper.disableStartupVersionCheck
+
+- **default**: `unset`
+- **description**: If set, disables the automatic update checking on startup. See [here](/paper/misc/update-checker) for more info.
+
 #### paper.useLegacyPluginLoading
 
 - **default**: `false`

src/content/docs/paper/admin/reference/vanilla-command-permissions.md

@@ -106,6 +106,7 @@ The following is a list of permissions for Bukkit commands.
 | help    | /?           | bukkit.command.help    | Yes                                 |
 | plugins | /pl          | bukkit.command.plugins | Yes                                 |
 | reload  | /rl          | bukkit.command.reload  | No                                  |
+| restart |              | bukkit.command.restart | No                                  |
 | timings |              | bukkit.command.timings | No                                  |
 | version | /ver, /about | bukkit.command.version | Yes                                 |