Installation de BetterStructures

BetterStructures prend toujours en charge les imports manuels, mais le flux de travail actuellement recommandé est orienté Nightbreak et se fait en jeu.

Prérequis

• Prise en charge des schematics compatible WorldEdit ou FAWE
• Runtime Java 21 pour la ligne de compilation actuelle

Flux de travail recommandé

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 configuration

/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 déjà installé, puis lance un rechargement. Si aucun contenu n'est installé, un message vous l'indique et vous renvoie vers /bs setup.

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é où les paquets sont répartis selon deux filtres : Packs de structures et Packs de modules. Chaque paquet indique s'il est installé, téléchargé mais non activé, obsolète, ou s'il nécessite un accès Nightbreak ; cliquer dessus l'installe ou le met à jour.

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 est nécessaire pour l'appliquer). 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. Ceci est désactivé par défaut et repose sur la clé nightbreak.autoDownloadPluginUpdates dans config.yml. Un redémarrage reste nécessaire pour appliquer une mise à jour du plugin téléchargée.
• 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.

Si les fichiers d'un paquet finissent endommagés ou partiellement supprimés, /bs setup ne les réparera pas : il compare les versions et considère le paquet à jour. Utilisez /bs forcereinstallcontent <package|all> à la place.

Repli sur l'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.