Configuração do BetterStructures
Esta página descreve os dois ficheiros gerais de configuração escritos em plugins/BetterStructures. Para configurações do conteúdo, consulte Criar geradores, Criar estruturas, Criar tesouros e Masmorras modulares.
Ambos são relidos na thread do servidor por /bs reload. Não é necessário reiniciar o servidor para aplicar alterações nestes ficheiros.
Organização das pastas
| Caminho | Conteúdo |
|---|---|
config.yml | Definições gerais descritas abaixo |
ValidWorlds.yml | Ativação por mundo, descrita abaixo |
schematics/ | Estruturas .schem e configurações .yml geradas, pesquisadas recursivamente |
modules/ | Módulos de masmorras .schem e configurações .yml geradas, pesquisados recursivamente |
generators/ | Configurações de geradores |
module_generators/ | Configurações de geradores modulares |
treasures/ | Configurações de tesouros e tabelas de saque |
spawn_pools/ | Conjuntos de aparecimento usados pelas placas [pool: name] |
content_packages/ | Descritores usados pelo menu e pelos comandos de transferência |
components/ | Criada vazia no arranque para componentes auxiliares do conteúdo |
imports/ | Importações manuais de conteúdo |
.schematic_cache/ | Cache gerida de schematics convertidos; pode ser eliminada com segurança |
config.yml
Espaçamento das estruturas
O BetterStructures coloca estruturas numa grelha em losango baseada na seed, com uma grelha por tipo de estrutura. As distâncias definem o espaçamento entre pontos; os desvios deslocam aleatoriamente cada ponto para tornar as colocações menos regulares.
Ambos são medidos em chunks, não em blocos. distanceSurface: 27 corresponde aproximadamente a uma estrutura de superfície a cada 27 chunks, cerca de 432 blocos.
| Chave | Predefinição | Descrição |
|---|---|---|
distanceSurface | 27 | Espaçamento para SURFACE |
distanceShallow | 22 | Espaçamento para UNDERGROUND_SHALLOW |
distanceDeep | 22 | Espaçamento para UNDERGROUND_DEEP |
distanceSky | 90 | Espaçamento para SKY |
distanceLiquid | 60 | Espaçamento para LIQUID_SURFACE |
distanceDungeonV2 | 80 | Espaçamento para DUNGEON |
maxOffsetSurface | 5 | Desvio aleatório dos pontos de superfície |
maxOffsetShallow | 5 | Desvio aleatório dos pontos subterrâneos pouco profundos |
maxOffsetDeep | 5 | Desvio aleatório dos pontos subterrâneos profundos |
maxOffsetSky | 5 | Desvio aleatório dos pontos aéreos |
maxOffsetLiquid | 5 | Desvio aleatório dos pontos à superfície de líquidos |
maxOffsetDungeonV2 | 18 | Desvio aleatório dos pontos de masmorras |
Distâncias menores produzem mais estruturas. Desvios menores tornam a grelha mais evidente; desvios maiores tornam as posições menos previsíveis.
Validação: as distâncias devem ser pelo menos 1. Os desvios devem ficar entre 0 e 1073741823, o maior valor seguro para o gerador aleatório de posições. Um valor inválido gera um aviso, é substituído pela predefinição no config.yml e a geração continua com esse valor.
Os desvios derivam da seed do mundo e do nome do tipo de estrutura. A mesma seed produz a mesma distribuição após cada reinício.
Proteção do spawn
| Chave | Predefinição | Descrição |
|---|---|---|
spawnProtectionRadius | 100 | Distância mínima em blocos a partir de 0, 0, dentro da qual não são colocadas estruturas. Aplica-se a todos os mundos. Use 0 para desativar. |
A distância é medida a partir da origem do mundo, não do seu ponto de spawn.
Limites de altitude
Estas opções limitam a posição de estruturas subterrâneas por dimensão. Se a âncora ficar fora do intervalo, é ajustada para dentro dele.
| Chave | Predefinição | Descrição |
|---|---|---|
lowestYNormalCustom | -60 | Y mínimo em mundos NORMAL e CUSTOM |
highestYNormalCustom | 320 | Y máximo em 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 aéreas usam opções próprias: desvios acima do bloco mais alto da coluna, e não coordenadas Y absolutas. Cada colocação sorteia um valor entre o mínimo e o máximo.
| Chave | Predefinição | Descrição |
|---|---|---|
normalCustomAirBuildingMinAltitude | 80 | Desvio aéreo mínimo em NORMAL e CUSTOM |
normalCustomAirBuildingMaxAltitude | 120 | Desvio aéreo máximo em NORMAL e CUSTOM |
endAirBuildMinAltitude | 80 | Desvio aéreo mínimo no End |
endAirBuildMaxAltitude | 120 | Desvio aéreo máximo no End |
O Nether ignora estas quatro opções. As estruturas aéreas são colocadas numa bolsa de ar encontrada entre Y 45 e Y 100.
Desempenho
| Chave | Predefinição | Descrição |
|---|---|---|
percentageOfTickUsedForPasting | 0.2 | Parcela de cada tick que pode ser usada para colocar blocos, entre 0.01, 1%, e 1, 100%. Valores baixos reduzem o lag, mas tornam mais visível a construção gradual. |
percentageOfTickUsedForPregeneration | 0.1 | Parcela de cada tick usada por /bs pregenerate, também entre 0.01 e 1 |
pregenerationTPSPauseThreshold | 12.0 | Pausa a pré-geração abaixo deste TPS |
pregenerationTPSResumeThreshold | 14.0 | Retoma a pré-geração neste TPS ou acima. Mantenha-o superior ao limiar de pausa para evitar alternâncias rápidas. |
modularChunkPastingSpeed | 10 | Sem utilização atual. Continua a ser escrito em config.yml, mas nenhum código o lê; alterá-lo não tem efeito. |
Administração e integração
| Chave | Predefinição | Descrição |
|---|---|---|
warnAdminsAboutNewBuildings | true | Se os jogadores online com betterstructures.warn (operadores por predefinição) recebem uma mensagem clicável de teleporte quando uma estrutura termina de ser colada ou uma masmorra modular começa a ser gerada, em qualquer ponto do servidor. /bs silent altera e guarda este valor. |
setupDone | false | Indica se a configuração inicial terminou. Defina false e recarregue para voltar a apresentar a orientação de /bs initialize. |
protectEliteMobsRegions | true | Cria proteção WorldGuard para áreas de combate com EliteMobs. Exige WorldGuard e EliteMobs. |
regionProtectedMessage | &8[BetterStructures] &cDefeat the zone's bosses to edit blocks! | Mensagem ao tentar editar blocos numa dessas regiões protegidas |
nightbreak.autoDownloadPluginUpdates | false | Transfere atualizações do plugin e do conteúdo automaticamente no arranque. Corresponde ao botão de Atualizações automáticas em /bs setup. O conteúdo e as atualizações do plugin transferidos são usados após o próximo reinício, a menos que nightbreak.applyPluginUpdatesWithoutRestart aplique a atualização do plugin antes. |
nightbreak.applyPluginUpdatesWithoutRestart | never | Quando é aplicada uma atualização do plugin transferida. never aguarda o próximo reinício. when-empty aplica-a na próxima vez que não houver jogadores online, verificando a cada 30 segundos. immediately aplica-a assim que for transferida. Qualquer outro valor conta como never. Aplicar uma atualização recarrega o BetterStructures e os plugins do MagmaGuy que dependem dele, pelo que os bosses, arenas e instâncias de masmorras em curso terminam. Um plugin de outro autor que dependa do BetterStructures impede a substituição. /bs applypluginupdate aplica uma atualização preparada a pedido. |
ValidWorlds.yml
Este ficheiro determina em que mundos o BetterStructures gera conteúdo.
New worlds spawn structures: true
Valid worlds v2:
world: true
world_nether: true
world_the_end: true
| Chave | Predefinição | Descrição |
|---|---|---|
New worlds spawn structures | true | Ativa por predefinição os mundos ainda desconhecidos pelo BetterStructures |
Valid worlds v2 | preenchido automaticamente | Uma entrada worldname: true/false por mundo. Use false para impedir toda a geração de estruturas nesse mundo. |
Ao atualizar, um ValidWorlds.yml que contenha a chave antiga Valid worlds é movido intacto para plugins/MagmaCore/outdated files/BetterStructures/<archive batch>/ValidWorlds.yml. O BetterStructures gera um ficheiro de substituição com as predefinições atuais dos mundos. Reveja as escolhas anteriores no arquivo e volte a aplicar as pretendidas em Valid worlds v2; depois execute /bs reload. Não volte a colocar o ficheiro antigo sem o alterar, pois continuará a corresponder ao formato retirado.
Comportamento automático
- Mundos novos são registados ao carregar. A entrada é escrita imediatamente com o valor de
New worlds spawn structures. - Mundos geridos pelo EliteMobs são excluídos. O hub da guilda de aventureiros e as cópias de masmorras instanciadas recebem
false, mesmo comNew worlds spawn structures: true. Os seus chunks vazios contam como novos e anteriormente recebiam estruturas indesejadas. A entrada continua editável, podendo definirtruedeliberadamente. - Escolhas no formato atual são preservadas. O BetterStructures não deduz o proprietário pelo prefixo
em_nem altera opções já existentes emValid worlds v2. Usa o registo de mundos EliteMobs para as predefinições dos novos mundos. Um mundo EliteMobs explicitamente ativo mantém-se ativo e gera um aviso para o administrador decidir. Os ficheiros antigos comValid worldsseguem o processo de arquivamento e regeneração descrito acima. - Entradas sem mundo são removidas. No arranque e cerca de dez segundos após descarregar um mundo, são eliminadas entradas cujo mundo não esteja carregado nem exista no disco, evitando crescimento indefinido do ficheiro.