Pular para o conteúdo principal

BetterStructures FAQ

Se a sua pergunta é sobre a vinculação inicial com o Nightbreak, downloads de pacotes ou importações manuais, comece pelas páginas compartilhadas Globais primeiro. Esta FAQ contém apenas respostas específicas do BetterStructures.

Por que as estruturas não estão aparecendo?​

O motivo mais comum é que você está testando em terreno que já foi explorado antes da instalação do BetterStructures.

BetterStructures é projetado para gerar em terreno inexplorado, portanto não preenche retroativamente chunks antigos. Se você quer ver a geração natural rapidamente:

  • voe para chunks novos
  • gere um novo mundo de teste
  • ou use os comandos de colocação e configuração em vez de esperar pela geração natural

Por que o BetterStructures se desativou após um reload?​

O /bs reload limpa todos os registros de conteúdo antes que uma thread de trabalho os reconstrua. Se essa reconstrução lançar um erro, continuar deixaria um plugin que parece ativado mas tem conteúdo parcial ou vazio, então o BetterStructures deliberadamente falha de forma fechada e se desativa.

O erro real é impresso no console imediatamente antes da desativação. Corrija a configuração ou o schematic que ele nomeia e reinicie o servidor.

Por que meu comando está sendo recusado enquanto um reload está em execução?​

/bs place, /bs lootify, /bs pregenerate e /bs generateModules leem ou alteram os registros de conteúdo pertencentes à thread de recarregamento, portanto são recusados durante esse período com uma mensagem de "content is reloading". Chunks recém-gerados também são ignorados nessa janela. Espere o recarregamento reportar sucesso e tente novamente.

Executar /bs reload novamente durante um recarregamento não falha - seu pedido é colocado em fila, e mais um recarregamento completo é executado assim que o primeiro terminar, de modo que alterações de arquivo feitas durante o recarregamento ainda são detectadas.

Como eu paro os avisos de administrador sobre novas estruturas?​

BetterStructures tem um interruptor warnAdminsAboutNewBuildings no config.yml, e /betterstructures silent alterna esse valor para você.

Isso é útil durante a pré-geração ou outros testes intensivos de administração onde os avisos se tornam incômodos.

O que significa setupDone?​

setupDone rastreia se o fluxo de configuração inicial do BetterStructures foi concluído.

  • false significa que o fluxo de configuração ainda é considerado incompleto
  • true significa que o fluxo de configuração já foi concluído

Se você intencionalmente quiser re-executar a configuração, defina setupDone: false, recarregue o plugin e execute /bs initialize novamente.

O BetterStructures requer o WorldEdit?​

Sim. WorldEdit é uma dependência obrigatória no plugin.yml, então o BetterStructures não funciona sem ele.

Como funciona a integração com o WorldGuard?​

Se tanto o WorldGuard quanto o EliteMobs estiverem instalados, o BetterStructures registra e usa a flag betterstructures-protect para suas áreas protegidas. Ambos os plugins devem estar presentes para que a proteção WorldGuard seja ativada.

O toggle de configuração relevante é:

protectEliteMobsRegions: true

Defina como false se não quiser proteção WorldGuard gerenciada pelo BetterStructures para conteúdo suportado.

A mensagem exibida aos jogadores quando tentam quebrar ou colocar blocos em uma área protegida também é configurável:

regionProtectedMessage: "&8[BetterStructures] &cDefeat the zone's bosses to edit blocks!"

Posso adicionar itens personalizados ao tesouro do BetterStructures?​

Sim. BetterStructures inclui:

/betterstructures lootify <generator> <rarity> <minAmount> <maxAmount> <weight>

Use-o enquanto segura o item que deseja registrar. O comando escreve o item segurado na entrada do gerador de tesouro selecionado.

Regras de validação atuais da implementação do comando:

  • o gerador de tesouro deve existir
  • a raridade já deve existir nessa configuração de tesouro
  • minAmount deve ser pelo menos 1
  • maxAmount deve ser no máximo 64
  • o item segurado não pode ser ar

O BetterStructures suporta entradas de tesouro do MMOItems?​

Sim. O BetterStructures tem suporte ao MMOItems no projeto e o fluxo de tesouro existente suporta itens de terceiros. Para a sintaxe específica do MMOItems, mantenha os exemplos de configuração exatos nos seus arquivos de tesouro alinhados com a documentação atual da página de tesouro em vez de depender de trechos mais antigos da FAQ.

Como o EliteMobs e o BetterStructures trabalham juntos?​

BetterStructures tem integração suave com o EliteMobs.

Em alto nível:

  • BetterStructures pode colocar marcadores de conteúdo do EliteMobs dentro de estruturas geradas
  • BetterStructures também pode gerenciar áreas protegidas que importam para conteúdo apoiado pelo EliteMobs quando a integração está ativada

Para o fluxo de configuração compartilhado, vinculação de token e ciclo de vida de pacotes oficiais, use as páginas Globais e as páginas de configuração/conteúdo do BetterStructures em vez de tratar esta FAQ como a fonte principal.

Posso pré-gerar um mundo de forma mais segura?​

Sim. O BetterStructures expõe configurações de pré-geração orientadas ao desempenho no config.yml, incluindo:

  • percentageOfTickUsedForPregeneration (padrão: 0.1) - quanto de cada tick do servidor é usado para pré-geração de chunks
  • pregenerationTPSPauseThreshold (padrão: 12.0) - TPS abaixo do qual a pré-geração pausa
  • pregenerationTPSResumeThreshold (padrão: 14.0) - TPS acima do qual a pré-geração retoma

Para colagem normal de estruturas, a configuração principal de cadência é:

percentageOfTickUsedForPasting: 0.2

Valores menores reduzem o impacto por tick mas tornam a colagem de estruturas mais lenta.

Como são determinadas as localizações das estruturas?​

BetterStructures mantém controles de espaçamento e deslocamento aleatório por tipo de estrutura no config.yml. Veja Configuração para a referência completa.

Cada tipo de estrutura é posicionado na sua própria grade em losango derivada da seed. Os valores de distância e de deslocamento são medidos em chunks, não em blocos - um distanceSurface de 27 equivale a aproximadamente uma estrutura de superfície a cada 27 chunks, ou cerca de 432 blocos.

Os controles de distância principais são:

  • distanceSurface (padrão: 27)
  • distanceShallow (padrão: 22)
  • distanceDeep (padrão: 22)
  • distanceSky (padrão: 90)
  • distanceLiquid (padrão: 60)
  • distanceDungeonV2 (padrão: 80)

Os controles de deslocamento relacionados são:

  • maxOffsetSurface (padrão: 5)
  • maxOffsetShallow (padrão: 5)
  • maxOffsetDeep (padrão: 5)
  • maxOffsetSky (padrão: 5)
  • maxOffsetLiquid (padrão: 5)
  • maxOffsetDungeonV2 (padrão: 18)

As distâncias precisam ser no mínimo 1. Os deslocamentos precisam estar entre 0 e 1073741823 (o maior valor que o sorteador de colocação consegue usar com segurança). Se um valor estiver fora da sua faixa válida, o BetterStructures registra um aviso, grava o padrão daquela chave de volta no config.yml e continua com o padrão em vez de falhar a geração.

Na prática, isso significa que a geração é guiada pela seed e pela configuração em vez de reorganizar aleatoriamente a cada reinício.

O que modularChunkPastingSpeed faz?​

Nada, atualmente. O modularChunkPastingSpeed (padrão: 10) continua sendo escrito no config.yml, mas nada no plugin o lê, portanto alterá-lo não tem efeito. A cadência de colagem é definida pelo percentageOfTickUsedForPasting - use essa chave se quiser ajustar quanto de cada tick o BetterStructures gasta colocando blocos.

O que spawnProtectionRadius faz?​

spawnProtectionRadius (padrão: 100) define a distância mínima em blocos das coordenadas 0, 0 do mundo dentro da qual nenhuma estrutura será colocada. Isso se aplica a todos os mundos. Defina como 0 para desativar a proteção de spawn.

Como desativo estruturas em mundos específicos?​

BetterStructures mantém um arquivo de configuração ValidWorlds.yml que controla quais mundos são elegíveis para geração de estruturas. Cada mundo é listado com um toggle booleano:

New worlds spawn structures: true
Valid worlds:
  world: true
  world_nether: true
  world_the_end: true

Defina um mundo como false para impedir que o BetterStructures coloque quaisquer estruturas nesse mundo. A configuração New worlds spawn structures controla se mundos recém-detectados são automaticamente habilitados para geração de estruturas.

Vale a pena conhecer dois comportamentos:

  • Mundos gerenciados pelo EliteMobs são excluídos por padrão. Mundos que pertencem ao EliteMobs - 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. Seus chunks vazios não construídos contam como chunks novos, o que antes fazia o BetterStructures decorar hubs de masmorras. As entradas em_ existentes foram alteradas para false uma única vez por uma migração pontual; a chave marcadora EliteMobs worlds excluded by default no arquivo registra que isso já rodou, portanto, se você definir deliberadamente um mundo em_ de volta para true, a sua escolha sobrevive aos reinícios.
  • Entradas de mundos apagados são removidas. Na inicialização, e cerca de dez segundos depois de um mundo ser descarregado, o BetterStructures remove qualquer entrada de Valid worlds cujo mundo não esteja carregado nem presente no disco, para que o arquivo não acumule entradas mortas.

Como reparo um pacote de conteúdo quebrado ou parcialmente apagado?​

Use /bs forcereinstallcontent <package|all>. Os downloads normais comparam versões e pulam tudo o que já está atualizado, o que é exatamente o comportamento errado quando os arquivos em disco estão danificados. A reinstalação forçada empurra o pacote de volta pelo mesmo pipeline autenticado de download, importação e recarregamento, independentemente da versão.

all cobre todos os pacotes que o BetterStructures atualmente vê como baixados, instalados ou desatualizados. Se os arquivos de um pacote sumiram por completo, o BetterStructures deixa de vê-lo, então indique o slug dele diretamente - o tab completion lista todos os slugs conhecidos.