Aller au contenu principal

Configuration de ResourcePackManager

Cette page couvre une configuration mono-serveur (autonome). Si vous exploitez un réseau BungeeCord / Waterfall / Velocity, suivez plutôt Réseaux proxy — vous installez le même ResourcePackManager.jar sur le proxy, mais il génère sa propre configuration et joue un rôle côté proxy.

ResourcePackManager 2.x est livré sous forme d'un jar universel unique. Le même ResourcePackManager.jar s'exécute sur les backends Bukkit/Paper et sur les proxies Velocity / BungeeCord / Waterfall — il détecte automatiquement la plateforme à partir du chargeur sous lequel il s'exécute. Il n'y a plus de fichiers resourcepackmanager-velocity-*.jar / resourcepackmanager-bungee-*.jar séparés ni de « proxy extension » groupée à extraire et copier quelque part.

Configuration recommandée (autonome)​

  1. Déposez ResourcePackManager.jar dans le dossier plugins/ de votre serveur. (C'est le même jar que vous utiliseriez sur un proxy Velocity / BungeeCord — il n'y a pas de jars proxy séparés.)
  2. Démarrez le serveur une fois afin que la configuration, le mixeur, le blueprint et les dossiers de sortie soient générés.
  3. Décidez si vous souhaitez :
    • l'auto-hébergement (par défaut, activé)
    • le repli sur l'auto-hébergement gratuit de MagmaGuy (par défaut, activé)
    • l'acceptation forcée côté client
    • des packs personnalisés manuels dans le dossier mixeur
  4. Exécutez /rspm reload après avoir modifié la configuration ou après avoir ajouté manuellement des packs personnalisés.

C'est tout pour le scénario nominal. Avec les paramètres par défaut, RSPM essaiera d'abord l'auto-hébergement et se repliera automatiquement sur le CDN de MagmaGuy si quelque chose ne va pas.

Commandes principales​

  • /rspm setup — ouvre un menu de configuration via une interface graphique en jeu (état de la mise à jour du plugin, plugins recommandés, une bascule des mises à jour automatiques, et un bouton d'info avec des liens cliquables vers le wiki, Discord et le jeton de votre compte Nightbreak)
  • /rspm reload — reconstruit et réhéberge le pack fusionné
  • /rspm status — affiche un vidage de diagnostic complet : état du pack, mode d'hébergement, clé réseau, intégrations
  • /rspm itemsadder configure — configure automatiquement ItemsAdder pour l'hébergement par RSPM (voir ci-dessous)
  • /rspm itemsadder dismiss — masque définitivement l'avertissement ItemsAdder pour votre UUID joueur
  • /rspm data_compliance_request — télécharge toutes les données stockées à distance pour ce serveur

La commande racine est /resourcepackmanager, avec /rspm comme alias. RSPM hérite également de quelques sous-commandes partagées MagmaCore/Nightbreak (par ex. /rspm recommendedplugins, /rspm downloadall) vers lesquelles pointe le menu de configuration.

Permissions :

  • /rspm setup nécessite resourcepackmanager.setup et est réservée aux joueurs (elle ouvre une interface graphique d'inventaire, elle ne peut donc pas être exécutée depuis la console).
  • /rspm reload, /rspm status, /rspm itemsadder <configure|dismiss> et /rspm data_compliance_request nécessitent toutes resourcepackmanager.*.

ItemsAdder​

Le chemin actuellement recommandé pour ItemsAdder n'est plus exclusivement manuel.

Utilisez :

/rspm itemsadder configure

Cet assistant met à jour les paramètres ItemsAdder pertinents, régénère le pack d'ItemsAdder, puis recharge ResourcePackManager. Plus précisément, il :

  • définit resource-pack.hosting.no-host.enabled: true
  • désactive protection_1, protection_2 et protection_3 dans resource-pack.zip.protect-file-from-unzip
  • définit resource-pack.zip.compress-json-files: false (RSPM a besoin d'un JSON de modèle non compressé et analysable pour le mixeur et le convertisseur Bedrock)
  • dispatche /iareload, puis /iazip
  • recharge ResourcePackManager environ 15 secondes plus tard, après qu'ItemsAdder a eu le temps de se recharger et de régénérer

Si ItemsAdder est déjà configuré pour héberger son propre pack (self-host, external-host ou lobfile), l'assistant s'arrête et vous indique de désactiver d'abord manuellement l'hébergement ItemsAdder.

Prise en charge Bedrock / GeyserMC​

RSPM convertit automatiquement le pack Java fusionné en pack Bedrock pour GeyserMC. La conversion gère le pack de définition d'items 1.21.4+ de n'importe quel plugin — pas seulement FreeMinecraftModels — incluant les items tenus en main en 3D, les armures personnalisées et les équipements modélisés.

bedrockConversionEnabled vaut true par défaut, donc une nouvelle installation sur un serveur disposant de GeyserMC fonctionnera directement.

Pour un serveur autonome, la conversion se déclenche lorsque l'une de ces conditions est vraie : Geyser-Spigot est installé sur ce serveur, Floodgate est installé sur ce serveur, ou RSPM a détecté le mode proxy (voir Réseaux proxy).

Voir Conversion Bedrock / Geyser pour le pipeline complet, les chemins de sortie et le réglage des décalages d'affichage.

Vérifier la configuration​

Exécutez /rspm status dans la console ou en tant qu'op. La sortie est divisée en sections :

  • Plugin meta — version + mode de déploiement (autonome vs network-backend)
  • Java Pack — fusionné oui/non, taille, préfixe SHA1
  • Bedrock Pack — converti oui/non, mappings présents, avec des indices de diagnostic si la conversion a été sautée
  • Hosting — quel chemin de distribution est actif (auto-hébergé / distant / pas encore prêt), l'URL que les clients verront, l'hôte externe résolu, l'IP publique auto-détectée
  • Proxy deployment — un rappel que le jar proxy réseau est le même ResourcePackManager.jar ; sur un réseau, copiez-le dans le dossier plugins/ du proxy
  • Integrations — détection de Floodgate / Geyser-Spigot, nombre de joueurs en ligne

Si quelque chose semble incorrect, voir Dépannage.

Où aller ensuite​