Commandes BetterStructures

Utilisez /betterstructures ou /bs.

Configuration et contenu

Commande	Fonction
/bs	Commande principale d'aide et de statut
/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 est requis pour l'appliquer)
/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 :

• Pendant qu'un rechargement est en cours, /bs place, /bs lootify, /bs pregenerate et /bs generateModules sont refusées avec un message indiquant que le contenu est en cours de rechargement, et les chunks nouvellement générés sont ignorés plutôt qu'analysés.
• 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.

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 admin

Commande	Fonction
/bs place <schematic> <type>	Place une structure manuellement. 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

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 et /bs forcereinstallcontent. Détenue par les OP par défaut.	OP
(aucune)	/bs silent n'a pas de barrière de permission dans le code source : n'importe quel expéditeur peut l'exécuter.	—

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, la commande plugin uniquement /bs downloadpluginupdate 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.

betterstructures.* contrôle également le rappel de première configuration : les joueurs qui la détiennent reçoivent un message de connexion unique les renvoyant vers /bs initialize, jusqu'à ce que setupDone soit passé à true dans config.yml.