Setup do Nightbreak e gerenciamento de conteúdo

Esta página é o guia de setup compartilhado para os plugins gerenciados pelo Nightbreak.

Ela se aplica diretamente a:

• EliteMobs
• BetterStructures
• FreeMinecraftModels
• EternalTD

Esses plugins agora compartilham o mesmo ciclo geral:

1. Instale o plugin e quaisquer dependências obrigatórias.
2. Inicie o servidor uma vez para gerar arquivos e menus.
3. Execute o comando de setup inicial do plugin, se ele existir.
4. Vincule um token do Nightbreak com /nightbreaklogin <token>.
5. Use o menu de setup 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 bootstrap inicial mais rápido.

O que o MagmaCore realmente compartilha

O MagmaCore é a camada compartilhada por trás do fluxo gerenciado pelo Nightbreak. Ele fornece:

• o comando compartilhado /nightbreaklogin <token>
• o armazenamento compartilhado do token em plugins/MagmaCore/nightbreak.yml
• primitivas compartilhadas de menu de setup usadas pelos menus de setup dos plugins
• verificações compartilhadas de acesso, versão e download do Nightbreak
• lógica compartilhada de download em massa que baixa arquivos para a pasta imports do plugin dono

Os comandos específicos de cada plugin, como /em initialize ou /bs setup, continuam sendo implementados por cada plugin. O MagmaCore fornece os sistemas compartilhados que esses comandos usam.

Padrão compartilhado de primeiro setup

A maioria dos plugins atualmente gerenciados pelo Nightbreak expõe:

Plugin	Comando inicial	Menu de setup	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 para a primeira configuração. Ele não substitui o menu de setup específico do plugin nem os comandos de gerenciamento de conteúdo.

O MagmaCore também tem um sistema separado de inicialização no startup do plugin, mas isso não é a mesma coisa que os comandos initialize voltados para jogadores documentados aqui.

Fluxo recomendado para donos de servidor

1. Instale o plugin primeiro

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

2. Execute o fluxo de setup inicial

Se o plugin expuser um comando initialize, use-o primeiro. Os menus atuais foram feitos para:

• marcar o setup inicial como concluído
• apontar você para a vinculação da conta Nightbreak
• direcionar você para o menu de setup atual
• esclarecer quando importações manuais ainda são válidas

O comportamento do menu de primeira configuração é compartilhado, mas o nome exato do comando e a lógica posterior continuam específicos de cada plugin.

3. Vincule sua conta Nightbreak

Vá até a página da conta Nightbreak, obtenha o token do seu servidor e execute:

/nightbreaklogin <token>

O token é compartilhado através do MagmaCore, então um único token vinculado pode ser reutilizado por todos os plugins compatíveis do MagmaGuy nesse servidor.

4. Use o menu de setup para o gerenciamento diário de conteúdo

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

• estado dos pacotes
• estado de acesso
• conteúdo instalado vs baixado
• conteúdo parcialmente instalado que precisa de reparo
• conteúdo desatualizado
• filtros de conteúdo por categoria

Se você tiver um token vinculado, os menus de setup são o lugar recomendado para instalar e atualizar conteúdo.

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

Use o comando downloadall quando quiser fazer o bootstrap do servidor rapidamente e o updatecontent quando quiser atualizar tudo o que estiver desatualizado.

O downloader em massa compartilhado só tenta pacotes gerenciados pelo Nightbreak que:

• tenham um slug do Nightbreak
• sejam acessíveis ao token vinculado
• ainda não tenham sido baixados ou estejam marcados como desatualizados

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

Conceitos compartilhados

Baixado vs instalado

Um pacote pode existir localmente sem estar ativado. O significado exato varia um pouco entre plugins, mas o estado no menu de setup importa mais do que a existência de um zip em imports.

Downloads em massa também terminam na mesma pasta imports do plugin usada por importações manuais antes da etapa de importação/reload específica do plugin ser concluída.

Conteúdo com reconhecimento de acesso

Os menus de setup agora conseguem distinguir conteúdo que:

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

Importações manuais ainda são válidas

Os plugins gerenciados pelo Nightbreak ainda suportam fluxos de importação manual. A importação manual agora é o caminho alternativo, não o padrão. Veja Importações manuais vs gerenciamento in-game.

Plugins que não usam esse fluxo

Nem todo plugin desta wiki usa conteúdo baixável gerenciado pelo Nightbreak.

• BetterFood não usa gerenciamento de pacotes do Nightbreak
• ResurrectionChest não usa gerenciamento de pacotes do Nightbreak
• WorldCannon não usa gerenciamento de pacotes do Nightbreak
• ResourcePackManager gerencia resource packs, não pacotes DLC do Nightbreak