Configuração do MegaBlock Survivors

O fluxo de configuração do MegaBlock Survivors é construído em torno de pacotes de conteúdo gerenciados pelo Nightbreak, com suporte opcional a modelos através do FreeMinecraftModels.

Requisitos

• Java 21
• Um servidor compatível com Paper/Spigot na linha de API 1.21

Integrações opcionais:

• FreeMinecraftModels para modelos personalizados de mobs e armas (dependência opcional)

O Que o MegaBlock Survivors Cria

Na inicialização, o MegaBlock Survivors inicializa ou utiliza estes caminhos:

plugins/MegaBlockSurvivors/config.yml
plugins/MegaBlockSurvivors/content_packages/
plugins/MegaBlockSurvivors/imports/
plugins/MegaBlockSurvivors/worlds/
plugins/MegaBlockSurvivors/leaderboard.yml
plugins/MegaBlockSurvivors/version.txt

Configuração

config.yml contém:

Chave	Tipo	Padrão	Descrição
setupDone	boolean	false	Rastreia se a orientação de configuração inicial foi concluída

Aviso de Configuração Inicial

Quando setupDone é false, o plugin mostra um aviso de configuração inicial para jogadores com a permissão megablocksurvivors.* quando entram. Isso os guia pelo download de conteúdo inicial.

Fluxo Recomendado Para a Primeira Vez

1. Instale o MegaBlock Survivors e inicie o servidor uma vez.
2. Vincule sua conta Nightbreak com /nightbreaklogin <token>.
3. Execute /mbs downloadall para baixar todos os pacotes de conteúdo acessíveis do MegaBlock Survivors em plugins/MegaBlockSurvivors/imports.
4. Execute /mbs setup a qualquer momento para navegar, ativar, desativar ou atualizar pacotes individuais.
5. Execute /mbs reload após baixar conteúdo para carregar os novos mapas e recursos.

/nightbreaklogin <token> faz parte do fluxo de conta compartilhado Nightbreak/MagmaCore, não é um comando declarado no plugin.yml do MegaBlock Survivors.

Pacotes de Conteúdo

Pacotes de conteúdo são configurados via arquivos YAML na pasta content_packages/. Cada pacote pode definir:

Campo	Tipo	Descrição
isEnabled	boolean	Se o pacote está ativo
name	string	Nome de exibição do pacote
description	lista de string	Linhas de descrição
downloadLink	string	URL de download manual
version	integer	Número de versão do pacote
nightbreakSlug	string	Slug de conteúdo Nightbreak para downloads automáticos
schematicFiles	lista de string	Arquivos schematic incluídos no pacote
worldFolders	lista de string	Pastas de mundo incluídas
worldContainerFolders	lista de string	Pastas de contêiner de mundo incluídas
modelFolders	lista de string	Pastas de modelos para FreeMinecraftModels
markerFileName	string	Arquivo marcador para detectar se o pacote está instalado
category	enum	FREE, PREMIUM ou RESOURCES
toggleable	boolean	Se o pacote pode ser alternado entre ligado/desligado

Notificações de Atualização de Versão

Quando o plugin detecta uma atualização de versão (comparando com version.txt), ele notifica o console e todos os OPs online sobre a mudança de versão.