Configuración Inicial de MegaBlock Survivors

El flujo de configuración de MegaBlock Survivors está construido alrededor de paquetes de contenido gestionados por Nightbreak, con soporte opcional de modelos a través de FreeMinecraftModels.

Requisitos

• Java 21
• Un servidor compatible con Paper/Spigot en la línea de API 1.21

Integraciones opcionales:

• FreeMinecraftModels para modelos personalizados de mobs y armas (dependencia suave)

Lo que MegaBlock Survivors Crea

Al iniciar, MegaBlock Survivors inicializa o utiliza estas rutas:

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

Configuración

config.yml contiene:

Clave	Tipo	Predeterminado	Descripción
setupDone	boolean	false	Rastrea si la guía de configuración inicial ha sido completada

Aviso de Primera Configuración

Cuando setupDone es false, el plugin muestra un aviso de configuración inicial a los jugadores con el permiso megablocksurvivors.* cuando se conectan. Esto los guía a través de la descarga inicial de contenido.

Flujo Recomendado para Primera Vez

1. Instala MegaBlock Survivors e inicia el servidor una vez.
2. Vincula tu cuenta de Nightbreak con /nightbreaklogin <token>.
3. Ejecuta /mbs downloadall para descargar todos los paquetes de contenido accesibles de MegaBlock Survivors en plugins/MegaBlockSurvivors/imports.
4. Ejecuta /mbs setup en cualquier momento para explorar, habilitar, deshabilitar o actualizar paquetes individuales.
5. Ejecuta /mbs reload después de descargar contenido para cargar los nuevos mapas y recursos.

/nightbreaklogin <token> es parte del flujo compartido de cuentas Nightbreak/MagmaCore, no un comando declarado en el plugin.yml de MegaBlock Survivors.

Paquetes de Contenido

Los paquetes de contenido se configuran a través de archivos YAML en la carpeta content_packages/. Cada paquete puede definir:

Campo	Tipo	Descripción
isEnabled	boolean	Si el paquete está activo
name	string	Nombre para mostrar del paquete
description	string list	Líneas de descripción
downloadLink	string	URL de descarga manual
version	integer	Número de versión del paquete
nightbreakSlug	string	Slug de contenido de Nightbreak para descargas automáticas
schematicFiles	string list	Archivos de esquemáticos incluidos en el paquete
worldFolders	string list	Carpetas de mundo incluidas
worldContainerFolders	string list	Carpetas de contenedor de mundo incluidas
modelFolders	string list	Carpetas de modelos para FreeMinecraftModels
markerFileName	string	Archivo marcador para detectar si el paquete está instalado
category	enum	FREE, PREMIUM o RESOURCES
toggleable	boolean	Si el paquete puede activarse/desactivarse

Notificaciones de Actualización de Versión

Cuando el plugin detecta una actualización de versión (comparando con version.txt), notifica a la consola y a todos los OPs en línea sobre el cambio de versión.