EN FR

CustomiZer — Hébergement du resource pack

Choisissez comment les joueurs téléchargent votre pack : le serveur web intégré de CustomiZer, ou le CDN mondial de LobFile.

← Retour à la doc
En une phrase : mettez resourcepack.hosting sur self et donnez un port libre à CustomiZer, ou mettez-le sur lobfile et collez une clé API — CustomiZer envoie le pack pour vous après chaque build.

Sommaire

Comment fonctionne l'hébergement Option 1 — serveur web intégré Option 2 — CDN LobFile Messages d'erreur LobFile Quand le pack ne se charge pas Options avancées

Comment fonctionne l'hébergement

CustomiZer génère un resource pack et envoie à chaque joueur un lien vers celui-ci. Il construit plusieurs variantes (une par dialecte de shader client, plus les variantes Feather et Lunar), et chaque variante pouvant être proposée à un joueur est hébergée. Le lieu de téléchargement tient en un seul réglage :

resourcepack:
  hosting: self      # ou : lobfile
ModeCe qui se passeIdéal pour
selfCustomiZer lance un petit serveur web sur votre machine et sert le pack depuis celui-ci.Les serveurs disposant d'un port libre qu'ils peuvent ouvrir.
lobfileCustomiZer envoie le pack sur LobFile et donne aux joueurs un lien CDN.Pas de port libre, bande passante limitée, ou joueurs éloignés du serveur.
Le serveur web intégré continue de tourner en mode lobfile. Si un envoi échoue, les joueurs reçoivent l'URL locale à la place, donc le pack fonctionne quand même.

Option 1 — serveur web intégré

CustomiZer a besoin de son propre port TCP, distinct du port Minecraft.

  1. 1Obtenez un second port. Sur un panel (Pterodactyl et similaires), ouvrez Network et ajoutez une allocation, par exemple 203.0.113.10:19114. Le port Minecraft reste le principal.
  2. 2Indiquez cette adresse et ce port dans plugins/CustomiZer/config.yml :
    resourcepack:
      hosting: self
      url: "http://203.0.113.10:19114"
      port: 19114
  3. 3Redémarrez, ou lancez /zpack zip.
Pourquoi url est important. Si url est vide, CustomiZer utilise l'adresse avec laquelle chaque joueur s'est connecté. Cela fonctionne sur les hébergeurs simples, mais derrière Docker ou un panel, l'IP du serveur est généralement une adresse interne inaccessible aux joueurs — CustomiZer n'annonce jamais une adresse privée, loopback ou CGNAT, et écrit un avertissement à la place. Définir url lève tout doute.

Option 2 — CDN LobFile

LobFile héberge le pack sur un CDN mondial. Aucun port supplémentaire, aucune bande passante consommée par votre serveur, et les joueurs téléchargent depuis un nœud proche.

  1. 1Créez un compte LobFile et activez-le depuis l'e-mail qu'ils envoient.
  2. 2Copiez votre clé API depuis le tableau de bord (Dashboard → Account Info).
  3. 3Activez Continuous Uploading dans Dashboard → Settings → General, pour qu'un compte plein ne bloque jamais un nouvel envoi.
    Continuous Uploading fait de la place en supprimant les fichiers les plus anciens du compte qui ne sont pas marqués comme favoris — y compris des fichiers que CustomiZer n'a jamais envoyés. Marquez comme favori ce que vous voulez garder, ou donnez à CustomiZer un compte dédié.
  4. 4Définissez le mode et la clé dans plugins/CustomiZer/config.yml :
    resourcepack:
      hosting: lobfile
      lobfile:
        api-key: "VOTRE_CLE_API"
  5. 5Redémarrez, ou lancez /zpack zip. La console affiche LobFile: N/N pack variant(s) uploaded.
La clé peut aussi venir de la variable d'environnement CUSTOMIZER_LOBFILE_API_KEY, ce qui la garde hors de config.yml. La variable d'environnement l'emporte si les deux sont définies. CustomiZer n'écrit jamais la clé dans les logs.

Ce que fait CustomiZer à chaque build

Messages d'erreur LobFile

Si un envoi échoue, CustomiZer écrit le message de LobFile directement dans la console, car la cause est généralement un point du compte que vous pouvez corriger vous-même :

[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.

Les messages de LobFile indiquent eux-mêmes quoi faire : activer le compte, corriger la clé API, libérer de l'espace ou des emplacements de fichiers, ou passer à une offre adaptée au pack. Suivez le message tel qu'il s'affiche ; cette page ne les recopie pas, car LobFile peut les reformuler ou en ajouter à tout moment.

Tant qu'un envoi n'a pas réussi, les joueurs reçoivent l'URL du serveur web intégré. Si url et port ne sont pas définis, ces joueurs n'obtiennent aucun pack : il vaut donc la peine de configurer les deux même en mode lobfile.

Quand le pack ne se charge pas

Mettez resourcepack.debug-status: true, reconnectez-vous, puis lisez les lignes [ResourcePack] :

LigneSignification
OFFER … url=…Le pack a été proposé. Vérifiez que l'URL est bien l'adresse publique.
[ResourcePack HTTP] GET … status=200Le client du joueur a atteint le serveur web.
CLIENT … SUCCESSFULLY_LOADEDLe pack est appliqué.

Options avancées

Elles se trouvent sous resourcepack.advanced et ne sont pas dans la configuration par défaut. Les valeurs par défaut conviennent à presque tous les serveurs. Les anciennes configurations qui gardent ces clés directement sous resourcepack: fonctionnent toujours.

CléDéfautUsage
bind-address0.0.0.0Interface locale sur laquelle le serveur web écoute.
server_threads4Threads du serveur web (1–64).
public-hostvideHôte public utilisé quand url est vide, au lieu de l'adresse de connexion.
public-port0Port public s'il diffère de port (NAT). 0 signifie identique.
public-protocolhttpUtilisez https uniquement derrière un reverse proxy qui termine le TLS.
download-retries1Nouvelles propositions après un échec de téléchargement (0–3). Les refus ne sont jamais réessayés.
retry-delay-ticks100Délai avant un nouvel essai.
auto-formattrueDétecte le format du pack depuis la version du serveur.
format / format-minor46 / 0Utilisés quand la version est inconnue ou que auto-format est désactivé.
Une URL de reverse proxy peut inclure un chemin, par exemple url: "https://packs.example.com/customizer".