Configuração do BetterStructures

Esta página é a referência para os dois arquivos de configuração de nível de plugin que o BetterStructures escreve em plugins/BetterStructures. A configuração de nível de conteúdo fica em outro lugar: veja Criar Geradores, Criar Estruturas, Criar Tesouros e Masmorras Modulares.

Ambos os arquivos são relidos na thread do servidor sempre que você executa /bs reload, portanto não é necessário reiniciar para aplicar uma alteração feita aqui.

Organização das pastas

Caminho	Conteúdo
config.yml	Configurações gerais do plugin, documentadas abaixo
ValidWorlds.yml	Interruptores de liga/desliga por mundo, documentados abaixo
schematics/	Arquivos .schem das estruturas e seus arquivos .yml de configuração gerados, lidos recursivamente
modules/	Arquivos .schem de masmorras modulares e seus arquivos .yml de configuração gerados, lidos recursivamente
generators/	Configurações de geradores
module_generators/	Configurações de geradores de módulos
treasures/	Configurações de tesouro (tabelas de saque)
spawn_pools/	Configurações de spawn pools usadas pelas placas [pool: name]
content_packages/	Descritores de pacotes usados pelo menu de configuração e pelos comandos de download
components/	Criada vazia na inicialização, para conteúdo que traga componentes de apoio
imports/	Pasta onde você coloca importações manuais de conteúdo
.schematic_cache/	Cache gerenciado de schematics convertidos, pode ser excluído com segurança

---

config.yml

Espaçamento das estruturas

O BetterStructures posiciona as estruturas em uma grade em losango derivada da seed, uma grade por tipo de estrutura. As chaves de distância definem o quão afastados ficam os pontos da grade, e as chaves de offset deslocam aleatoriamente cada ponto para fora da grade, para que as colocações não pareçam mecânicas.

Ambas são medidas em chunks, não em blocos. Um distanceSurface de 27 significa aproximadamente uma estrutura de superfície a cada 27 chunks (cerca de 432 blocos).

Chave	Padrão	Descrição
distanceSurface	27	Espaçamento da grade para estruturas SURFACE
distanceShallow	22	Espaçamento da grade para estruturas UNDERGROUND_SHALLOW
distanceDeep	22	Espaçamento da grade para estruturas UNDERGROUND_DEEP
distanceSky	90	Espaçamento da grade para estruturas SKY
distanceLiquid	60	Espaçamento da grade para estruturas LIQUID_SURFACE
distanceDungeonV2	80	Espaçamento da grade para colocações DUNGEON
maxOffsetSurface	5	Deslocamento aleatório aplicado aos pontos da grade de superfície
maxOffsetShallow	5	Deslocamento aleatório aplicado aos pontos da grade subterrânea rasa
maxOffsetDeep	5	Deslocamento aleatório aplicado aos pontos da grade subterrânea profunda
maxOffsetSky	5	Deslocamento aleatório aplicado aos pontos da grade do céu
maxOffsetLiquid	5	Deslocamento aleatório aplicado aos pontos da grade de superfície líquida
maxOffsetDungeonV2	18	Deslocamento aleatório aplicado aos pontos da grade de masmorras

Distâncias menores significam mais estruturas. Offsets menores deixam a colocação mais parecida com uma grade; offsets maiores tornam a colocação menos previsível.

Validação. As distâncias precisam ser no mínimo 1. Os offsets precisam estar entre 0 e 1073741823, o maior valor que o sorteador de colocação consegue usar com segurança. Um valor fora da sua faixa faz o BetterStructures registrar um aviso, gravar o padrão daquela chave de volta no config.yml e seguir em frente com o padrão, em vez de falhar a geração.

Os offsets são derivados da seed do mundo e do nome do tipo de estrutura, portanto a mesma seed produz o mesmo layout em todas as reinicializações.

Proteção do spawn

Chave	Padrão	Descrição
spawnProtectionRadius	100	Distância mínima em blocos a partir das coordenadas 0, 0 dentro da qual nenhuma estrutura é posicionada. Vale para todos os mundos. Defina como 0 para desativar.

Note que isso é medido a partir da origem do mundo, e não a partir do ponto de spawn de cada mundo.

Limites de altitude

Estes limitam onde as estruturas subterrâneas podem acabar, por dimensão. Uma estrutura cuja âncora cairia fora da faixa é puxada de volta para dentro dela.

Chave	Padrão	Descrição
lowestYNormalCustom	-60	Y mínimo para mundos NORMAL e CUSTOM
highestYNormalCustom	320	Y máximo para mundos NORMAL e CUSTOM
lowestYNether	4	Y mínimo no Nether
highestYNether	120	Y máximo no Nether
lowestYEnd	0	Y mínimo no End
highestYEnd	320	Y máximo no End

As estruturas do céu usam configurações próprias, e estas são deslocamentos acima do bloco mais alto da coluna, não níveis de Y absolutos. Um valor aleatório entre o mínimo e o máximo é sorteado para cada colocação.

Chave	Padrão	Descrição
normalCustomAirBuildingMinAltitude	80	Deslocamento mínimo no céu em mundos NORMAL e CUSTOM
normalCustomAirBuildingMaxAltitude	120	Deslocamento máximo no céu em mundos NORMAL e CUSTOM
endAirBuildMinAltitude	80	Deslocamento mínimo no céu no End
endAirBuildMaxAltitude	120	Deslocamento máximo no céu no End

O Nether ignora todas as quatro: as estruturas do céu ali são posicionadas dentro de uma bolha de ar encontrada varrendo entre o Y 45 e o Y 100.

Desempenho

Chave	Padrão	Descrição
percentageOfTickUsedForPasting	0.2	Fração de cada tick do servidor que o BetterStructures pode gastar colando blocos, de 0.01 (1%) a 1 (100%). Valores mais baixos reduzem o lag, mas fazem as construções aparecerem aos poucos de forma mais visível.
percentageOfTickUsedForPregeneration	0.1	Fração de cada tick do servidor usada pelo /bs pregenerate, com a mesma faixa de 0.01 a 1
pregenerationTPSPauseThreshold	12.0	A pré-geração pausa quando o TPS do servidor cai abaixo deste valor
pregenerationTPSResumeThreshold	14.0	A pré-geração retoma quando o TPS está neste valor ou acima. Mantenha-o mais alto que o limiar de pausa para evitar ciclos rápidos de pausa/retomada.
modularChunkPastingSpeed	10	Atualmente sem uso. A chave continua sendo escrita no config.yml, mas nada a lê, portanto alterá-la não tem efeito nenhum.

Administração e integração

Chave	Padrão	Descrição
warnAdminsAboutNewBuildings	true	Se os operadores são notificados quando uma estrutura é gerada por perto. /bs silent inverte este valor e o salva.
setupDone	false	Se o fluxo de configuração inicial já foi concluído. Defina como false e recarregue para que o /bs initialize peça a configuração novamente.
protectEliteMobsRegions	true	Se o BetterStructures cria proteção do WorldGuard para áreas de combate baseadas no EliteMobs. Requer tanto o WorldGuard quanto o EliteMobs.
regionProtectedMessage	&8[BetterStructures] &cDefeat the zone's bosses to edit blocks!	Mensagem mostrada quando um jogador tenta editar blocos dentro de uma dessas regiões protegidas
nightbreak.autoDownloadPluginUpdates	false	Se as atualizações de plugin e de conteúdo são baixadas automaticamente na inicialização. Esta é a chave por trás da opção Automatic Updates em /bs setup. Ainda é preciso reiniciar para aplicar uma atualização de plugin baixada.

---

ValidWorlds.yml

Este arquivo decide em quais mundos o BetterStructures gera conteúdo.

New worlds spawn structures: true
EliteMobs worlds excluded by default: true
Valid worlds:
  world: true
  world_nether: true
  world_the_end: true

Chave	Padrão	Descrição
New worlds spawn structures	true	Se um mundo que o BetterStructures ainda não viu é registrado como habilitado
Valid worlds	preenchido automaticamente	Uma entrada nomedomundo: true/false por mundo. Defina um mundo como false para interromper toda a geração de estruturas nele.
EliteMobs worlds excluded by default	escrito como true após a migração única	Marcador interno. Não edite.

Comportamento automático

• Mundos novos são registrados ao carregar. Um mundo que carrega pela primeira vez recebe uma entrada imediatamente, usando New worlds spawn structures como valor.
• Mundos gerenciados pelo EliteMobs são excluídos. O hub da guilda de aventureiros e as cópias de masmorras instanciadas são registrados como false mesmo quando New worlds spawn structures está como true, porque seus chunks vazios não construídos contam como chunks novos e faziam o BetterStructures decorar hubs de masmorras. A entrada ainda é escrita, então voltar a defini-la como true funciona, caso seja realmente isso que você quer.
• As entradas em_ existentes foram migradas uma única vez. Qualquer mundo em_ que estava como true apenas por causa do antigo padrão permissivo foi alterado para false uma única vez, e o marcador EliteMobs worlds excluded by default registra que essa migração já rodou. Um mundo que você reabilite deliberadamente depois disso continua habilitado entre reinicializações.
• Entradas mortas são removidas. Na inicialização, e cerca de dez segundos depois de um mundo ser descarregado, as entradas cujo mundo não está carregado nem presente no disco são removidas para que o arquivo não cresça indefinidamente.