Commandes BetterStructures

Utilisez /betterstructures ou /bs.

Installation et contenu

Commande	Fonction
/bs	Commande d'aide principale
/bs initialize	Flux de première configuration (ouvre le menu de première configuration)
/bs setup	Ouvre le menu de configuration/contenu
/bs recommendedplugins	Affiche les plugins compagnons qui fonctionnent bien avec BetterStructures
/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 tous les paquets de contenu disponibles (sans mise à jour du plugin)
/bs updatecontent	Télécharge les mises à jour du contenu obsolète (alias : /bs updateallcontent)
/bs forcereinstallcontent <package|all>	Retélécharge le contenu via le pipeline authentifié normal, même lorsque la version installée est déjà à jour. La complétion par tabulation propose all ainsi que chaque slug de paquet Nightbreak.
/bs downloadpluginupdate	Télécharge une mise à jour du plugin en attente. Un redémarrage l'applique, sauf si /bs applypluginupdate ou le réglage nightbreak.applyPluginUpdatesWithoutRestart l'applique plus tôt.
/bs applypluginupdate	Applique une mise à jour du plugin déjà téléchargée sans redémarrer le serveur
/bs reload	Recharge les configurations et le contenu de BetterStructures, et importe le contenu en attente
/bs version	Affiche la version du plugin

À propos de /bs reload

/bs reload ne désactive plus puis ne réactive plus le plugin. Il effectue désormais un rechargement de contenu sur place : config.yml et ValidWorlds.yml sont relus sur le thread serveur, puis les configurations de trésors, de générateurs, de générateurs de modules, de pools d'apparition, de schematics, de modules et de paquets de contenu sont reconstruites sur un thread de travail. Les commandes, les écouteurs et l'adaptateur NMS restent enregistrés.

Conséquences à connaître :

• Le rechargement annule la prégénération et la génération modulaire en cours, et arrête là où ils en sont les collages de structures et de donjons encore en file d'attente ou en cours. Les menus de configuration et de première installation sont également indisponibles pendant le rechargement.
• Pendant un rechargement, /bs place, /bs lootify, /bs pregenerate et /bs generateModules sont refusées avec un message indiquant que le contenu se recharge. Les analyses de nouveaux chunks sont conservées jusqu'à la réussite du rechargement, de même que les analyses de donjons en attente. Si un chunk en attente se décharge, son analyse attend son prochain chargement.
• Si vous relancez /bs reload alors qu'un rechargement est déjà en cours, votre requête est mise en file d'attente et un second rechargement complet s'exécute ensuite, de sorte qu'un fichier modifié en cours de rechargement est tout de même pris en compte.
• Si le rechargement échoue, BetterStructures se désactive volontairement plutôt que de continuer avec des registres de contenu à moitié vides. Consultez la console pour en connaître la cause et redémarrez le serveur après correction.

À propos de /bs forcereinstallcontent

Les téléchargements normaux ignorent un paquet dont la version locale correspond déjà à la version distante, ce qui les rend inutiles lorsque les fichiers sur le disque ont été endommagés ou partiellement supprimés. forcereinstallcontent contourne cette vérification de version et repasse le paquet sélectionné par le même pipeline authentifié de téléchargement, d'import et de rechargement.

• all sélectionne chaque paquet que BetterStructures considère actuellement comme téléchargé, installé ou obsolète. Si rien ne correspond, la commande refuse et vous demande de nommer un slug directement - ce qui est justement ce que vous voulez quand les fichiers d'un paquet ont totalement disparu.
• Nommer un seul slug réinstalle uniquement ce paquet.
• Un slug inconnu est rejeté avec un message qui vous renvoie vers la complétion par tabulation.

À propos de /bs applypluginupdate

/bs applypluginupdate installe une mise à jour de BetterStructures déjà téléchargée et en attente dans le dossier de mise à jour du serveur, sans redémarrage. La commande désactive BetterStructures et chaque plugin MagmaGuy qui en dépend, remplace le jar, puis les recharge et les réactive. Les plugins rechargés avec lui sont listés dans le chat. Si le nouveau jar ne s'active pas, l'ancien jar est rechargé et la mise à jour reste en attente pour le prochain redémarrage.

La commande refuse de s'exécuter lorsqu'aucune mise à jour n'est en attente, lorsque le jar en attente est invalide ou n'est pas plus récent que la version en cours d'exécution, ou lorsqu'un plugin d'un autre auteur dépend de BetterStructures. Dans ce cas, redémarrez le serveur. Les boss, arènes et instances de donjon en cours prennent fin lors du rechargement du plugin.

Pour appliquer automatiquement les mises à jour téléchargées, définissez nightbreak.applyPluginUpdatesWithoutRestart dans config.yml (voir Configuration).

Les commandes de téléchargement/mise à jour, de plugins recommandés et de mise à jour du plugin sont fournies par le système partagé MagmaCore Nightbreak intégré à BetterStructures. Le même menu de configuration propose une entrée Mise à jour du plugin, une entrée Plugins recommandés et un interrupteur Mises à jour automatiques (voir Installation).

Commandes utilitaires et d'administration

Commande	Fonction
/bs place <schematic> <type>	Cherche un placement adapté à partir du chunk actuel du joueur ; la recherche peut choisir une position voisine. Types valides : SURFACE, UNDERGROUND_SHALLOW, UNDERGROUND_DEEP, SKY, LIQUID_SURFACE
/bs lootify <generator> <rarity> <minAmount> <maxAmount> <weight>	Ajoute l'objet tenu en main à une table de trésor. Le générateur doit être une configuration de trésor valide, la rareté doit exister dans cette configuration, minAmount doit être au moins 1, maxAmount doit être au plus 64, et vous devez tenir un objet en main.
/bs pregenerate <centerType> <shape> <radiusInBlocks> <applyWorldBorder>	Pré-génère les chunks avec BetterStructures activé. Le monde est déduit du monde actuel du joueur. centerType : HERE, WORLD_CENTER, WORLD_SPAWN. shape : SQUARE, CIRCLE. applyWorldBorder : TRUE/FALSE.
/bs cancelPregenerate	Annule la pré-génération active dans le monde actuel du joueur (alias : /bs cancelpregenerate)
/bs generateModules <generatorFile>	Génère du contenu modulaire à partir d'un fichier générateur de modules
/bs teleport <world> <x> <y> <z>	Téléporte vers un emplacement spécifique (alias : /bs tp)
/bs silent	Active/désactive certains avertissements opérateur

Respectez les contraintes suivantes pour ces commandes utilitaires :

• /bs place signale une tentative de placement, pas la confirmation qu'une structure a été placée.
• Exécutez /bs lootify en jeu, avec l'objet dans la main principale. Les quantités et le poids doivent être des entiers. Choisissez 1 <= minAmount <= maxAmount <= 64 et un poids positif ; la commande ne rejette pas toutes les plages invalides. L'enregistrement d'une entrée lance un rechargement du contenu.
• /bs pregenerate accepte un rayon de zéro bloc ou plus, arrondi au nombre entier de chunks supérieur. Avec applyWorldBorder à TRUE, la fin du traitement définit une bordure de monde carrée de diamètre 2 × radiusInBlocks, même pour une génération CIRCLE. L'annulation ne définit pas la bordure et ne supprime pas les chunks générés. Si un chunk ne parvient pas à se charger, la prégénération s'arrête, consigne le chunk en échec dans les logs et laisse la bordure du monde inchangée.
• /bs teleport nécessite un monde chargé et des coordonnées entières ; les coordonnées relatives ne sont pas prises en charge.

Permissions

Permission	Description	Défaut
betterstructures.setup	Accès à /bs setup, /bs recommendedplugins, /bs downloadallcontent et /bs updatecontent	OP
betterstructures.initialize	Accès à /bs initialize	OP
betterstructures.generatemodules	Accès à /bs generateModules	OP
betterstructures.generatemodules.slowly	Enregistrée dans plugin.yml mais actuellement utilisée par aucune commande dans le code source. Probablement vestigiale.	OP
betterstructures.generatemodules.instantly	Enregistrée dans plugin.yml mais actuellement utilisée par aucune commande dans le code source. Probablement vestigiale.	OP
betterstructures.*	Wildcard pour les commandes utilitaires et admin (place, pregenerate, cancelPregenerate, reload, teleport, version, lootify, aide /bs) ainsi que les commandes de contenu admin /bs downloadall, /bs downloadpluginupdate, /bs applypluginupdate et /bs forcereinstallcontent. Détenue par les OP par défaut.	OP
betterstructures.*	Également nécessaire à /bs silent, qui modifie le réglage d'avertissement de tout le serveur.	OP
betterstructures.warn	Reçoit les messages cliquables « nouveau bâtiment généré » et « un nouveau donjon a commencé à se générer » tant que warnAdminsAboutNewBuildings vaut true. Non déclarée dans plugin.yml, Bukkit l'accorde donc aux OP par défaut.	OP

betterstructures.setup couvre les commandes de navigation/gestion du contenu, betterstructures.initialize couvre la première configuration et betterstructures.generatemodules couvre la génération de donjons. La commande combinée plugin-et-contenu /bs downloadall, les commandes plugin uniquement /bs downloadpluginupdate et /bs applypluginupdate, et la commande de réparation /bs forcereinstallcontent sont protégées par le wildcard admin betterstructures.*. Les variantes .slowly et .instantly sont toujours déclarées dans plugin.yml mais aucune commande ne les vérifie actuellement.

Accorder l'une des permissions betterstructures.*, betterstructures.setup, betterstructures.initialize ou betterstructures.generatemodules donne accès à la commande racine. Chaque sous-commande vérifie toujours sa propre permission : un administrateur chargé uniquement de l'installation n'a donc pas besoin du joker.

betterstructures.* contrôle également le rappel de première configuration : les joueurs qui la détiennent reçoivent un message dix secondes après chaque connexion tant que setupDone vaut false dans config.yml, les renvoyant vers /bs initialize.