Pacotes de conteúdo do BetterStructures
O BetterStructures trata atualmente o conteúdo oficial como pacotes geridos, em vez de depender exclusivamente de importações manuais.
Comandos principais
| Comando | Função |
|---|---|
/bs initialize | Configuração inicial |
/bs setup | Consulta e gestão do estado dos pacotes |
/bs downloadall | Transfere a atualização do plugin, se existir, e todo o conteúdo disponível, e depois recarrega |
/bs downloadallcontent | Transfere apenas o conteúdo disponível, sem atualizar o plugin |
/bs updatecontent | Atualiza conteúdo desatualizado; alias /bs updateallcontent |
/bs forcereinstallcontent <package|all> | Volta a transferir conteúdo mesmo com a versão atual instalada, para reparar pacotes danificados ou parcialmente eliminados |
/bs recommendedplugins | Lista os plugins complementares recomendados |
/nightbreaklogin <token> | Regista o token Nightbreak pelo sistema partilhado |
Os comandos de transferência e atualização usam o sistema Nightbreak do MagmaCore incluído no BetterStructures para verificar o token e o acesso e transferir os ficheiros. Depois, o BetterStructures importa o conteúdo pelo seu próprio processo de recarregamento.
Tipos de pacotes
Cada pacote declara contentPackageType. O menu oferece um filtro por tipo:
contentPackageType | Filtro do menu | Destino dos ficheiros |
|---|---|---|
STRUCTURE, predefinido | Pacotes de estruturas | plugins/BetterStructures/schematics/<folderNameV2> |
MODULAR | Pacotes de módulos | plugins/BetterStructures/modules/<folderNameV2> |
Use /bs setup para filtrar e consultar os pacotes, em vez de depender de listas antigas.
Campos de configuração dos pacotes
Cada pacote tem uma configuração em plugins/BetterStructures/content_packages. Raramente é preciso editá-la manualmente: é fornecida pelo plugin para acompanhar o estado do pacote. Os campos são:
| Chave | Predefinição | Descrição |
|---|---|---|
isEnabled | true | Indicador de instalação do pacote alterado pelo menu. Quando é false, nada dentro da pasta do pacote é carregado; veja abaixo. |
name | — | Nome apresentado no menu |
description | — | Linhas de descrição do menu |
downloadLink | — | Ligação de transferência manual apresentada quando o pacote não tem nightbreakSlug; as transferências geridas usam o slug |
version | 0 | Versão local comparada com a remota para detetar conteúdo desatualizado |
folderNameV2 | — | Subpasta dos ficheiros em schematics ou modules, conforme o tipo |
contentPackageType | STRUCTURE | STRUCTURE ou MODULAR |
nightbreakSlug | — | Identificador Nightbreak usado no acesso, nas transferências e como seletor de /bs forcereinstallcontent |
Instalar ou desinstalar um pacote a partir do menu altera apenas o isEnabled do pacote e depois desencadeia um recarregamento. Não edita as configurações de schematics ou módulos dentro do pacote. A desinstalação mantém os ficheiros no disco.
Enquanto um pacote tiver isEnabled: false, os carregadores de schematics e módulos ignoram toda a sua pasta, schematics/<folderNameV2> ou modules/<folderNameV2>, incluindo as subpastas. Isto aplica-se tanto aos pacotes STRUCTURE como aos MODULAR. Dentro de um pacote ativo, cada configuração de schematic e de módulo continua a ter o seu próprio isEnabled.
Conteúdo dos pacotes
Um pacote do BetterStructures é um zip cujo pack.meta declara betterstructures. Um zip sem pack.meta colocado em plugins/BetterStructures/imports é tratado da mesma forma. As pastas de nível superior são extraídas pelo nome:
| Pasta no pacote | Destino |
|---|---|
content_packages, schematics, modules, module_generators, generators, treasures, spawn_pools, components | A pasta com o mesmo nome em plugins/BetterStructures |
custombosses, customitems, customtreasurechests, powers, enchantments | A pasta com o mesmo nome em plugins/EliteMobs |
models ou modelengine | A pasta de modelos do FreeMinecraftModels, ou a pasta blueprints do ModelEngine quando só o ModelEngine está instalado |
scripts | plugins/FreeMinecraftModels/scripts |
freeminecraftmodels, elitemobs, betterstructures | A raiz da pasta de dados desse plugin, mantendo a estrutura interna, por exemplo freeminecraftmodels/enchantments |
worldcontainer | O contentor de mundos do servidor |
Uma pasta de nível superior que não conste desta tabela faz com que o importador rejeite o pacote inteiro. Consulte Importações manuais vs gestão no jogo para as regras de importação partilhadas.
Quando um pacote acrescenta conteúdo do EliteMobs, o BetterStructures recarrega o EliteMobs após a importação. Quando o pacote de outro plugin importa ficheiros para a pasta do BetterStructures, o BetterStructures executa um recarregamento do conteúdo assim que o seu próprio arranque termina.
Estados dos pacotes
Consoante o pacote e o estado do token, o BetterStructures distingue:
- conteúdo instalado
- conteúdo transferido mas desativado
- conteúdo desatualizado
- conteúdo que exige acesso Nightbreak
O menu considera um pacote transferido se o seu caminho existir e combina essa informação com o indicador isEnabled do pacote para determinar se está instalado. Trata-se de um indicador de estado, não de uma verificação de integridade: uma pasta vazia ou danificada pode continuar a aparecer como instalada. Use /bs forcereinstallcontent <package|all> para reparar os ficheiros. all seleciona os pacotes detetados como transferidos, instalados ou desatualizados; indique diretamente o slug se faltar a pasta inteira do pacote.
Importação manual
As importações manuais continuam a usar:
plugins/BetterStructures/imports
Mantenha os ZIPs intactos e recarregue o BetterStructures se necessário. A importação manual continua suportada, embora já não seja o procedimento principal documentado.