Skip to content

Configuration

natan307 edited this page Nov 16, 2026 · 1 revision

Configuration

plugins/PackLoader/config.yml. Most values apply after /packloader reload. Exception: http.port and http.bind-address need a server restart.

http - built-in web server

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.

send - delivering the pack

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.

resource-pack

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.

upload

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.

optimize

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.

cdn

See CDN.

Full default file

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"

Clone this wiki locally