Configuração do BetterStructures

O BetterStructures ainda suporta importações manuais, mas o fluxo de trabalho recomendado atualmente prioriza o Nightbreak e é feito dentro do jogo.

Requisitos

• Suporte a schematics compatível com WorldEdit ou FAWE
• Runtime Java 21 para a linha de compilação atual

Fluxo de trabalho recomendado

1. Instale o BetterStructures e o WorldEdit, depois inicie o servidor uma vez.
2. Execute /bs initialize.
3. Vincule um token Nightbreak com /nightbreaklogin <token>.
4. Abra /bs setup para navegar pelos pacotes de estruturas e pacotes de módulos.
5. Use /bs downloadall para um bootstrap rápido (ele obtém uma atualização pendente do plugin e todo o conteúdo).
6. Use /bs updatecontent quando atualizações de pacotes estiverem disponíveis.

O Menu de Configuração Inicial

O /bs initialize abre um pequeno menu guiado. Até que uma das suas opções seja escolhida, todo jogador que possui betterstructures.* recebe uma mensagem de lembrete dez segundos depois de entrar. As três opções marcam a configuração como concluída, escrevendo setupDone: true no config.yml.

Opção	O que faz
Recommended Setup	Marca a configuração como concluída e imprime o caminho de três passos: obter um token em nightbreak.io/account, vinculá-lo com /nightbreaklogin <token> e depois abrir /bs setup.
Manual Setup	Marca a configuração como concluída e deixa o gerenciamento de conteúdo por sua conta, apontando para o /bs setup e para a pasta imports.
Use Current Content	Descarta o aviso e mantém o conteúdo que já estiver instalado, e em seguida executa um recarregamento. Se nenhum conteúdo estiver instalado, ele avisa e aponta para o /bs setup.

Se nem o WorldEdit nem o FastAsyncWorldEdit estiverem instalados, o terceiro espaço é substituído por um aviso dizendo para instalar um deles antes de continuar.

O Menu de Configuração

O /bs setup abre um menu paginado onde os pacotes são divididos em dois filtros: Pacotes de Estruturas e Pacotes de Módulos. Cada pacote mostra se está instalado, baixado mas não ativado, desatualizado ou se precisa de acesso Nightbreak, e ao clicar nele o instala/atualiza.

Junto aos pacotes, o menu também expõe controles compartilhados do MagmaCore integrados ao BetterStructures:

• Atualização do Plugin - mostra se uma compilação mais recente do BetterStructures está disponível e permite que você a baixe (um reinício a aplica). A verificação roda automaticamente na inicialização e é atualizada mais ou menos uma vez por hora, portanto um servidor recém-iniciado pode mostrar por um instante "Plugin Update Pending".
• Plugins Recomendados - abre a visão de recomendação de plugins complementares (igual a /bs recommendedplugins). O ícone fica verde assim que todas as recomendações listadas estiverem instaladas.
• Baixar Todo o Conteúdo - a entrada em massa acrescentada depois da lista de pacotes, equivalente a /bs downloadall.
• Atualizações Automáticas - uma alternância na barra de ferramentas para definir se o BetterStructures baixa atualizações de plugin e de conteúdo automaticamente na inicialização. Está desativada por padrão e é controlada pela chave nightbreak.autoDownloadPluginUpdates no config.yml. Um reinício ainda é necessário para aplicar uma atualização de plugin baixada.
• Dicas de instalação - o botão de informação, que imprime no chat o guia de configuração, a página de token da conta, o Discord de suporte e comandos de configuração clicáveis.

O /bs setup é recusado enquanto um recarregamento de conteúdo estiver em execução, já que o menu lê os mesmos registros que o processo de recarregamento está reconstruindo. Espere o recarregamento reportar sucesso e abra-o novamente.

Se os arquivos de um pacote acabarem danificados ou parcialmente apagados, o /bs setup não vai repará-los - ele compara versões e considera o pacote atualizado. Use /bs forcereinstallcontent <package|all> em vez disso.

Fallback de importação manual

As importações manuais ainda funcionam através de:

plugins/BetterStructures/imports

Mantenha os zips dos pacotes intactos, depois execute /bs reload se necessário. O /bs reload importa qualquer coisa que esteja nessa pasta como parte do recarregamento, portanto você não precisa reiniciar para detectar um pacote colocado ali.

Note que deixar arquivos em imports torna a inicialização mais lenta: quando a pasta não está vazia, o BetterStructures espera que os plugins listados no seu softdepend terminem de inicializar antes de iniciar, porque importar conteúdo para a pasta de dados de outro plugin significa que esse plugin tem de ser recarregado. Assim que a pasta ficar vazia novamente, o BetterStructures inicializa sem esperar.

Veja o guia compartilhado: Importações manuais vs gerenciamento no jogo.