Packs de contenu BetterStructures
BetterStructures gère désormais le contenu officiel sous forme de packs, au-delà de la seule importation manuelle.
Commandes principales
| Commande | Fonction |
|---|---|
/bs initialize | Flux de première configuration |
/bs setup | Parcourir et gérer l'état des paquets |
/bs downloadall | Télécharge la mise à jour du plugin (le cas échéant) et tout le contenu disponible, puis recharge |
/bs downloadallcontent | Télécharge uniquement tout le contenu disponible (sans mise à jour du plugin) |
/bs updatecontent | Met à jour le contenu obsolète (alias : /bs updateallcontent) |
/bs forcereinstallcontent <package|all> | Retélécharge le contenu même lorsque la version installée est déjà à jour - c'est la commande de réparation pour les packs endommagés ou partiellement supprimés |
/bs recommendedplugins | Liste les plugins compagnons qui s'associent bien à BetterStructures |
/nightbreaklogin <token> | Enregistrement partagé du token Nightbreak |
Les commandes de téléchargement et de mise à jour utilisent le système Nightbreak partagé de MagmaCore intégré à BetterStructures pour vérifier le jeton et l'accès, puis télécharger les fichiers. BetterStructures importe ensuite le contenu par son propre processus de rechargement.
Types de packs
Chaque paquet déclare un contentPackageType, et le menu de configuration propose un filtre par type :
contentPackageType | Filtre du menu de configuration | Les fichiers arrivent dans |
|---|---|---|
STRUCTURE (par défaut) | Packs de structures | plugins/BetterStructures/schematics/<folderNameV2> |
MODULAR | Packs de modules | plugins/BetterStructures/modules/<folderNameV2> |
Utilisez /bs setup pour filtrer et inspecter les paquets plutôt que de vous fier à d'anciennes listes statiques.
Champs de configuration des packs
Chaque paquet est décrit par une configuration dans plugins/BetterStructures/content_packages. Vous n'avez que rarement besoin de les modifier à la main - elles sont fournies avec le plugin et servent à suivre l'état des paquets - mais voici les champs :
| Clé | Par défaut | Description |
|---|---|---|
isEnabled | true | Indicateur d'installation du pack modifié par le menu. À false, rien de ce que contient le dossier du pack n'est chargé ; voir ci-dessous. |
name | — | Nom d'affichage montré dans le menu de configuration |
description | — | Lignes de description affichées dans le menu de configuration |
downloadLink | — | Lien de téléchargement manuel affiché si le pack n'a pas de nightbreakSlug ; les téléchargements gérés utilisent le slug |
version | 0 | Version locale du contenu, comparée à la version distante pour déterminer si le paquet est obsolète |
folderNameV2 | — | Sous-dossier dans lequel se trouvent les fichiers du paquet, sous schematics ou modules selon le type |
contentPackageType | STRUCTURE | STRUCTURE ou MODULAR |
nightbreakSlug | — | Identifiant Nightbreak utilisé pour les vérifications d'accès, les téléchargements, et comme sélecteur pour /bs forcereinstallcontent |
Installer ou désinstaller un pack depuis le menu de configuration modifie uniquement le isEnabled du pack, puis déclenche un rechargement. Les configurations de schematics et de modules contenues dans le pack ne sont pas modifiées. La désinstallation conserve les fichiers sur disque.
Tant qu'un pack a isEnabled: false, les chargeurs de schematics et de modules ignorent l'intégralité de son dossier, schematics/<folderNameV2> ou modules/<folderNameV2>, sous-dossiers compris. Cela s'applique aux packs STRUCTURE comme aux packs MODULAR. Dans un pack activé, chaque configuration de schematic et de module conserve son propre isEnabled.
Contenu des packs
Un pack BetterStructures est un zip dont le pack.meta déclare betterstructures. Un zip sans pack.meta placé dans plugins/BetterStructures/imports est traité de la même façon. Ses dossiers de premier niveau sont décompressés selon leur nom :
| Dossier dans le pack | Destination |
|---|---|
content_packages, schematics, modules, module_generators, generators, treasures, spawn_pools, components | Le dossier du même nom dans plugins/BetterStructures |
custombosses, customitems, customtreasurechests, powers, enchantments | Le dossier du même nom dans plugins/EliteMobs |
models ou modelengine | Le dossier des modèles de FreeMinecraftModels, ou le dossier blueprints de ModelEngine lorsque seul ModelEngine est installé |
scripts | plugins/FreeMinecraftModels/scripts |
freeminecraftmodels, elitemobs, betterstructures | La racine du dossier de données du plugin concerné, en conservant l'arborescence interne, par exemple freeminecraftmodels/enchantments |
worldcontainer | Le conteneur de mondes du serveur |
Un dossier de premier niveau absent de ce tableau fait rejeter l'intégralité du pack par l'importateur. Consultez Importations manuelles ou gestion en jeu pour les règles d'import communes.
Lorsqu'un pack ajoute du contenu EliteMobs, BetterStructures recharge EliteMobs après l'import. Lorsque le pack d'un autre plugin importe des fichiers dans le dossier de BetterStructures, BetterStructures lance un rechargement du contenu une fois son propre démarrage terminé.
États des packs
Selon le paquet et l'état de votre token, BetterStructures peut distinguer :
- le contenu installé
- le contenu téléchargé mais non activé
- le contenu obsolète
- le contenu nécessitant un accès Nightbreak
Le menu considère un pack comme téléchargé si son chemin existe, puis consulte son indicateur isEnabled pour déterminer s'il est installé. Il s'agit d'un état déclaré, pas d'un contrôle d'intégrité : un dossier vide ou endommagé peut encore apparaître comme installé. Utilisez /bs forcereinstallcontent <package|all> pour réparer les fichiers. all sélectionne les packs détectés comme téléchargés, installés ou obsolètes ; indiquez directement le slug si le dossier entier du pack manque.
Import manuel
Les imports manuels utilisent toujours :
plugins/BetterStructures/imports
Gardez les zips de paquets intacts, puis rechargez BetterStructures si nécessaire. L'import manuel est toujours pris en charge, mais ce n'est plus le flux de travail principal documenté.