Créer des générateurs

Générateurs

Les générateurs sont la partie la plus puissante du système de configuration de BetterStructures. Par défaut, il existe 29 générateurs qui gèrent collectivement les constructions actuellement distribuées par BetterStructures et, même si vous pouvez créer vos propres générateurs, vous pouvez aussi utiliser ceux existants comme raccourci.

Les générateurs indiquent au plugin où exactement les choses doivent apparaître et définissent les tables de butin. Les générateurs par défaut sont en plus nommés de manière à ce qu'il soit très facile de deviner ce qu'ils font.

Options de configuration du générateur

Clé	Par défaut	Obligatoire	Description
isEnabled	true	❌	Si le générateur est activé
structureType	-	✅	Où les structures apparaissent (voir le tableau ci-dessous)
lowestYLevel	-59	❌	Niveau Y minimum pour l'apparition
highestYLevel	320	❌	Niveau Y maximum pour l'apparition
validWorlds	Tous autorisés	❌	Liste des mondes où les structures peuvent apparaître
validWorldEnvironments	Tous autorisés	❌	NORMAL, NETHER, THE_END
validBiomesV2	Tous les biomes	❌	Liste des biomes valides (format namespace:key)
treasureFilename	-	❌	Fichier de trésor pour le butin des coffres
generateLootInBarrels	true	❌	Si les tonneaux trouvés dans les schematics de ce générateur doivent être remplis de butin
barrelTreasureFilename	treasure_barrel_food.yml	❌	Fichier de trésor utilisé pour remplir les tonneaux de ce générateur

---

structureType

Définit le type de structure de la construction. Vous pouvez spécifier plusieurs types de structure pour un seul générateur !

Type	Surface	Nether	End	Description
SURFACE	Surface	Points similaires à la surface	Surface	Apparaît à la surface du monde
SKY	Y 80-120	Points similaires à l'air	Y 80-120	Apparaît dans le ciel (configurable dans config.yml)
UNDERGROUND_SHALLOW	Y 0-60	Y 60-120	Hauteurs valides	Structures souterraines peu profondes
UNDERGROUND_DEEP	Y -64 à 0	Y 0-60	❌ N'apparaît pas	Structures souterraines profondes
LIQUID_SURFACE	Eau (océans)	Lacs de lave	❌ N'apparaît pas	Apparaît sur les surfaces liquides
DUNGEON	✅	✅	✅	Utilisé pour le placement de donjons modulaires

Exemple de types de structure multiples

structureType:
- SURFACE
- UNDERGROUND_SHALLOW

Cela permet au même générateur de faire apparaître des structures à plusieurs endroits, par exemple à la fois en surface et dans les zones souterraines peu profondes.

Remarque : il existe deux paramètres souterrains car Minecraft dispose de beaucoup d'espace souterrain. Les avoir tous les deux assure une distribution uniforme à travers les profondeurs et empêche les joueurs de manquer des structures.

---

Plages de niveaux Y par dimension

Plages d'altitude par défaut par dimension (configurables dans config.yml) :

Dimension	Plage par défaut	Paramètres de configuration
Surface/Personnalisé	Y=-60 à Y=320	lowestYNormalCustom / highestYNormalCustom
Nether	Y=4 à Y=120	lowestYNether / highestYNether
End	Y=0 à Y=320	lowestYEnd / highestYEnd
Ciel (Surface)	Y=80 à Y=120	normalCustomAirBuildingMinAltitude / Max...
Ciel (End)	Y=80 à Y=120	endAirBuildMinAltitude / Max...

Ces valeurs par défaut peuvent être remplacées générateur par générateur en utilisant lowestYLevel et highestYLevel.

---

Prise en charge des biomes personnalisés

BetterStructures prend automatiquement en charge les biomes personnalisés des générateurs de monde comme Terralith, Iris, Terra et TerraformGenerator.

Lorsque vous spécifiez un biome vanilla dans validBiomesV2, le plugin inclut automatiquement les biomes personnalisés compatibles :

validBiomesV2:
  - minecraft:plains
  - minecraft:forest

Cela fait apparaître des structures dans les biomes vanilla ET dans tous les biomes personnalisés associés à ces types (par ex. terralith:blooming_plains).

---

treasureFilename

Définit le fichier de trésor pour le butin des coffres. Cela s'applique à toutes les constructions utilisant ce générateur, sauf si c'est remplacé dans la configuration du schematic.

---

generateLootInBarrels et barrelTreasureFilename

BetterStructures traite désormais les tonneaux comme un deuxième conteneur de butin, aux côtés des coffres.

• generateLootInBarrels (par défaut true) détermine si les tonneaux à l'intérieur des structures placées par ce générateur sont remplis. Définissez-le sur false pour laisser les tonneaux intacts.
• barrelTreasureFilename (par défaut treasure_barrel_food.yml) sélectionne le fichier de trésor utilisé lors du remplissage de ces tonneaux. Le fichier par défaut fournit une table de butin légère axée sur la nourriture, mais vous pouvez le pointer vers n'importe quel fichier de trésor.

Les deux options peuvent être remplacées schematic par schematic à l'aide du champ barrelTreasureFilename correspondant dans la configuration du schematic.