Aller au contenu principal

Installation de ResourcePackManager

Cette page couvre une configuration mono-serveur (autonome). Si vous exploitez un réseau BungeeCord / 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 les proxies Velocity / BungeeCord ; il détecte la plateforme à partir du chargeur utilisé. Il n'y a plus de fichiers resourcepackmanager-velocity-*.jar / resourcepackmanager-bungee-*.jar séparés à extraire. Si RSPM détecte un backend derrière un proxy sans clé réseau enregistrée ni issue de l'initialisation, il prépare une copie de son jar dans plugins/ResourcePackManager/proxy-extension/ResourcePackManager.jar à copier sur le proxy : le même fichier dans un emplacement 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+.

  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é)
    • l'hébergement gratuit de secours de MagmaGuy (activé par défaut)
    • 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.

Avec les réglages par défaut, RSPM essaie d'abord l'auto-hébergement vérifié, puis l'hébergement distant via magmaguy.com si la vérification échoue ou est indisponible. Si les deux voies automatiques échouent, aucune nouvelle URL de distribution ne peut être annoncée. Vérifiez l'état final et le téléchargement client avant de considérer l'installation comme terminée.

Un hébergement correctement établi produit une ligne de console telle que :

[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/Créé lorsqu'un backend derrière un proxy n'a pas de clé réseau enregistrée ni issue de l'initialisation. Contient une copie du ResourcePackManager.jar en cours d'exécution à placer sur le proxy. Un dossier conservé ne prouve pas que le backend reste non lié.
geyser-extension/Exporté lorsque l'installation automatique de l'extension est activée, que Floodgate est local et que Geyser-Spigot est absent. Suivez le chemin exact affiché dans la console, qui peut se trouver dans update/, pour copier le jar vers extensions/ du Geyser externe. L'export ne configure pas la distribution externe du pack.

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 applypluginupdate — enregistrée par l'ensemble de commandes partagées Nightbreak, mais RSPM la refuse toujours : ResourcePackManager updates need a server restart: its Geyser extension only loads when Geyser starts. Redémarrez le serveur pour appliquer une mise à jour téléchargée.
  • /rspm reload — relance l'initialisation du plugin et programme la préparation du pack ; un pack inchangé peut réutiliser son enregistrement d'hébergement existant
  • /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 applypluginupdate, /rspm reload, /rspm status, /rspm verbose, /rspm itemsadder <configure|dismiss> et /rspm data_compliance_request nécessitent resourcepackmanager.*.

ItemsAdder​

La procédure recommandée pour ItemsAdder n'est plus exclusivement manuelle.

Utilisez :

/rspm itemsadder configure

Cet assistant met à jour les paramètres ItemsAdder pertinents, demande la régénération du pack et attend que RSPM fusionne le nouvel export. 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)
  • exécute /iareload après 20 ticks serveur, puis /iazip encore 100 ticks plus tard
  • attend que le watchdog de RSPM détecte l'export ItemsAdder régénéré et termine la fusion, puis affiche RSPM merged the regenerated ItemsAdder export. Use /rspm status to check hosting. Si cette fusion échoue, il indique que l'export n'a pas pu être fusionné et RSPM réessaie.

L'assistant ne recharge pas ResourcePackManager. Il refuse de démarrer tant qu'une configuration précédente est encore en attente, et il s'arrête sans enregistrer si le config.yml d'ItemsAdder change pendant sa modification. Si ItemsAdder refuse /iareload ou /iazip, exécutez cette commande manuellement. Le message de fusion confirme la fusion, pas l'hébergement : vérifiez ensuite /rspm status et un téléchargement avec un vrai client.

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 peut convertir les ressources compatibles du pack Java fusionné en pack Bedrock pour GeyserMC. Il parcourt les définitions d'objets 1.21.4+ de tout plugin, dont les objets tenus en 3D et équipements pris en charge ; cela ne garantit pas la conversion de chaque nœud de modèle, prédicat ou conception d'armure. Consultez les limites dans le guide de conversion ci-dessous.

bedrockConversionEnabled vaut true par défaut. La conversion exige aussi la détection d'une cible Bedrock et des ressources source compatibles ; l'enregistrement au démarrage peut nécessiter le redémarrage de Geyser décrit ci-dessous.

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é localement et que geyserExtensionAutoInstall: true, RSPM installe ou prépare son jar universel dans plugins/Geyser-Spigot/extensions/. Redémarrez le serveur pour charger une extension nouvellement installée ou préparée. Les entités Bedrock personnalisées exigent aussi qu'un producteur compatible marque l'entité Java via le pont, des définitions enregistrées et le bon pack client. geyserExtensionAutoInstall: false empêche les installations et préparations futures ; il ne supprime pas un jar installé et n'annule pas une mise à jour déjà préparée. Voir Extension Geyser et entités personnalisées.

Voir Conversion Bedrock / Geyser pour le pipeline complet, les chemins de sortie et les poses des objets tenus en main.

Vérifier l'installation​

Pour une adresse de téléchargement publique en HTTPS, conservez l'hébergement automatique et définissez selfHostExternalUrl avec l'URL complète du pack exposée par votre proxy inverse. Consultez HTTPS et proxies inverses pour les réglages d'écoute et de transmission.

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

  • Métadonnées du plugin — version et mode de déploiement (autonome ou backend réseau). Sur un backend réseau, affiche aussi une courte empreinte non secrète de la clé et sa provenance : fournie par le proxy, enregistrée sur ce serveur, dérivée de la clé Floodgate ou pas encore définie.
  • Pack Java — fusionné oui/non, taille, préfixe SHA1
  • Pack Bedrock — converti oui/non, mappings présents, avec des indices de diagnostic si la conversion a été sautée
  • Hébergement — chemin de distribution actif (auto-hébergé / distant / pas encore prêt), URL présentée aux clients, hôte externe résolu, IP publique détectée, et résultat de la dernière vérification d'auto-hébergement avec la raison de son échec
  • Déploiement du proxy — rappelle que le jar du proxy est le même ResourcePackManager.jar ; sur un réseau, copiez-le dans le dossier plugins/ du proxy
  • Intégrations — détection de Floodgate / Geyser-Spigot, nombre de joueurs en ligne

Lorsque l'état indique une URL de distribution, connectez-vous avec un véritable client, acceptez le pack et inspectez un objet ou un modèle personnalisé connu. Sur Bedrock, reconnectez-vous après la reconstruction d'un pack et redémarrez Geyser lorsque de nouveaux mappings ou de nouvelles définitions d'entités doivent être enregistrés. L'état et les journaux d'hébergement décrivent la publication, pas le rendu côté client.

Si quelque chose semble incorrect, voir Dépannage.

Pour continuer​