Installation de BetterStructures

BetterStructures accepte toujours les imports manuels, mais la procédure recommandée passe par Nightbreak, en jeu.

Prérequis

• Prise en charge des schématiques compatible WorldEdit ou FAWE
• Environnement Java 21 pour les versions actuelles

Procédure recommandée

1. Installez BetterStructures et WorldEdit, puis démarrez le serveur une fois.
2. Exécutez /bs initialize.
3. Liez un token Nightbreak avec /nightbreaklogin <token>.
4. Ouvrez /bs setup pour parcourir les packs de structures et les packs de modules.
5. Utilisez /bs downloadall pour un démarrage rapide (il récupère une mise à jour du plugin en attente ainsi que tout le contenu).
6. Utilisez /bs updatecontent lorsque des mises à jour de paquets sont disponibles.

Le menu de première installation

/bs initialize ouvre un petit menu guidé. Tant qu'aucune de ses options n'a été choisie, chaque joueur disposant de betterstructures.* reçoit un message de rappel dix secondes après sa connexion. Les trois options marquent la configuration comme terminée en écrivant setupDone: true dans config.yml.

Option	Ce qu'elle fait
Recommended Setup	Marque la configuration comme terminée et affiche le parcours en trois étapes : obtenir un token sur nightbreak.io/account, le lier avec /nightbreaklogin <token>, puis ouvrir /bs setup.
Manual Setup	Marque la configuration comme terminée et vous laisse la gestion du contenu, en vous orientant vers /bs setup et le dossier imports.
Use Current Content	Ferme l'invite et conserve le contenu actuel. Si le registre des schematics n'est pas vide, lance un rechargement ; sinon, indique qu'aucun contenu n'est installé et vous renvoie vers /bs setup. Ce contrôle ne compte pas les modules.

Si ni WorldEdit ni FastAsyncWorldEdit n'est installé, le troisième emplacement est remplacé par un avertissement vous demandant d'en installer un avant de continuer.

Le menu de configuration

/bs setup ouvre un menu paginé avec deux filtres : Packs de structures et Packs de modules. Chaque pack indique s'il est installé, téléchargé mais non activé, obsolète ou s'il nécessite un accès Nightbreak. L'action au clic dépend de cet état : télécharger, installer, mettre à jour, désinstaller ou afficher les informations d'accès.

Aux côtés des paquets, le menu expose également les contrôles partagés de MagmaCore intégrés à BetterStructures :

• Mise à jour du plugin - indique si une version plus récente de BetterStructures est disponible et vous permet de la télécharger. Un redémarrage l'applique, sauf si vous exécutez /bs applypluginupdate ou définissez nightbreak.applyPluginUpdatesWithoutRestart sur when-empty ou immediately dans config.yml. La vérification s'exécute automatiquement au démarrage et se rafraîchit environ une fois par heure : un serveur fraîchement démarré peut donc afficher brièvement « Plugin Update Pending ».
• Plugins recommandés - ouvre la vue de recommandation des plugins compagnons (identique à /bs recommendedplugins). L'icône passe au vert une fois que toutes les recommandations listées sont installées.
• Download All Content - l'entrée groupée ajoutée après la liste des paquets, équivalente à /bs downloadall.
• Mises à jour automatiques - un interrupteur de la barre d'outils déterminant si BetterStructures télécharge automatiquement les mises à jour du plugin et du contenu au démarrage. Il est désactivé par défaut et utilise la clé nightbreak.autoDownloadPluginUpdates dans config.yml. Les téléchargements automatiques de contenu sont préparés pour le prochain redémarrage, sans déclencher de rechargement à chaud. Un redémarrage applique également une mise à jour du plugin téléchargée, sauf si nightbreak.applyPluginUpdatesWithoutRestart vaut when-empty ou immediately (voir Configuration).
• Conseils d'installation - le bouton d'information, qui affiche dans le chat le guide d'installation, la page du token de compte, le Discord de support et les commandes d'installation cliquables.

/bs setup est refusé pendant qu'un rechargement de contenu est en cours, car le menu lit les mêmes registres que le processus de rechargement est en train de reconstruire. Attendez que le rechargement signale sa réussite, puis rouvrez-le.

Le menu ne vérifie pas l'intégrité des fichiers. Un pack endommagé ou partiellement supprimé peut encore apparaître à jour si son chemin existe et que sa version correspond. Utilisez /bs forcereinstallcontent <package|all> pour le réparer ; indiquez directement le slug si le dossier entier manque. La désinstallation conserve les fichiers sur disque. Elle passe le isEnabled du pack à false puis recharge, et le rechargement ignore chaque schematic ou module situé dans le dossier de ce pack, sous-dossiers compris.

Import manuel

Les imports manuels fonctionnent toujours via :

plugins/BetterStructures/imports

Gardez les zips de paquets intacts, puis exécutez /bs reload si nécessaire. /bs reload importe tout ce qui se trouve dans ce dossier dans le cadre du rechargement, vous n'avez donc pas besoin d'un redémarrage pour prendre en compte un paquet déposé là.

Notez que laisser des fichiers dans imports ralentit le démarrage : lorsque le dossier n'est pas vide, BetterStructures attend que les plugins listés dans son softdepend aient terminé leur initialisation avant de démarrer, car importer du contenu dans le dossier de données d'un autre plugin implique de recharger ce plugin. Une fois le dossier de nouveau vide, BetterStructures s'initialise sans attendre.

Voir le guide partagé : Imports manuels vs gestion en jeu.