Skip to content

Installation

natan307 edited this page Nov 16, 2026 · 1 revision

Installation

Important

You need an extra TCP port. Players do not receive the pack through the normal game connection. Minecraft downloads it over HTTP from a URL the server gives it, and PackLoader runs that small HTTP server on its own port (default 8163).

  • Use a different port than the Minecraft port. Never use 25565 (or whatever your game port is) - it is already taken by the game.
  • On a hosting panel, create an extra port / allocation and put that number in http.port.
  • If your host gives you only one port, the built-in server cannot be reached. Use a CDN instead.

Requirements

  • Minecraft 1.21 - 26.3 (tested). Paper recommended. Spigot works with limits, see Compatibility.
  • Java 21+ with the full runtime (module jdk.httpserver).
  • A free TCP port players can reach, or a CDN.

Steps

  1. Put PackLoader-<version>.jar in your server's plugins/ folder.

  2. Start the server. PackLoader creates plugins/PackLoader/:

    plugins/PackLoader/
    ├── config.yml
    ├── packs/       <- your resource packs (examples included on first run)
    ├── items/       <- custom item definitions
    ├── guis/        <- custom GUI definitions
    └── generated/   <- the built pack (do not edit)
    
  3. Edit config.yml:

    http:
      port: 8163                        # your extra port
      public-host: "play.example.com"   # your domain or public IP

    public-host is the address players use to reach your server: no http://, no port.

  4. Open the port (see below).

  5. Restart the server. A change of http.port only takes effect after a restart; /packloader reload is not enough.

  6. Run /packloader url and open the link in a browser on another network (for example mobile data). A zip file must download.

  7. Join the server and accept the resource pack prompt.

Choosing public-host

Situation Value
VPS or hosting with an IP/domain The public IP or domain, for example play.example.com
Server on your PC/phone, Minecraft on the same device 127.0.0.1
Same WiFi as the server The server's local IP, for example 192.168.1.5

Opening the port

  • Game hosting panel: create an extra port/allocation, set http.port to it, restart.
  • Own server / VPS: allow TCP on that port in the firewall (ufw allow 8163/tcp, cloud security group, etc.).
  • Home server: forward TCP on that port in your router.
  • Behind a reverse proxy (nginx, Cloudflare...): set http.public-host, http.public-port and http.public-https.

Make sure the protocol is TCP, not UDP.

Updating

Replace the jar and restart. Your config.yml, packs/, items/ and guis/ are kept. Config keys added in a newer version are not written into an existing file automatically (defaults are used). To see new keys, compare with the default config in Configuration.

First run examples

On the very first run PackLoader installs an example pack, example items and an example GUI. Delete packs/example, items/example.yml and guis/example.yml when you no longer need them. They are only installed when the packs/ folder does not exist yet.

Clone this wiki locally