Configuração inicial do BetterStructures

O BetterStructures continua a aceitar importações manuais, mas recomenda-se atualmente gerir o conteúdo pelo Nightbreak, dentro do jogo.

Requisitos

• Suporte de schematics compatível com WorldEdit ou FAWE
• Java 21 para a linha de versões atual

Procedimento recomendado

1. Instale BetterStructures e WorldEdit e inicie o servidor uma vez.
2. Execute /bs initialize.
3. Associe um token Nightbreak com /nightbreaklogin <token>.
4. Abra /bs setup para consultar os pacotes de estruturas e de módulos.
5. Use /bs downloadall para a configuração rápida: transfere uma atualização pendente do plugin e todo o conteúdo.
6. Use /bs updatecontent quando houver atualizações de pacotes.

Menu inicial

/bs initialize abre um pequeno menu guiado. Até escolher uma opção, todos os jogadores com betterstructures.* recebem um lembrete dez segundos após entrar. As três opções marcam a configuração como concluída, escrevendo setupDone: true em config.yml.

Opção	Efeito
Configuração recomendada	Marca a configuração como concluída e apresenta três passos: obter um token em nightbreak.io/account, associá-lo com /nightbreaklogin <token> e abrir /bs setup.
Configuração manual	Marca a configuração como concluída e deixa a gestão do conteúdo ao administrador, indicando /bs setup e a pasta imports.
Usar o conteúdo atual	Fecha o aviso e conserva o conteúdo atual. Se o registo de schematics não estiver vazio, recarrega; caso contrário, informa que não há conteúdo instalado e indica /bs setup. Esta verificação não conta módulos.

Sem WorldEdit nem FastAsyncWorldEdit, o terceiro espaço apresenta um aviso para instalar um deles antes de continuar.

Menu de configuração

/bs setup abre um menu com páginas e dois filtros: Pacotes de estruturas e Pacotes de módulos. Cada pacote indica se está instalado, transferido mas desativado, desatualizado ou se exige acesso Nightbreak. A ação ao clicar depende desse estado: transferir, instalar, atualizar, desinstalar ou apresentar informações de acesso.

O menu também inclui os controlos partilhados do MagmaCore incorporado:

• Atualização do plugin: indica se existe uma versão BetterStructures mais recente e permite transferi-la. É aplicada ao reiniciar, a menos que execute /bs applypluginupdate ou defina nightbreak.applyPluginUpdatesWithoutRestart em config.yml como when-empty ou immediately. A verificação ocorre no arranque e é renovada aproximadamente de hora a hora; num servidor acabado de iniciar, pode aparecer temporariamente um estado de atualização pendente.
• Plugins recomendados: abre as recomendações de plugins complementares, tal como /bs recommendedplugins. O ícone fica verde quando todos os recomendados estão instalados.
• Transferir todo o conteúdo: entrada após a lista de pacotes, equivalente a /bs downloadall.
• Atualizações automáticas: ativa ou desativa a transferência automática de atualizações do plugin e do conteúdo no arranque. Está desativada por predefinição e corresponde a nightbreak.autoDownloadPluginUpdates em config.yml. As transferências automáticas de conteúdo ficam preparadas para o próximo reinício, sem provocar um recarregamento imediato. O reinício também aplica uma atualização do plugin transferida, a menos que nightbreak.applyPluginUpdatesWithoutRestart esteja definido como when-empty ou immediately (consulte Configuração).
• Dicas de instalação: botão informativo que apresenta no chat o guia, a página do token, o Discord de suporte e comandos de configuração clicáveis.

/bs setup é recusado durante um recarregamento de conteúdo, porque lê os mesmos registos que estão a ser reconstruídos. Aguarde pela conclusão bem-sucedida e volte a abrir o menu.

O menu não verifica a integridade dos ficheiros. Um pacote danificado ou parcialmente eliminado pode continuar a aparecer como atualizado se o seu caminho existir e a versão corresponder. Use /bs forcereinstallcontent <package|all> para o reparar; indique diretamente o slug se faltar a pasta inteira. A desinstalação mantém os ficheiros no disco. Define o isEnabled do pacote como false e recarrega, e o recarregamento ignora todos os schematics e módulos dentro da pasta desse pacote, incluindo as subpastas.

Importação manual

As importações manuais continuam a usar:

plugins/BetterStructures/imports

Mantenha os ZIPs intactos e execute /bs reload se necessário. O recarregamento importa o conteúdo dessa pasta, pelo que não precisa de reiniciar o servidor para importar um pacote colocado ali.

Deixar ficheiros em imports abranda o arranque: se a pasta não estiver vazia, o BetterStructures espera que os plugins de softdepend terminem a inicialização. Isto acontece porque importar para a pasta de outro plugin exige recarregá-lo. Com a pasta vazia, o BetterStructures inicializa sem essa espera.

Consulte o guia partilhado: Importações manuais e gestão no jogo.