From 2d10af267fb5c17e026cbb29348c5e112f9db045 Mon Sep 17 00:00:00 2001 From: MiniDigger | Martin Date: Fri, 2 Jan 2026 12:38:39 +0100 Subject: [PATCH 1/3] feat: document the update checker --- astro.config.ts | 2 +- src/config/paper/paper-global.yml | 5 +++ .../docs/paper/admin/misc/update-checker.md | 36 +++++++++++++++++++ .../admin/reference/system-properties.md | 5 +++ 4 files changed, 47 insertions(+), 1 deletion(-) create mode 100644 src/content/docs/paper/admin/misc/update-checker.md diff --git a/astro.config.ts b/astro.config.ts index b40d9f33a..c568f3646 100644 --- a/astro.config.ts +++ b/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"], }, ], }, diff --git a/src/config/paper/paper-global.yml b/src/config/paper/paper-global.yml index 3d7fbf9f8..962804622 100644 --- a/src/config/paper/paper-global.yml +++ b/src/config/paper/paper-global.yml @@ -527,6 +527,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" diff --git a/src/content/docs/paper/admin/misc/update-checker.md b/src/content/docs/paper/admin/misc/update-checker.md new file mode 100644 index 000000000..9e6e11c74 --- /dev/null +++ b/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 IP + +Currently none of that is stored or analyzed by PaperMC in any way, but it does go 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 +``` diff --git a/src/content/docs/paper/admin/reference/system-properties.md b/src/content/docs/paper/admin/reference/system-properties.md index 9475364d3..ebcbecbec 100644 --- a/src/content/docs/paper/admin/reference/system-properties.md +++ b/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` From d70a8a6f55518e1c26a0c7028b42c7ecc305a2a3 Mon Sep 17 00:00:00 2001 From: MiniDigger | Martin Date: Fri, 2 Jan 2026 12:56:41 +0100 Subject: [PATCH 2/3] Apply suggestions from code review Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- src/content/docs/paper/admin/misc/update-checker.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/src/content/docs/paper/admin/misc/update-checker.md b/src/content/docs/paper/admin/misc/update-checker.md index 9e6e11c74..0789d6e24 100644 --- a/src/content/docs/paper/admin/misc/update-checker.md +++ b/src/content/docs/paper/admin/misc/update-checker.md @@ -11,7 +11,7 @@ Since 1.21.11, Paper includes a built-in update checker that notifies server adm 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) +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 @@ -19,7 +19,7 @@ The update checker sends the following information to the PaperMC servers: - Current Paper version - Your IP -Currently none of that is stored or analyzed by PaperMC in any way, but it does go through CloudFlare. +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: From 1cc965cfc6dfa133d649617a7fa981cd831c1b21 Mon Sep 17 00:00:00 2001 From: MiniDigger | Martin Date: Fri, 2 Jan 2026 12:58:19 +0100 Subject: [PATCH 3/3] Update src/content/docs/paper/admin/misc/update-checker.md --- src/content/docs/paper/admin/misc/update-checker.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/paper/admin/misc/update-checker.md b/src/content/docs/paper/admin/misc/update-checker.md index 0789d6e24..3a1d9c007 100644 --- a/src/content/docs/paper/admin/misc/update-checker.md +++ b/src/content/docs/paper/admin/misc/update-checker.md @@ -17,7 +17,7 @@ Additionally, you can manually check for updates at any time by running the `ver The update checker sends the following information to the PaperMC servers: - Current Paper version -- Your IP +- Your servers client IP (as for any http request) This information is not currently stored or analyzed by PaperMC, though requests pass through CloudFlare.