Configuração do Nightbreak e gestão de conteúdo

Esta página é o guia de configuração partilhado para os plugins geridos pelo Nightbreak.

Aplica-se diretamente a:

• EliteMobs
• BetterStructures
• FreeMinecraftModels
• EternalTD

Estes plugins agora partilham o mesmo ciclo de vida geral:

1. Instale o plugin e quaisquer dependências obrigatórias.
2. Inicie o servidor uma vez para que os ficheiros e menus sejam gerados.
3. Execute o comando de configuração inicial do plugin, se existir.
4. Vincule um token Nightbreak com /nightbreaklogin <token>.
5. Use o menu de configuração do plugin para navegar, instalar, ativar, desativar e atualizar conteúdo.
6. Use os comandos de download/atualização em massa do plugin quando quiser um arranque inicial mais rápido.

O que o MagmaCore realmente partilha

O MagmaCore é a camada partilhada por trás do fluxo gerido pelo Nightbreak. Fornece:

• o comando partilhado /nightbreaklogin <token>
• o armazenamento partilhado do token em plugins/MagmaCore/nightbreak.yml
• primitivas partilhadas do menu de configuração usadas pelos menus de configuração dos plugins
• verificações partilhadas de acesso, versão e download do Nightbreak
• lógica partilhada de download em massa que descarrega ficheiros para a pasta imports do plugin proprietário

Os comandos específicos de cada plugin, como /em initialize ou /bs setup, continuam a ser implementados por cada plugin. O MagmaCore fornece os sistemas partilhados que esses comandos utilizam.

Padrão partilhado de primeira utilização

A maioria dos plugins atuais geridos pelo Nightbreak expõe:

Plugin	Comando inicial	Menu de configuração	Instalação em massa	Atualização em massa
EliteMobs	/em initialize	/em setup	/em downloadall	/em updatecontent
BetterStructures	/bs initialize	/bs setup	/bs downloadall	/bs updatecontent
FreeMinecraftModels	/fmm initialize	/fmm setup	/fmm downloadall	/fmm updatecontent
EternalTD	/etd initialize	/etd setup	/etd downloadall	/etd updatecontent

initialize é um fluxo de orientação inicial. Não substitui o menu de configuração específico do plugin nem os comandos de gestão de conteúdo.

O MagmaCore também possui um sistema de inicialização separado no arranque do plugin, mas não é a mesma coisa que os comandos initialize orientados ao jogador documentados aqui.

Fluxo recomendado para proprietários de servidores

1. Instale primeiro o plugin

Coloque o ficheiro jar do plugin e quaisquer dependências obrigatórias em plugins/, depois inicie o servidor uma vez.

2. Execute o fluxo de configuração inicial

Se o plugin expõe um comando initialize, use-o primeiro. Os menus atuais são concebidos para:

• marcar a configuração inicial como concluída
• direcioná-lo para a vinculação de conta Nightbreak
• direcioná-lo para o menu de configuração atual
• esclarecer quando as importações manuais ainda são válidas

O comportamento do menu de primeira utilização é partilhado, mas o nome exato do comando e a lógica de seguimento permanecem específicos do plugin.

3. Vincule a sua conta Nightbreak

Aceda à página da conta Nightbreak, obtenha o seu token de servidor e execute:

/nightbreaklogin <token>

O token é partilhado através do MagmaCore, pelo que um token vinculado pode ser reutilizado por todos os plugins MagmaGuy compatíveis nesse servidor.

4. Use o menu de configuração para a gestão diária de conteúdo

Os menus de configuração são a fonte de verdade atual para:

• estados dos pacotes
• estados de acesso
• conteúdo instalado vs descarregado
• conteúdo parcialmente instalado que precisa de reparação
• conteúdo desatualizado
• filtros de conteúdo por categoria

Se tiver um token vinculado, os menus de configuração são o local recomendado para instalar e atualizar conteúdo.

5. Use a instalação/atualização em massa quando quiser velocidade

Use o comando downloadall quando quiser configurar um servidor rapidamente e o comando updatecontent quando quiser atualizar tudo o que estiver desatualizado.

O descarregador em massa partilhado só tenta pacotes geridos pelo Nightbreak que:

• têm um slug Nightbreak
• são acessíveis ao token vinculado
• ainda não foram descarregados ou estão marcados como desatualizados

A maioria dos plugins atuais recarrega-se automaticamente após downloads em massa bem-sucedidos.

Conceitos partilhados

Descarregado vs instalado

Um pacote pode existir localmente sem estar ativado. O significado exato varia ligeiramente consoante o plugin, mas o estado do menu de configuração importa mais do que a existência de um zip em imports.

Os downloads em massa também vão para a mesma pasta imports do plugin usada pelas importações manuais, antes de o passo de importação/recarga específico do plugin terminar.

Conteúdo com reconhecimento de acesso

Os menus de configuração agora podem distinguir entre conteúdo que:

• está disponível para o seu token
• precisa de ser comprado ou desbloqueado
• está instalado
• está apenas parcialmente instalado
• está descarregado mas desativado
• está desatualizado

As importações manuais continuam válidas

Os plugins geridos pelo Nightbreak ainda suportam fluxos de importação manual. A importação manual é agora o caminho alternativo, não o caminho predefinido. Consulte Importações manuais vs gestão no jogo.

Plugins que não usam este fluxo

Nem todos os plugins nesta wiki usam conteúdo descarregável gerido pelo Nightbreak.

• BetterFood não usa gestão de pacotes Nightbreak
• ResurrectionChest não usa gestão de pacotes Nightbreak
• WorldCannon não usa gestão de pacotes Nightbreak
• ResourcePackManager gere pacotes de recursos, não pacotes DLC Nightbreak