Pular para o conteúdo principal

Criando Geradores

Geradores

Geradores são a parte mais poderosa do sistema de configuração do BetterStructures. Por padrão há 31 geradores que coletivamente gerenciam mais de 200 construções atualmente distribuídas pelo BetterStructures, e embora você possa criar seus próprios geradores, você também pode usar os existentes como um atalho.

Geradores indicam ao plugin exatamente onde as coisas devem aparecer e definem tabelas de loot. Os geradores padrão também são nomeados de formas que devem ser muito fáceis de adivinhar o que eles fazem.

O único campo obrigatório para geradores é a configuração structureType, que diz ao plugin se o edifício deve aparecer no céu, raso subterrâneo, profundamente subterrâneo, superfície ou líquido na superfície.


isEnabled

Define se o gerador está habilitado.


structureType

Define que tipo de estrutura é a construção. Observe que você pode fazer uma lista de vários tipos!

Você pode especificar vários tipos de estrutura para um único gerador:

structureType:
- SURFACE
- UNDERGROUND_SHALLOW

Isso permite que o mesmo gerador gere estruturas em vários locais, como na superfície e em áreas subterrâneas rasas.

Os seguintes são valores de tipo de estrutura válidos:


surface

structureType: 
- SURFACE

As estruturas de superfície aparecem na superfície do mundo. A única exceção é o ambiente Nether, onde ele aparece em pontos que o plugin considera como sendo suficientemente semelhantes à superfície.


sky

structureType: 
- SKY

As estruturas do céu aparecem entre 80 a 120 blocos acima do ar, configurável em config.yml. A única exceção é o ambiente Nether, onde ele aparece em pontos que o plugin considera como sendo suficientemente semelhantes ao ar.


underground_shallow

structureType: 
- UNDERGROUND_SHALLOW

As estruturas subterrâneas rasas aparecem entre y=0 e y=60 no overworld, y=60 e y=120 no nether e qualquer altura subterrânea válida no End.

**Nota: ** Você notará que existem duas configurações subterrâneas. Isso ocorre porque ter apenas uma resulta em ter um subterrâneo muito esparso, pois o Minecraft tem muito espaço subterrâneo e os jogadores frequentemente perdem estruturas subterrâneas simplesmente porque não escavaram nelas. Isso também garante que haja uma distribuição uniforme em profundidades diferentes.


underground_deep

structureType: 
- UNDERGROUND_DEEP

As estruturas profundas subterrâneas aparecem entre y=-64 e y=0 no overworld, y=0 e y=60 no nether e não aparecem no End.


liquid_surface

structureType: 
- LIQUID_SURFACE

As estruturas da superfície líquida aparecerão em líquidos. No caso do overworld, elas aparecerão na água e quase sempre em oceanos. No caso do Nether, elas aparecerão nos lagos de lava. Elas não aparecerão no End.


lowestYLevel

Define o nível Y mais baixo (altitude) em que a estrutura aparecerá. Padrão: -59.


highestYLevel

Define o nível Y mais alto (altitude) em que a estrutura aparecerá. Padrão: 320.

Intervalos de Nível Y Padrão por Dimensão:

O surgimento de estrutura usa diferentes intervalos de altitude padrão por dimensão, configurável em config.yml:

  • Overworld/Mundos Personalizados: Y=-60 a Y=320 (configurações: lowestYNormalCustom / highestYNormalCustom)
  • Nether: Y=4 a Y=120 (configurações: lowestYNether / highestYNether)
  • End: Y=0 a Y=320 (configurações: lowestYEnd / highestYEnd)
  • Estruturas do Céu (Overworld): Y=80 a Y=120 (configurável via normalCustomAirBuildingMinAltitude / normalCustomAirBuildingMaxAltitude)
  • Estruturas do Céu (End): Y=80 a Y=120 (configurável via endAirBuildMinAltitude / endAirBuildMaxAltitude)

Esses padrões globais podem ser substituídos por gerador usando lowestYLevel e highestYLevel nas configurações do gerador.


validWorlds

Define a lista de mundos em que a estrutura aparecerá. Se nenhuma lista estiver presente, ela usará todos os mundos permitidos pelo plugin, a menos que seja limitada de outra forma (como pelo tipo de ambiente ou biomas).


validWorldEnvironments

Define a lista de ambientes do mundo em que a estrutura aparecerá. Se nenhuma lista estiver presente, ela usará todos os ambientes do mundo permitidos pelo plugin. Valores válidos: NORMAL, NETHER, THE_END e CUSTOM.


validBiomes

Define a lista de biomas válidos em que a estrutura aparecerá. Se nenhuma lista for definida, ela assumirá que todos os biomas são válidos!.

Isso requer o uso de biomas no formato namespace:key (por exemplo, minecraft:plains, minecraft:desert). Você pode encontrar a lista de biomas válidos conforme definido pela API Spigot. O plugin inclui automaticamente biomas personalizados que são mapeados para biomas vanilla através do sistema CustomBiomeCompatibility.

Suporte a Biomas Personalizados:

BetterStructures oferece suporte automático a biomas personalizados de geradores de mundo como Terralith, Iris, Terra e TerraformGenerator.

Quando você especifica um bioma vanilla em validBiomes, o plugin inclui automaticamente biomas personalizados compatíveis:

validBiomes:
- minecraft:plains
- minecraft:forest

Esta configuração gerará estruturas em:

  • Os biomas vanilla (minecraft:plains, minecraft:forest)
  • Todos os biomas personalizados mapeados para esses tipos vanilla (por exemplo, terralith:blooming_plains)

Nenhuma configuração extra necessária - o suporte a biomas personalizados é automático.


treasureFilename

Define o arquivo de tesouro que o gerador usará. Isso define o que aparece nos baús para todas as construções que usam este gerador, a menos que um valor diferente seja definido na configuração treasureFile de um esquema.