Fill v2 has been deprecated on Dec.29, 2025. Fill v3 needs to be implemented, as this docker script will no longer pull new versions of the Paper server.

[kodyjbaker]

Legendary-Java-Minecraft-Geyser-Floodgate/start.sh

Line 157 in 7bde2e7

BuildJSON=$(curl --no-progress-meter -H "Accept-Encoding: identity" -H "Accept-Language: en" -L -A "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/90.0.4.212 Safari/537.36" https://api.papermc.io/v2/projects/paper/versions/$Version)

As per PaperMC's discord announcement on June 26, 2025 (https://discord.com/channels/289587909051416579/492517675680006144/1387884496212201742), the v2 API stopped receiving new builds on Dec.31, 2025.

The discord post outlines all the changes for v3.

Full copy/paste from their post:

Fill v3 — New Version of the Download Service
We've launched a new version of Fill, formerly known as Bibliothek — the download service powering our website, server panels, and various download scripts.

👥 Who Is Affected?
These changes primarily affect:
Server hosts
Tooling developers (e.g. launchers, pack installers, CI scripts)

If you're downloading from our website, you are not affected - and if you're using a server host, they will handle the migration for you.

🎁 What's New
🌏 New API Domain

The primary API domain has changed:
api.papermc.io ➜ fill.papermc.io

The old domain (api.papermc.io) will remain available for Fill v2 until it is sunset.
Fill v3 and the new GraphQL endpoint are only available via fill.papermc.io

Make sure to update your tooling and scripts accordingly.

🏷️ As seen with the release of Paper 1.21.6, we’ve started tracking select non-release versions of Minecraft. To support this, we’ve overhauled the build channel system:
ALPHA — Early, unstable builds
BETA — Feature-complete, may have bugs
STABLE — Production-ready builds
RECOMMENDED — Latest stable version recommended for general use
⚠️ Heads up: Some projects may not use all the available channels. The RECOMMENDED channel replaces the promoted status from v2, and is currently only used by Velocity.

📁 Download URLs are now embedded directly in API responses and point to our new domain: fill-data.papermc.io.
You no longer need to manually construct URLs — and we advise against doing so, as the format may change.

📜 We’ve also added new version-level metadata, especially useful for server hosts:
Support status (SUPPORTED, DEPRECATED, UNSUPPORTED)
Support end date (ISO-8601 format: YYYY-MM-DD)
Minimum required Java version
Recommended JVM flags

📘 API Documentation (Swagger)
You can explore the full Fill v3 REST API using our Swagger UI:
🔗 https://fill.papermc.io/swagger-ui/index.html

🔎 GraphQL Support
Fill now includes an optional GraphQL endpoint for advanced queries. Try it out here: https://fill.papermc.io/graphiql
⚠️ Heads up: GraphQL support is experimental and subject to change at any time.

🔨 Breaking Changes
🔁 Download key changes
Some download keys have changed in Fill v3 and GraphQL responses:
application -> server:default
mojang-mappings -> server:mojang

🔐 Required User-Agent Header
All requests must now include a valid User-Agent header that:
Clearly identifies your software or company
Is not generic (e.g. curl, wget, or similar defaults)
Includes a contact URL or email address (e.g. a homepage, bot info page, or support email)

Examples of valid headers:

mc-image-helper/1.39.11 (https://github.com/itzg/docker-minecraft-server)
nodecraft/packifier/1.0.0 (staff@nodecraft.com)

Requests without a valid User-Agent may be rejected or rate-limited.

[kodyjbaker]

I tried to create a fork with the needed changes. Not sure how to attach this open issue to the forked code pull request, but it's there.

[TheRemote]

Thank you for reporting this and making the patch, we have now upgraded to V3 thanks to you!