Repository navigation
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.
- 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.
-
Put
PackLoader-<version>.jarin your server'splugins/folder. -
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) -
Edit
config.yml:http: port: 8163 # your extra port public-host: "play.example.com" # your domain or public IP
public-hostis the address players use to reach your server: nohttp://, no port. -
Open the port (see below).
-
Restart the server. A change of
http.portonly takes effect after a restart;/packloader reloadis not enough. -
Run
/packloader urland open the link in a browser on another network (for example mobile data). A zip file must download. -
Join the server and accept the resource pack prompt.
| 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
|
-
Game hosting panel: create an extra port/allocation, set
http.portto 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-portandhttp.public-https.
Make sure the protocol is TCP, not UDP.
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.
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.
PackLoader by Natan/Ezra - All Rights Reserved - github.com/natan307
PackLoader
Features
Reference