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 à extraire. (Si RSPM détecte que ce backend se trouve derrière un proxy qui ne lui a jamais fourni de clé, il prépare pour vous une copie de son propre jar dans plugins/ResourcePackManager/proxy-extension/ResourcePackManager.jar à copier sur le proxy — le même fichier, simplement placé à un endroit pratique.)

Le descripteur du plugin backend déclare l'API Bukkit 1.21.4, donc le serveur Bukkit/Paper doit être en Minecraft 1.21.4 ou plus récent. L'extension Geyser d'entités personnalisées embarquée cible Geyser 2.11+.

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.

Vous saurez que cela a fonctionné grâce à une unique ligne de console :

[ResourcePackManager] Resource pack is live via self-hosting — http://play.example.com:25566/rspm.zip

RSPM garde la console silencieuse volontairement — il rapporte le résultat, pas chaque étape, et il n'avertit pas des conditions dont il se remet tout seul (une sonde d'auto-hébergement échouée suivie d'un repli réussi est un succès, pas une erreur). Si quelque chose nécessite un diagnostic, exécutez /rspm verbose on (ou définissez verboseLogging: true dans config.yml) et rechargez. Voir Dépannage.

Dossiers générés par RSPM​

Sous plugins/ResourcePackManager/ :

DossierÀ quoi il sert
mixer/Déposez ici des packs .zip finis pour les fusionner. Référencez-les dans priorityOrder par leur nom de fichier exact, extension .zip comprise.
resource_pack/Déposez ici un pack décompressé (une arborescence de dossiers avec assets/, pack.mcmeta, ...). RSPM le zippe et le fusionne sous l'entrée de priorité ResourcePackManager, qui se trouve en tête du priorityOrder par défaut.
blueprint/Contient les pack.png et pack.mcmeta par défaut que RSPM apporte à la fusion. Modifiez-les pour changer l'icône du pack fusionné ou la description de son pack.mcmeta ; le dossier est re-zippé dans blueprint.zip à chaque démarrage.
output/Les artefacts finis : ResourcePackManager_RSP.zip, plus ResourcePackManager_Bedrock.zip et rspm_geyser_mappings.json lorsque la conversion Bedrock les a produits.
compatible_plugins/Un YAML par intégration de plugin prise en charge.
data_compliance/L'endroit où /rspm data_compliance_request écrit son téléchargement.
proxy-extension/N'apparaît que sur un backend situé derrière un proxy qui ne lui a jamais fourni de clé. Contient une copie du ResourcePackManager.jar en cours d'exécution à placer sur le proxy.
geyser-extension/N'apparaît que lorsque Floodgate est local mais que Geyser est un processus externe. Contient une copie du jar à placer dans le dossier extensions/ de ce Geyser.

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 recommendedplugins — affiche le menu partagé Nightbreak des plugins recommandés
  • /rspm downloadpluginupdate — télécharge une mise à jour disponible de ResourcePackManager pour le prochain redémarrage
  • /rspm downloadall — télécharge toutes les mises à jour disponibles exposées par ce plugin (actuellement la mise à jour de ResourcePackManager)
  • /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, empreinte de la clé réseau, intégrations
  • /rspm verbose [on|off] — active ou désactive la journalisation de diagnostic détaillée sans ouvrir config.yml. Sans argument, elle bascule l'état. Le choix est réécrit dans verboseLogging dans config.yml, il survit donc aux redémarrages. Alias : /rspm verboselogging.
  • /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. Les commandes de mise à jour et de plugins recommandés ci-dessus sont des commandes partagées MagmaCore/Nightbreak enregistrées par RSPM.

Permissions :

  • /rspm setup et /rspm recommendedplugins nécessitent resourcepackmanager.setup. /rspm setup est réservée aux joueurs car elle ouvre une interface graphique d'inventaire.
  • /rspm downloadpluginupdate, /rspm downloadall, /rspm reload, /rspm status, /rspm verbose, /rspm itemsadder <configure|dismiss> et /rspm data_compliance_request nécessitent 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).

Si Geyser-Spigot est installé sur ce serveur, RSPM s'installe également lui-même dans plugins/Geyser-Spigot/extensions/ en tant qu'extension Geyser, ce qui est précisément ce qui permet aux entités Bedrock personnalisées de s'afficher au lieu de porte-armures. C'est le même ResourcePackManager.jar — rien de plus à télécharger — mais un redémarrage du serveur est nécessaire pour qu'il prenne effet. Définissez geyserExtensionAutoInstall: false dans config.yml pour empêcher RSPM d'installer et de préparer cette extension. Voir Extension Geyser et entités personnalisées.

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). Sur un backend en réseau, elle affiche également une courte empreinte non secrète de la clé réseau et la provenance de cette clé (provided by the proxy / saved on this server / adopted from Floodgate's key / not set yet).
  • 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​