Choose how players download your pack: CustomiZer's built-in web server, or LobFile's global CDN.
resourcepack.hosting to self and give CustomiZer a spare port, or set it to lobfile and paste an API key — CustomiZer uploads the pack for you after every build.
CustomiZer builds one resource pack and sends each player a link to it. It builds several variants (one per client shader dialect, plus Feather and Lunar variants), and every variant a player can be offered is hosted. Where players download from is a single setting:
resourcepack:
hosting: self # or: lobfile
| Mode | What happens | Best for |
|---|---|---|
self | CustomiZer runs a small web server on your machine and serves the pack from it. | Servers with a spare port they can open. |
lobfile | CustomiZer uploads the pack to LobFile and sends players a CDN link. | No spare port, limited bandwidth, or players far from your server. |
lobfile mode. If an upload fails, players are offered the local URL instead, so the pack still works.CustomiZer needs its own TCP port, separate from the Minecraft port.
203.0.113.10:19114. The Minecraft port stays primary.plugins/CustomiZer/config.yml:
resourcepack:
hosting: self
url: "http://203.0.113.10:19114"
port: 19114
/zpack zip.url matters. With url empty, CustomiZer uses the address each player connected with. That works on simple hosts, but behind Docker or a panel the server's own IP is usually an internal address players cannot reach — CustomiZer never advertises a private, loopback or CGNAT address, and logs a warning instead. Setting url removes all doubt.LobFile hosts the pack on a global CDN. No extra port, no bandwidth used by your server, and players download from a nearby edge.
plugins/CustomiZer/config.yml:
resourcepack:
hosting: lobfile
lobfile:
api-key: "YOUR_API_KEY"
/zpack zip. The console shows LobFile: N/N pack variant(s) uploaded.CUSTOMIZER_LOBFILE_API_KEY environment variable, which keeps it out of config.yml. The environment variable wins when both are set. CustomiZer never writes the key to the log.plugins/CustomiZer/lobfile-uploads.yml.CustomiZer/<version> so LobFile support can help your players.If an upload fails, CustomiZer writes LobFile's own message straight to the console, because the cause is usually something on the account that you can fix yourself:
[CustomiZer] [ResourcePack] LobFile upload failed: HTTP 412 Not enough
storage space on your account, upgrade your plan or delete some files.
(hash=...); those players get the built-in web server URL instead.
LobFile's messages say what to do — activate the account, fix the API key, free up storage or file slots, or move to a plan that fits the pack. Act on the message as printed; this page does not copy them, since LobFile may reword or add to them at any time.
url and port are not set, those players get no pack at all, so it is worth configuring both even in lobfile mode.Set resourcepack.debug-status: true, rejoin, and read the [ResourcePack] lines:
| Line | Meaning |
|---|---|
OFFER … url=… | The pack was offered. Check the URL is the public address. |
[ResourcePack HTTP] GET … status=200 | The player's client reached the web server. |
CLIENT … SUCCESSFULLY_LOADED | The pack is applied. |
OFFER with no GET — the port is not reachable from outside: not allocated on the panel, blocked by a firewall, or url points at the wrong address.FAILED_DOWNLOAD after a GET — something between the player and the file changed it, usually a proxy or CDN in front of your own URL.No reachable public URL could be derived — url is empty and no usable join address was found. Set url.These live under resourcepack.advanced and are not in the default config. The defaults suit almost every server. Older configs that keep these keys directly under resourcepack: still work.
| Key | Default | Use |
|---|---|---|
bind-address | 0.0.0.0 | Local interface the web server listens on. |
server_threads | 4 | Web server threads (1–64). |
public-host | empty | Public host used when url is empty, instead of the join address. |
public-port | 0 | Public port when it differs from port (NAT). 0 means the same. |
public-protocol | http | Use https only behind a reverse proxy that terminates TLS. |
download-retries | 1 | Re-offers after a failed download (0–3). Declines are never retried. |
retry-delay-ticks | 100 | Delay before a retry. |
auto-format | true | Detect the pack format from the server version. |
format / format-minor | 46 / 0 | Used when the version is unknown or auto-format is off. |
url: "https://packs.example.com/customizer".