Configuration de BetterStructures
Cette page est la référence des deux fichiers de configuration au niveau du plugin que BetterStructures écrit dans plugins/BetterStructures. La configuration au niveau du contenu se trouve ailleurs : voir Créer des générateurs, Créer des structures, Créer des trésors et Donjons modulaires.
Les deux fichiers sont relus sur le thread serveur à chaque fois que vous exécutez /bs reload : vous n'avez donc pas besoin d'un redémarrage pour appliquer une modification faite ici.
Organisation des dossiers
| Chemin | Contenu |
|---|---|
config.yml | Paramètres globaux du plugin, documentés ci-dessous |
ValidWorlds.yml | Interrupteurs marche/arrêt par monde, documentés ci-dessous |
schematics/ | Fichiers .schem de structures et leurs configurations .yml générées, analysés récursivement |
modules/ | Fichiers .schem de donjons modulaires et leurs configurations .yml générées, analysés récursivement |
generators/ | Configurations de générateurs |
module_generators/ | Configurations de générateurs de modules |
treasures/ | Configurations de trésors (tables de butin) |
spawn_pools/ | Configurations de pools d'apparition utilisées par les panneaux [pool: name] |
content_packages/ | Descripteurs de paquets utilisés par le menu de configuration et les commandes de téléchargement |
components/ | Créé vide au démarrage, pour le contenu livrant des composants de support |
imports/ | Dossier de dépôt pour les imports manuels de contenu |
.schematic_cache/ | Cache géré des schematics convertis, supprimable sans risque |
config.yml
Espacement des structures
BetterStructures place les structures sur une grille en losange générée à partir de la seed, une grille par type de structure. Les clés de distance définissent l'écart entre les points de la grille, et les clés de décalage déplacent aléatoirement chaque point hors de la grille afin que les placements n'aient pas l'air mécaniques.
Les deux sont mesurées en chunks, pas en blocs. Un distanceSurface de 27 signifie environ une structure de surface tous les 27 chunks (environ 432 blocs).
| Clé | Par défaut | Description |
|---|---|---|
distanceSurface | 27 | Espacement de grille pour les structures SURFACE |
distanceShallow | 22 | Espacement de grille pour les structures UNDERGROUND_SHALLOW |
distanceDeep | 22 | Espacement de grille pour les structures UNDERGROUND_DEEP |
distanceSky | 90 | Espacement de grille pour les structures SKY |
distanceLiquid | 60 | Espacement de grille pour les structures LIQUID_SURFACE |
distanceDungeonV2 | 80 | Espacement de grille pour les placements DUNGEON |
maxOffsetSurface | 5 | Décalage aléatoire appliqué aux points de grille de surface |
maxOffsetShallow | 5 | Décalage aléatoire appliqué aux points de grille souterrains peu profonds |
maxOffsetDeep | 5 | Décalage aléatoire appliqué aux points de grille souterrains profonds |
maxOffsetSky | 5 | Décalage aléatoire appliqué aux points de grille aériens |
maxOffsetLiquid | 5 | Décalage aléatoire appliqué aux points de grille de surface liquide |
maxOffsetDungeonV2 | 18 | Décalage aléatoire appliqué aux points de grille de donjons |
Des distances plus petites signifient plus de structures. Des décalages plus petits donnent un placement plus proche d'une grille ; des décalages plus grands rendent le placement moins prévisible.
Validation. Les distances doivent être d'au moins 1. Les décalages doivent être compris entre 0 et 1073741823, la plus grande valeur que le générateur aléatoire de placement peut utiliser sans risque. Une valeur hors de sa plage fait que BetterStructures enregistre un avertissement, réécrit la valeur par défaut de cette clé dans config.yml, et continue avec la valeur par défaut plutôt que de faire échouer la génération.
Les décalages sont dérivés de la seed du monde et du nom du type de structure : la même seed produit donc la même disposition à chaque redémarrage.
Protection du spawn
| Clé | Par défaut | Description |
|---|---|---|
spawnProtectionRadius | 100 | Distance minimale en blocs par rapport aux coordonnées 0, 0 à l'intérieur de laquelle aucune structure n'est placée. S'applique à tous les mondes. Mettez 0 pour désactiver. |
Notez que la mesure part de l'origine du monde, et non du point d'apparition de chaque monde.
Limites d'altitude
Ces clés délimitent l'endroit où les structures souterraines peuvent se retrouver, par dimension. Une structure dont l'ancrage tomberait hors de la plage est ramenée à l'intérieur.
| Clé | Par défaut | Description |
|---|---|---|
lowestYNormalCustom | -60 | Y le plus bas pour les mondes NORMAL et CUSTOM |
highestYNormalCustom | 320 | Y le plus haut pour les mondes NORMAL et CUSTOM |
lowestYNether | 4 | Y le plus bas dans le Nether |
highestYNether | 120 | Y le plus haut dans le Nether |
lowestYEnd | 0 | Y le plus bas dans l'End |
highestYEnd | 320 | Y le plus haut dans l'End |
Les structures aériennes utilisent leurs propres paramètres, et ce sont des décalages au-dessus du bloc le plus haut de la colonne, non des niveaux Y absolus. Une valeur aléatoire entre le minimum et le maximum est tirée à chaque placement.
| Clé | Par défaut | Description |
|---|---|---|
normalCustomAirBuildingMinAltitude | 80 | Décalage aérien le plus bas dans les mondes NORMAL et CUSTOM |
normalCustomAirBuildingMaxAltitude | 120 | Décalage aérien le plus haut dans les mondes NORMAL et CUSTOM |
endAirBuildMinAltitude | 80 | Décalage aérien le plus bas dans l'End |
endAirBuildMaxAltitude | 120 | Décalage aérien le plus haut dans l'End |
Le Nether ignore ces quatre clés : les structures aériennes y sont placées dans une poche d'air trouvée en analysant entre Y 45 et Y 100.
Performances
| Clé | Par défaut | Description |
|---|---|---|
percentageOfTickUsedForPasting | 0.2 | Part de chaque tick serveur que BetterStructures peut consacrer au collage de blocs, de 0.01 (1 %) à 1 (100 %). Des valeurs plus faibles réduisent le lag mais rendent l'apparition progressive des constructions plus visible. |
percentageOfTickUsedForPregeneration | 0.1 | Part de chaque tick serveur utilisée par /bs pregenerate, même plage de 0.01 à 1 |
pregenerationTPSPauseThreshold | 12.0 | La prégénération se met en pause lorsque les TPS du serveur passent sous cette valeur |
pregenerationTPSResumeThreshold | 14.0 | La prégénération reprend lorsque les TPS atteignent ou dépassent cette valeur. Gardez-la plus haute que le seuil de pause pour éviter des cycles pause/reprise rapides. |
modularChunkPastingSpeed | 10 | Actuellement inutilisée. La clé est toujours écrite dans config.yml, mais rien ne la lit : la modifier n'a aucun effet. |
Administration et intégration
| Clé | Par défaut | Description |
|---|---|---|
warnAdminsAboutNewBuildings | true | Détermine si les opérateurs sont notifiés lorsqu'une structure se génère à proximité. /bs silent inverse cette valeur et la sauvegarde. |
setupDone | false | Indique si le flux de première configuration a été effectué. Repassez-la à false et rechargez pour que /bs initialize propose à nouveau l'invite. |
protectEliteMobsRegions | true | Détermine si BetterStructures crée une protection WorldGuard pour les zones de combat gérées par EliteMobs. Nécessite à la fois WorldGuard et EliteMobs. |
regionProtectedMessage | &8[BetterStructures] &cDefeat the zone's bosses to edit blocks! | Message affiché lorsqu'un joueur tente de modifier des blocs à l'intérieur d'une de ces régions protégées |
nightbreak.autoDownloadPluginUpdates | false | Détermine si les mises à jour du plugin et du contenu se téléchargent automatiquement au démarrage. C'est la clé derrière l'interrupteur Automatic Updates de /bs setup. Un redémarrage reste nécessaire pour appliquer une mise à jour du plugin téléchargée. |
ValidWorlds.yml
Ce fichier décide dans quels mondes BetterStructures génère du contenu.
New worlds spawn structures: true
EliteMobs worlds excluded by default: true
Valid worlds:
world: true
world_nether: true
world_the_end: true
| Clé | Par défaut | Description |
|---|---|---|
New worlds spawn structures | true | Détermine si un monde que BetterStructures n'a jamais vu est enregistré comme activé |
Valid worlds | rempli automatiquement | Une entrée nomdumonde: true/false par monde. Mettez un monde à false pour stopper toute génération de structures dedans. |
EliteMobs worlds excluded by default | écrite comme true après la migration unique | Marqueur interne. Ne la modifiez pas. |
Comportement automatique
- Les nouveaux mondes sont enregistrés au chargement. Un monde qui se charge pour la première fois reçoit immédiatement une entrée, avec
New worlds spawn structurescomme valeur. - Les mondes gérés par EliteMobs sont exclus. Le hub de la guilde des aventuriers et les copies de donjons instanciés sont enregistrés à
falsemême quandNew worlds spawn structuresvauttrue, car leurs chunks de vide non construits comptent comme de nouveaux chunks et faisaient décorer les hubs de donjons par BetterStructures. L'entrée est tout de même écrite, donc la repasser àtruefonctionne si c'est vraiment ce que vous voulez. - Les entrées
em_existantes ont été migrées une seule fois. Tout mondeem_qui n'étaittruequ'à cause de l'ancienne valeur par défaut permissive a été basculé àfalseune seule fois, et le marqueurEliteMobs worlds excluded by defaultenregistre que cette migration a déjà eu lieu. Un monde que vous réactivez délibérément ensuite reste activé d'un redémarrage à l'autre. - Les entrées mortes sont élaguées. Au démarrage, et environ dix secondes après le déchargement d'un monde, les entrées dont le monde n'est ni chargé ni présent sur le disque sont supprimées afin que le fichier ne grossisse pas indéfiniment.