Repository navigation
Configuration
natan307 edited this page Nov 16, 2026
·
1 revision
plugins/PackLoader/config.yml. Most values apply after /packloader reload. Exception: http.port and http.bind-address need a server restart.
| Key | Default | Description |
|---|---|---|
bind-address |
0.0.0.0 |
Interface the server listens on. 0.0.0.0 = all. |
port |
8163 |
TCP port players download from. Restart required. |
public-host |
"" |
Domain or IP players use (no http://, no port). Strongly recommended. If empty PackLoader tries the hostname the player connected with (Paper), then server-ip, then a guessed local address. |
public-port |
0 |
Port written into the URL. 0 = same as port. Use when the external port differs (forwarding, proxy). |
public-https |
false |
Use https:// in the URL. Only when something in front of PackLoader provides HTTPS. |
PackLoader itself serves plain HTTP only.
| Key | Default | Description |
|---|---|---|
on-join |
true |
Send the pack when a player joins. |
delay-ticks |
20 |
Delay after join (20 ticks = 1 second). |
force |
false |
Required pack: players who decline are kicked by the client. |
prompt |
&aPlease accept... |
Text in the download prompt. Supports & and &#RRGGBB. |
| Key | Default | Description |
|---|---|---|
namespace |
packloader |
Namespace of generated files (assets/<namespace>/items/<id>.json) and of unqualified texture: / model: values in items/*.yml. Lowercase a-z 0-9 _ . -. |
description |
&bPackLoader resource pack |
Description in pack.mcmeta. |
pack-format |
0 |
0 = detect from server version. Set a number to override. |
You can also place your own pack.mcmeta and/or pack.png in plugins/PackLoader/ (next to config.yml). They are used as-is.
| Key | Default | Description |
|---|---|---|
enabled |
true |
Allow /packloader upload and the upload endpoint. |
max-size-mb |
200 |
Maximum uploaded zip size. |
token-expire-minutes |
15 |
Lifetime of an upload link. |
Upload links are plain HTTP and the token is part of the URL. Keep the expiry short, and use HTTPS in front of PackLoader if the server is exposed to untrusted networks. Set enabled: false if you do not use it.
| Key | Default | Description |
|---|---|---|
enabled |
true |
Minify JSON, recompress PNG data (lossless), zip level 9. |
strip-png-metadata |
true |
Also remove PNG metadata chunks (text, time, colour profile). Transparency is kept. |
Pixels are never changed. Files that cannot be optimized are included unchanged.
See CDN.
http:
bind-address: "0.0.0.0"
port: 8163
public-host: ""
public-port: 0
public-https: false
send:
on-join: true
delay-ticks: 20
force: false
prompt: "&aPlease accept the server resource pack"
resource-pack:
namespace: "packloader"
description: "&bPackLoader resource pack"
pack-format: 0
upload:
enabled: true
max-size-mb: 200
token-expire-minutes: 15
optimize:
enabled: true
strip-png-metadata: true
cdn:
mode: none
public-url: "https://cdn.example.com/packs/{file}"
upload-url: "https://storage.example.com/packs/{file}"
upload-method: PUT
upload-headers:
AccessKey: "your-storage-api-key"PackLoader by Natan/Ezra - All Rights Reserved - github.com/natan307
PackLoader
Features
Reference