Aller au contenu principal

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 y a 31 générateurs qui gèrent collectivement plus de 200 structures actuellement distribuées par BetterStructures, et bien que vous puissiez créer vos propres générateurs, vous pouvez également utiliser des générateurs existants comme raccourci.

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

Le seul champ obligatoire pour les générateurs est le paramètre structureType, qui indique au plugin si le bâtiment est destiné à apparaître dans le ciel, sous terre peu profondément, sous terre profondément, à la surface ou à la surface sur un liquide.

isEnabled​

Définit si le générateur est activé.

structureType​

Définit le type de structure du bâtiment. Notez que vous pouvez créer une liste de plusieurs types !

Vous pouvez spécifier plusieurs types de structures pour un seul générateur :

structureType:
- SURFACE
- UNDERGROUND_SHALLOW

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

Les valeurs de type de structure valides suivantes :

surface​

structureType:
- SURFACE

Les structures de surface apparaissent à la surface du monde. La seule exception est l'environnement du Nether, où elle apparaît à des points que le plugin juge suffisamment ressemblant à une surface.

sky​

structureType:
- SKY

Les structures du ciel apparaissent entre 80 et 120 blocs au-dessus de l'air, configurable dans config.yml. La seule exception est l'environnement du Nether, où elle apparaît à des points que le plugin juge suffisamment ressemblant à de l'air.

underground_shallow​

structureType:
- UNDERGROUND_SHALLOW

Les structures souterraines peu profondies apparaissent entre y=0 et y=60 dans le monde normal, y=60 et y=120 dans le nether et à toute hauteur souterraine valide dans l'End.

Note : Vous remarquerez qu'il y a deux paramètres souterrains. C'est parce que d'avoir un seul entraîne d'avoir un souterrain très clairsemé, car Minecraft dispose de beaucoup d'espace souterrain et les joueurs rateront souvent les structures souterraines simplement parce qu'ils n'ont pas exploré ces zones. Cela garantit également une répartition uniforme à différentes profondeurs.

underground_deep​

structureType:
- UNDERGROUND_DEEP

Les structures souterraines profondies apparaissent entre y=-64 et y=0 dans le monde normal, y=0 et y=60 dans le nether et n'apparaissent pas dans l'End.

liquid_surface​

structureType:
- LIQUID_SURFACE

Les structures de surface liquide apparaîtront sur les liquides. Dans le cas du monde normal, elles apparaîtront sur l'eau, et presque toujours sur les océans. Dans le cas du Nether, elles apparaîtront dans les lacs de lave. Elles n'apparaîtront pas dans l'End.

lowestYLevel​

Définit le niveau Y le plus bas (altitude) auquel la structure apparaîtra. Par défaut : -59.

highestYLevel​

Définit le niveau Y le plus haut (altitude) auquel la structure apparaîtra. Par défaut : 320.

Plages de niveau Y par défaut par dimension :

Le spawn des structures utilise différentes plages d'altitude par défaut par dimension, configurable dans config.yml :

  • Monde normal/Mondes personnalisés : Y=-60 à Y=320 (paramètres : lowestYNormalCustom / highestYNormalCustom)
  • Nether : Y=4 à Y=120 (paramètres : lowestYNether / highestYNether)
  • End : Y=0 à Y=320 (paramètres : lowestYEnd / highestYEnd)
  • Structures du ciel (Monde normal) : Y=80 à Y=120 (configurable via normalCustomAirBuildingMinAltitude / normalCustomAirBuildingMaxAltitude)
  • Structures du ciel (End) : Y=80 à Y=120 (configurable via endAirBuildMinAltitude / endAirBuildMaxAltitude)

Ces paramètres par défaut globaux peuvent être remplacés par générateur en utilisant lowestYLevel et highestYLevel dans les configurations des générateurs.

validWorlds​

Définit la liste des mondes dans lesquels la structure apparaîtra. Si aucune liste n'est présente, elle utilisera tous les mondes autorisés par le plugin, sauf limitation supplémentaire (comme le type d'environnement ou les biomes).

validWorldEnvironments​

Définit la liste des environnements mondiaux dans lesquels la structure apparaîtra. Si aucune liste n'est présente, elle utilisera tous les environnements mondiaux autorisés par le plugin. Valeurs valides : NORMAL, NETHER, THE_END et CUSTOM.

validBiomes​

Définit la liste des biomes valides dans lesquels la structure apparaîtra. Si aucune liste n'est définie, elle supposera que tous les biomes sont valides !.

Cela nécessite d'utiliser des biomes au format namespace:key (par exemple, minecraft:plains, minecraft:desert). Vous pouvez trouver la liste des biomes valides tels que définis par l'API Spigot. Le plugin inclut automatiquement les biomes personnalisés qui sont mappés aux biomes vanilla via le système CustomBiomeCompatibility.

Support des biomes personnalisés :

BetterStructures supporte automatiquement les biomes personnalisés des générateurs de mondes comme Terralith, Iris, Terra et TerraformGenerator.

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

validBiomes:
  - minecraft:plains
  - minecraft:forest

Cette configuration fera apparaître des structures dans :

  • Les biomes vanilla (minecraft:plains, minecraft:forest)
  • Tous les biomes personnalisés mappés à ces types vanilla (par exemple, terralith:blooming_plains)

Aucune configuration supplémentaire nécessaire - le support des biomes personnalisés est automatique.

treasureFilename​

Définit le fichier de trésor que le générateur utilisera. Cela définit ce qui apparaît dans les coffres pour toutes les structures qui utilisent ce générateur, sauf si une valeur différente est définie dans le paramètre treasureFile de la configuration schématique.