Importações manuais vs gestão no jogo

Os plugins geridos pelo Nightbreak agora preferem a configuração e gestão de conteúdo no jogo, mas as importações manuais continuam a existir como alternativa.

Recomendado: Gestão no jogo

Use o menu de configuração junto com um token Nightbreak vinculado quando quiser:

• navegação de conteúdo com reconhecimento de acesso
• instalação com um clique ou guiada por menu
• comandos de download e atualização em massa
• verificações automáticas de pacotes desatualizados
• um fluxo de trabalho que corresponde à base de código atual

Este é o caminho preferido para:

• EliteMobs
• BetterStructures
• FreeMinecraftModels
• EternalTD
• ResurrectionChest
• WorldCannon

Todos os seis usam o importador partilhado, por isso todos os seis também aceitam a alternativa manual descrita abaixo.

Alternativa: Importações manuais

As importações manuais continuam a ser úteis quando:

• já tem os zips dos pacotes descarregados
• está a mover ficheiros entre servidores
• quer trabalhar offline do Nightbreak durante os testes
• um pacote está a ser intencionalmente distribuído fora do caminho de download no jogo

Os downloads em massa do Nightbreak também terminam na pasta imports do plugin. A diferença é que o caminho no jogo trata das verificações de acesso e do passo de download por si.

Mapa de pastas de importação

Plugin	Pasta de importação
EliteMobs	plugins/EliteMobs/imports
BetterStructures	plugins/BetterStructures/imports
FreeMinecraftModels	plugins/FreeMinecraftModels/imports
EternalTD	plugins/EternalTD/imports
ResurrectionChest	plugins/ResurrectionChest/imports
WorldCannon	plugins/CannonRTP/imports

A pasta do plugin WorldCannon chama-se CannonRTP — esse é o nome interno do plugin, e é aí que ficam tanto a sua pasta imports como o conteúdo instalado.

Regras de importação manual

• Mantenha o pacote descarregado comprimido, a menos que a documentação específica do plugin diga o contrário.
• Coloque o pacote na pasta imports correta.
• Recarregue ou reinicie o plugin se a documentação específica do plugin o exigir.
• Volte a abrir o menu de configuração depois para confirmar o estado de instalação.

O importador partilhado pode processar:

• pacotes .zip colocados em imports
• certas pastas já descomprimidas se incluírem pack.meta
• ficheiros .bbmodel para FreeMinecraftModels

Os arquivos são extraídos para uma pasta de preparação oculta dentro de imports e só são instalados a partir daí. O FMM limpa essa pasta de preparação depois de um sucesso ou de uma falha, por isso importações falhadas normais deixam o zip original pronto para nova tentativa, em vez de um pacote meio extraído visível ao lado dele.

O que o importador aceita

O pack.meta decide para onde vai o conteúdo

Um pacote pode incluir um ficheiro pack.meta no nível superior a indicar a plataforma de plugin a que se destina — elitemobs, betterstructures, freeminecraftmodels, eternaltd, extractioncraft, resurrectionchest, megablocksurvivors ou worldcannon (também aceite como cannonrtp ou world_cannon). Esse nome é comparado sem distinção entre maiúsculas e minúsculas, e espaços em branco à volta, fins de linha e uma marca de ordem de bytes inicial são ignorados, por isso um ficheiro guardado por um editor de Windows funciona sem problemas.

Se o arquivo não tiver pack.meta, é tratado como um pacote para o plugin em cuja pasta imports foi colocado.

Se o pack.meta indicar algo que o importador não conhece, o pacote é rejeitado e o zip é deixado em imports para que o possa corrigir e tentar novamente.

Os nomes das pastas de nível superior têm de ser reconhecidos

O importador encaminha cada pasta de nível superior do pacote para um destino com base no nome. Alguns nomes funcionam para todas as plataformas:

Pasta	Vai para
worldcontainer	O contentor de mundos do servidor (cada subpasta torna-se um mundo)
models ou modelengine	A pasta models do FreeMinecraftModels, ou a pasta blueprints do ModelEngine se apenas o ModelEngine estiver instalado
scripts	plugins/FreeMinecraftModels/scripts
pack.meta	Ignorado — são metadados, não conteúdo

Todo o resto é resolvido por plataforma (por exemplo, custombosses, customitems e content_packages para o EliteMobs; schematics, spawn_pools e components para o BetterStructures).

Uma pasta de nível superior que o importador não reconheça para essa plataforma faz com que o pacote inteiro seja rejeitado, em vez de parcialmente instalado, e o arquivo é mantido. Se o seu pacote não importar, a consola indica a pasta problemática.

As importações falhadas são revertidas

Uma importação é aplicada como uma única transação. Os ficheiros existentes são copiados para segurança antes de serem substituídos, as pastas de mundo substituídas são movidas para o lado em vez de eliminadas, e uma falha a meio do processo desencadeia a reversão de todos os destinos que o pacote tocou. O zip permanece em imports, por isso repetir a tentativa é seguro. Se a própria reversão encontrar um erro do sistema de ficheiros, a consola comunica explicitamente que a reversão ficou incompleta e diz-lhe para inspecionar os destinos registados antes de tentar de novo.

O arquivo só é eliminado depois de a importação ter sido totalmente confirmada. Se vir um pacote ainda em imports após uma recarga, é o importador a dizer-lhe que não instalou — verifique a consola para saber o motivo.

Diferenças importantes

Caminho no jogo

• com reconhecimento de token
• pode mostrar conteúdo bloqueado e desatualizado
• normalmente recarrega automaticamente após operações em massa
• reflete o fluxo de trabalho administrativo atualmente previsto

Caminho manual

• funciona sem acesso a downloads no jogo
• requer que gira os ficheiros zip por si próprio
• pode exigir uma recarga do plugin
• pode deixar conteúdo num estado de descarregado-mas-não-ativado dependendo do plugin
• pode expor problemas de estrutura do pacote que o caminho de acesso no jogo normalmente ocultaria até ao momento da instalação