Skip to content

Compatibility

natan307 edited this page Nov 16, 2026 · 1 revision

Compatibility

PackLoader runs on Minecraft 1.21 through 26.3 (tested by the author). It requires Java 21 or newer.

Minecraft versions

Version Status
1.20.x and older Not supported (the plugin requires 1.21 and Java 21)
1.21 - 26.3 Tested. Pack hosting, merging, upload, CDN, GUIs and blocks work
Newer than 26.3 Not tested yet

Feature note: custom item models (2D/3D items and blocks) use Minecraft's item definition files, which exist from 1.21.4. On 1.21 - 1.21.3 the plugin runs and hosts the pack, but generated items are shown without their custom model. Players need a 1.21.4+ client to see them.

Server software

Software Status
Paper Supported (main target)
Paper forks (Purpur, Pufferfish, Leaf...) Expected to work, not tested
Spigot / CraftBukkit Hosting, items and blocks work. GUI backgrounds do not (Adventure is needed and Spigot does not include it); GUIs still open and buttons work
Folia Not supported
Hybrid servers (Mohist, Arclight...), Fabric, Forge Not supported

Runtime

  • Java 21+, full runtime. The built-in web server uses jdk.httpserver; minimal runtimes without it cannot start the server.
  • Extra TCP port for the built-in server, or a CDN.
  • Proxies (Velocity, BungeeCord): fine. The pack is sent by the backend server that runs PackLoader; its HTTP port or CDN must be reachable by players.
  • Bedrock players (Geyser/Floodgate): Java resource packs do not apply to Bedrock clients.

Clients

Players need a Java Edition client that matches the server version. Version-translation plugins (ViaVersion and similar) can change how resource packs behave. Item definitions and 3D models need a 1.21.4+ client.

Reporting

Include the output of /packloader diag, the server software and exact version, and the startup log.

Clone this wiki locally