Comandos do BetterStructures

Use /betterstructures ou /bs.

Configuração e Conteúdo

Comando	Propósito
/bs	Comando principal de ajuda e status
/bs initialize	Fluxo de configuração inicial (abre o menu de configuração inicial)
/bs setup	Abre o menu de configuração/conteúdo
/bs recommendedplugins	Mostra plugins complementares que funcionam bem com o BetterStructures
/bs downloadall	Baixa a atualização do plugin (se houver) e todo o conteúdo disponível, depois recarrega
/bs downloadallcontent	Baixa apenas todos os pacotes de conteúdo disponíveis (sem atualização do plugin)
/bs updatecontent	Baixa atualizações para conteúdo desatualizado (alias: /bs updateallcontent)
/bs forcereinstallcontent <package|all>	Baixa o conteúdo novamente pelo pipeline autenticado normal mesmo quando a versão instalada já está atualizada. O tab completion oferece all mais todos os slugs de pacotes Nightbreak.
/bs downloadpluginupdate	Baixa uma atualização pendente do plugin (requer reinício para aplicar)
/bs reload	Recarrega as configurações e o conteúdo do BetterStructures, e importa conteúdo pendente
/bs version	Mostra a versão do plugin

Sobre o /bs reload

O /bs reload já não desativa e reativa o plugin. Ele agora realiza um recarregamento de conteúdo no lugar: config.yml e ValidWorlds.yml são relidos na thread do servidor, e depois as configurações de tesouro, gerador, gerador de módulos, spawn-pool, schematic, módulo e pacote de conteúdo são reconstruídas em uma thread de trabalho. Comandos, listeners e o adaptador NMS permanecem registrados.

Consequências que vale a pena conhecer:

• Enquanto um recarregamento está em execução, /bs place, /bs lootify, /bs pregenerate e /bs generateModules são recusados com uma mensagem de "content is reloading", e chunks recém-gerados são ignorados em vez de analisados.
• Se você disparar /bs reload novamente enquanto um já está em andamento, seu pedido é colocado em fila e um segundo recarregamento completo é executado depois, de modo que um arquivo alterado durante o recarregamento ainda é detectado.
• Se o recarregamento falhar, o BetterStructures se desativa de propósito em vez de continuar com registros de conteúdo pela metade. Verifique o console para descobrir a causa e reinicie o servidor após corrigi-la.

Sobre o /bs forcereinstallcontent

Os downloads normais pulam um pacote cuja versão local já corresponde à remota, o que os torna inúteis quando os arquivos em disco foram danificados ou parcialmente apagados. O forcereinstallcontent ignora essa verificação de versão e empurra o pacote selecionado de volta pelo mesmo pipeline autenticado de download, importação e recarregamento.

• all seleciona todos os pacotes que o BetterStructures atualmente considera baixados, instalados ou desatualizados. Se nada corresponder, o comando recusa e pede que você indique um slug diretamente - que é justamente o que você quer quando os arquivos de um pacote sumiram por completo.
• Indicar um único slug reinstala apenas aquele pacote.
• Um slug desconhecido é rejeitado com uma mensagem que aponta para o tab completion.

Os comandos de download/atualização, de plugins recomendados e de atualização do plugin são fornecidos pelo sistema compartilhado MagmaCore Nightbreak que está integrado ao BetterStructures. O mesmo menu de configuração exibe uma entrada de Atualização do Plugin, uma entrada de Plugins Recomendados e uma alternância de Atualizações Automáticas (veja Configuração Inicial).

Comandos Utilitários e de Admin

Comando	Propósito
/bs place <schematic> <type>	Coloca uma estrutura manualmente. Tipos válidos: SURFACE, UNDERGROUND_SHALLOW, UNDERGROUND_DEEP, SKY, LIQUID_SURFACE
/bs lootify <generator> <rarity> <minAmount> <maxAmount> <weight>	Adiciona o item segurado a uma tabela de tesouro. O gerador deve ser uma configuração de tesouro válida, a raridade deve existir nessa configuração, minAmount deve ser pelo menos 1, maxAmount deve ser no máximo 64, e você deve estar segurando um item.
/bs pregenerate <centerType> <shape> <radiusInBlocks> <applyWorldBorder>	Pré-gera chunks com BetterStructures ativado. O mundo é derivado do mundo atual do jogador. centerType: HERE, WORLD_CENTER, WORLD_SPAWN. shape: SQUARE, CIRCLE. applyWorldBorder: TRUE/FALSE.
/bs cancelPregenerate	Cancela a pré-geração ativa no mundo atual do jogador (alias: /bs cancelpregenerate)
/bs generateModules <generatorFile>	Gera conteúdo modular a partir de um arquivo gerador de módulos
/bs teleport <world> <x> <y> <z>	Teleporta para uma localização específica (alias: /bs tp)
/bs silent	Alterna certos avisos de operador

Permissões

Permissão	Descrição	Padrã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	Registrado no plugin.yml mas não utilizado atualmente por nenhum comando no código-fonte. Provavelmente vestigial.	OP
betterstructures.generatemodules.instantly	Registrado no plugin.yml mas não utilizado atualmente por nenhum comando no código-fonte. Provavelmente vestigial.	OP
betterstructures.*	Wildcard para comandos utilitários e de admin (place, pregenerate, cancelPregenerate, reload, teleport, version, lootify, ajuda do /bs) além dos comandos de conteúdo de admin /bs downloadall, /bs downloadpluginupdate e /bs forcereinstallcontent. Mantido pelos OPs por padrão.	OP
(nenhuma)	/bs silent não possui controle de permissão no código-fonte — qualquer remetente pode executá-lo.	—

betterstructures.setup cobre os comandos de navegação/gerenciamento de conteúdo, betterstructures.initialize cobre a configuração inicial e betterstructures.generatemodules cobre a geração de masmorras. O comando combinado de plugin-e-conteúdo /bs downloadall, o comando apenas-plugin /bs downloadpluginupdate e o comando de reparo /bs forcereinstallcontent são controlados pelo wildcard de admin betterstructures.*. As variantes .slowly e .instantly ainda estão declaradas no plugin.yml, mas nenhum comando as verifica atualmente.

betterstructures.* também controla o lembrete de configuração inicial: jogadores que a possuem recebem uma mensagem única ao entrar apontando para /bs initialize, até que setupDone seja definido como true no config.yml.