Comandos do BetterStructures

Use /betterstructures ou /bs.

Configuração e conteúdo

Comando	Função
/bs	Ajuda principal
/bs initialize	Abre o menu inicial
/bs setup	Abre o menu de configuração e conteúdo
/bs recommendedplugins	Apresenta plugins complementares recomendados
/bs downloadall	Transfere a atualização do plugin, se existir, e todo o conteúdo disponível, e depois recarrega
/bs downloadallcontent	Transfere apenas todos os pacotes de conteúdo disponíveis
/bs updatecontent	Transfere atualizações de conteúdo desatualizado; alias /bs updateallcontent
/bs forcereinstallcontent <package|all>	Volta a transferir conteúdo pelo processo autenticado normal, mesmo com a versão atual instalada. As sugestões por Tab incluem all e todos os slugs Nightbreak.
/bs downloadpluginupdate	Transfere uma atualização pendente do plugin. É aplicada ao reiniciar, a menos que /bs applypluginupdate ou a opção nightbreak.applyPluginUpdatesWithoutRestart a apliquem antes.
/bs applypluginupdate	Aplica uma atualização do plugin já transferida sem reiniciar o servidor
/bs reload	Recarrega configurações e conteúdo, e importa conteúdo pendente
/bs version	Apresenta a versão do plugin

Sobre /bs reload

/bs reload já não desativa e reativa o plugin. Recarrega o conteúdo mantendo-o ativo: relê config.yml e ValidWorlds.yml na thread do servidor, e depois reconstrói as configurações de tesouros, geradores, geradores modulares, conjuntos de aparecimento, schematics, módulos e pacotes numa thread de trabalho. Os comandos, listeners e adaptador NMS permanecem registados.

Consequências:

• O recarregamento cancela a pré-geração e a geração modular em curso, e interrompe no ponto em que estiverem as colagens de estruturas e masmorras ainda em fila ou em curso. Os menus de configuração e configuração inicial também ficam indisponíveis durante o recarregamento.
• Durante o recarregamento, /bs place, /bs lootify, /bs pregenerate e /bs generateModules são recusados com uma mensagem de recarregamento em curso. As análises de chunks novos e de masmorras pendentes são conservadas até terminar com sucesso. Se um chunk em fila for descarregado, a análise espera que volte a carregar.
• Executar /bs reload novamente durante um recarregamento coloca o pedido em fila e desencadeia outro recarregamento completo no fim, para incluir ficheiros alterados entretanto.
• Se falhar, o BetterStructures desativa-se deliberadamente, evitando continuar com registos de conteúdo incompletos. Consulte a causa na consola, corrija-a e reinicie o servidor.

Sobre /bs forcereinstallcontent

As transferências normais ignoram pacotes cuja versão local coincide com a remota, pelo que não reparam ficheiros danificados ou parcialmente eliminados. forcereinstallcontent ignora essa comparação e volta a passar o pacote escolhido pelo mesmo processo autenticado de transferência, importação e recarregamento.

• all seleciona os pacotes atualmente considerados transferidos, instalados ou desatualizados. Se nenhum corresponder, o comando pede um slug explícito, adequado quando todos os ficheiros desapareceram.
• Um slug individual reinstala apenas esse pacote.
• Um slug desconhecido é rejeitado com uma indicação para usar as sugestões por Tab.

Sobre /bs applypluginupdate

/bs applypluginupdate instala, sem reiniciar, uma atualização do BetterStructures que já foi transferida e aguarda na pasta de atualizações do servidor. Desativa o BetterStructures e todos os plugins do MagmaGuy que dependem dele, substitui o jar e depois volta a carregá-los e ativá-los. Os plugins recarregados em conjunto são listados no chat. Se o novo jar não ativar, o jar anterior é carregado novamente e a atualização fica preparada para o próximo reinício.

O comando é recusado quando não há nenhuma atualização preparada, quando o jar preparado é inválido ou não é mais recente do que a versão em execução, ou quando um plugin de outro autor depende do BetterStructures. Nesse caso, reinicie o servidor. Os bosses, arenas e instâncias de masmorras em curso terminam quando o plugin é recarregado.

Para aplicar automaticamente as atualizações transferidas, defina nightbreak.applyPluginUpdatesWithoutRestart em config.yml (consulte Configuração).

Os comandos de transferência, atualização, recomendações e atualização do plugin pertencem ao sistema Nightbreak do MagmaCore incorporado. O menu também apresenta Atualização do plugin, Plugins recomendados e Atualizações automáticas; consulte Configuração inicial.

Utilitários e comandos administrativos

Comando	Função
/bs place <schematic> <type>	Tenta encaixar uma estrutura a partir do chunk atual do jogador; a procura pode escolher uma posição próxima. Tipos válidos: SURFACE, UNDERGROUND_SHALLOW, UNDERGROUND_DEEP, SKY, LIQUID_SURFACE
/bs lootify <generator> <rarity> <minAmount> <maxAmount> <weight>	Acrescenta o item na mão a uma tabela de tesouro. O gerador deve ser uma configuração de tesouro válida, a raridade deve existir, minAmount deve ser pelo menos 1 e maxAmount no máximo 64. É obrigatório ter um item na mão.
/bs pregenerate <centerType> <shape> <radiusInBlocks> <applyWorldBorder>	Pré-gera chunks com BetterStructures ativo no mundo atual do jogador. centerType aceita HERE, WORLD_CENTER e WORLD_SPAWN; shape aceita SQUARE e CIRCLE; applyWorldBorder aceita TRUE/FALSE.
/bs cancelPregenerate	Cancela a pré-geração ativa no mundo atual; alias /bs cancelpregenerate
/bs generateModules <generatorFile>	Gera conteúdo modular a partir de um ficheiro de gerador
/bs teleport <world> <x> <y> <z>	Teleporta para uma posição específica; alias /bs tp
/bs silent	Ativa ou desativa determinados avisos aos operadores

Tenha em conta estas restrições nos comandos utilitários:

• /bs place comunica uma tentativa de colocação, sem confirmar que a estrutura foi colocada.
• Execute /bs lootify no jogo com o item na mão principal. As quantidades e o peso devem ser inteiros. Escolha 1 <= minAmount <= maxAmount <= 64 e um peso positivo; o comando não rejeita todos os intervalos inválidos. Guardar uma entrada inicia um recarregamento do conteúdo.
• /bs pregenerate aceita um raio de zero ou mais blocos e arredonda por excesso para chunks inteiros. Com applyWorldBorder em TRUE, a conclusão define uma borda de mundo quadrada com diâmetro 2 × radiusInBlocks, mesmo para geração CIRCLE. Cancelar não define a borda nem desfaz os chunks gerados. Se um chunk não carregar, a pré-geração para, regista o chunk que falhou e deixa a borda do mundo inalterada.
• /bs teleport exige um mundo carregado e coordenadas inteiras; não aceita coordenadas relativas.

Permissões

Permissão	Descrição	Predefinição
betterstructures.setup	Acesso a /bs setup, /bs recommendedplugins, /bs downloadallcontent e /bs updatecontent	OP
betterstructures.initialize	Acesso a /bs initialize	OP
betterstructures.generatemodules	Acesso a /bs generateModules	OP
betterstructures.generatemodules.slowly	Registada no plugin.yml, mas nenhum comando atual a usa. Provavelmente um vestígio antigo.	OP
betterstructures.generatemodules.instantly	Registada no plugin.yml, mas nenhum comando atual a usa. Provavelmente um vestígio antigo.	OP
betterstructures.*	Permissão geral dos utilitários e comandos administrativos: place, pregenerate, cancelPregenerate, reload, teleport, version, lootify e ajuda /bs, além de /bs downloadall, /bs downloadpluginupdate, /bs applypluginupdate e /bs forcereinstallcontent. Atribuída aos operadores por predefinição.	OP
betterstructures.*	Também exigida por /bs silent, que altera a opção de avisos de todo o servidor.	OP
betterstructures.warn	Recebe as mensagens clicáveis de "novo edifício gerado" e "nova masmorra começou a ser gerada" enquanto warnAdminsAboutNewBuildings for true. Não está declarada no plugin.yml, pelo que o Bukkit a atribui aos operadores por predefinição.	OP

betterstructures.setup abrange a consulta e gestão de conteúdo, betterstructures.initialize a configuração inicial e betterstructures.generatemodules a geração de masmorras. /bs downloadall, que combina plugin e conteúdo, /bs downloadpluginupdate e /bs applypluginupdate, que tratam apenas do plugin, e /bs forcereinstallcontent, orientado para reparações, exigem a permissão administrativa betterstructures.*. As variantes .slowly e .instantly continuam declaradas, mas nenhum comando as verifica.

Qualquer uma de betterstructures.*, betterstructures.setup, betterstructures.initialize ou betterstructures.generatemodules permite aceder ao comando principal. Cada subcomando mantém a sua própria verificação, pelo que um administrador apenas de configuração não precisa da permissão geral.

betterstructures.* também controla o lembrete inicial: quem a tiver recebe uma mensagem dez segundos após cada entrada, indicando /bs initialize, enquanto setupDone for false em config.yml.