Importations manuelles vs gestion en jeu

Les plugins gérés par Nightbreak préfèrent désormais la configuration et la gestion de contenu en jeu, mais les importations manuelles existent toujours comme solution de secours.

Recommandé : Gestion en jeu

Utilisez le menu de configuration avec un token Nightbreak lié lorsque vous souhaitez :

• une exploration de contenu avec prise en compte des accès
• une installation en un clic ou guidée par menu
• des commandes de téléchargement et de mise à jour en masse
• des vérifications automatiques des paquets obsolètes
• un flux de travail correspondant à la base de code actuelle

C'est le chemin préféré pour :

• EliteMobs
• BetterStructures
• FreeMinecraftModels
• EternalTD
• ResurrectionChest
• WorldCannon

Ces six plugins utilisent tous l'importeur partagé : ils acceptent donc également la solution de secours manuelle décrite ci-dessous.

Solution de secours : Importations manuelles

Les importations manuelles sont toujours utiles lorsque :

• vous avez déjà les fichiers zip des paquets téléchargés
• vous déplacez des fichiers entre serveurs
• vous souhaitez travailler hors ligne de Nightbreak pendant les tests
• un paquet est intentionnellement distribué en dehors du chemin de téléchargement en jeu

Les téléchargements en masse Nightbreak atterrissent également dans le dossier imports du plugin. La différence est que le chemin en jeu gère les vérifications d'accès et l'étape de téléchargement pour vous.

Carte des dossiers d'importation

Plugin	Dossier d'importation
EliteMobs	plugins/EliteMobs/imports
BetterStructures	plugins/BetterStructures/imports
FreeMinecraftModels	plugins/FreeMinecraftModels/imports
EternalTD	plugins/EternalTD/imports
ResurrectionChest	plugins/ResurrectionChest/imports
WorldCannon	plugins/CannonRTP/imports

Le dossier de plugin de WorldCannon s'appelle CannonRTP — c'est le nom interne du plugin, et c'est là que se trouvent à la fois son dossier imports et le contenu installé.

Règles d'importation manuelle

• Gardez le paquet téléchargé compressé sauf si la documentation spécifique au plugin indique le contraire.
• Placez le paquet dans le bon dossier imports.
• Rechargez ou redémarrez le plugin si la documentation spécifique au plugin l'exige.
• Rouvrez le menu de configuration ensuite pour confirmer l'état d'installation.

L'importeur partagé peut traiter :

• les paquets .zip placés dans imports
• certains dossiers déjà décompressés s'ils incluent pack.meta
• les fichiers .bbmodel pour FreeMinecraftModels

Les archives sont extraites dans un dossier de préparation caché à l'intérieur d'imports et ne sont installées que depuis là. FMM nettoie ce dossier de préparation après un succès comme après un échec : les échecs d'importation normaux laissent donc le zip d'origine prêt pour une nouvelle tentative plutôt qu'un paquet à moitié extrait visible à côté.

Ce que l'importeur accepte

pack.meta détermine où va le contenu

Un paquet peut livrer un fichier pack.meta au niveau supérieur nommant la plateforme de plugin qu'il cible — elitemobs, betterstructures, freeminecraftmodels, eternaltd, extractioncraft, resurrectionchest, megablocksurvivors ou worldcannon (également accepté sous cannonrtp ou world_cannon). Ce nom est comparé sans tenir compte de la casse, et les espaces environnants, les fins de ligne et une marque d'ordre des octets en tête sont ignorés : un fichier enregistré par un éditeur Windows fonctionne donc parfaitement.

Si l'archive n'a pas de pack.meta, elle est traitée comme un paquet destiné au plugin dans le dossier imports duquel elle a été déposée.

Si pack.meta nomme quelque chose que l'importeur ne connaît pas, le paquet est rejeté et le zip est laissé dans imports afin que vous puissiez le corriger et réessayer.

Les noms des dossiers de premier niveau doivent être reconnus

L'importeur achemine chaque dossier de premier niveau du paquet vers une destination d'après son nom. Certains noms fonctionnent pour toutes les plateformes :

Dossier	Destination
worldcontainer	Le conteneur de mondes du serveur (chaque sous-dossier devient un monde)
models ou modelengine	Le dossier des modèles de FreeMinecraftModels, ou le dossier des blueprints de ModelEngine si seul ModelEngine est installé
scripts	plugins/FreeMinecraftModels/scripts
pack.meta	Ignoré — ce sont des métadonnées, pas du contenu

Tout le reste est résolu par plateforme (par exemple custombosses, customitems et content_packages pour EliteMobs ; schematics, spawn_pools et components pour BetterStructures).

Un dossier de premier niveau que l'importeur ne reconnaît pas pour cette plateforme entraîne le rejet du paquet entier plutôt qu'une installation partielle, et l'archive est conservée. Si votre paquet refuse de s'importer, la console nomme le dossier fautif.

Les imports échoués sont annulés

Un import est appliqué comme une seule transaction. Les fichiers existants sont sauvegardés avant d'être remplacés, les dossiers de monde remplacés sont mis de côté plutôt que supprimés, et tout échec en cours de route déclenche la restauration de chaque destination touchée par le paquet. Le zip reste dans imports, une nouvelle tentative est donc sans risque. Si la restauration elle-même rencontre une erreur du système de fichiers, la console signale explicitement que la restauration est incomplète et vous invite à inspecter les destinations enregistrées avant de réessayer.

L'archive n'est supprimée qu'une fois l'import entièrement validé. Si vous voyez un paquet toujours présent dans imports après un rechargement, c'est l'importeur qui vous indique qu'il ne l'a pas installé — consultez la console pour en connaître la raison.

Différences importantes

Chemin en jeu

• avec prise en compte du token
• peut afficher le contenu verrouillé et obsolète
• se recharge généralement automatiquement après les opérations en masse
• reflète le flux de travail administratif actuellement prévu

Chemin manuel

• fonctionne sans accès au téléchargement en jeu
• nécessite que vous gériez les fichiers zip vous-même
• peut nécessiter un rechargement du plugin
• peut laisser du contenu dans un état téléchargé-mais-non-activé selon le plugin
• peut exposer des problèmes de structure de paquet que le chemin d'accès en jeu cacherait normalement jusqu'au moment de l'installation