Configuración de Nightbreak y gestión de contenido

Esta página es la guía de configuración compartida para los plugins gestionados por Nightbreak.

Se aplica directamente a:

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

Estos plugins ahora comparten el mismo ciclo de vida general:

1. Instala el plugin y cualquier dependencia obligatoria.
2. Inicia el servidor una vez para que se generen los archivos y menús.
3. Ejecuta el comando de configuración inicial del plugin si tiene uno.
4. Vincula un token de Nightbreak con /nightbreaklogin <token>.
5. Usa el menú de configuración del plugin para explorar, instalar, habilitar, deshabilitar y actualizar contenido.
6. Usa los comandos de descarga/actualización masiva del plugin cuando quieras un arranque inicial más rápido.

Qué comparte realmente MagmaCore

MagmaCore es la capa compartida detrás del flujo gestionado por Nightbreak. Proporciona:

• el comando compartido /nightbreaklogin <token> (permiso nightbreak.login, por defecto OP)
• el comando compartido /nightbreaklogout para desconectar el servidor de su cuenta de Nightbreak (permiso nightbreak.login, por defecto OP)
• el comando compartido /logify para subir el registro actual del servidor a mclo.gs (permiso logify.*, por defecto OP)
• el comando compartido /nightbreak plugins para explorar el catálogo de plugins de Nightbreak (permiso nightbreak.plugins, por defecto OP)
• el almacenamiento compartido de tokens en plugins/MagmaCore/nightbreak.yml
• primitivas compartidas del menú de configuración usadas por los menús de configuración de los plugins
• verificaciones compartidas de acceso, versión y descarga de Nightbreak
• lógica compartida de descarga masiva que descarga archivos en la carpeta imports del plugin propietario
• la bandeja de entrada de changelogs compartida, que avisa a los administradores dentro del juego cuando un plugin o un paquete de contenido instalado tiene notas de versión sin leer (consulta Notificaciones de changelog de Nightbreak)
• el conjunto estándar de subcomandos que cada plugin gestionado por Nightbreak registra bajo su propio comando raíz (ver más abajo)

/nightbreaklogin, /nightbreaklogout, /logify y /nightbreak se registran una vez por servidor por el plugin gestionado por Nightbreak que cargue MagmaCore primero, por lo que están disponibles independientemente de qué plugin sea su "propietario" en tiempo de ejecución.

Subcomandos estándar compartidos

Los subcomandos de abajo no los escribe cada plugin. MagmaCore registra las mismas implementaciones bajo el comando raíz que declare el plugin (/em, /bs, /fmm, /etd, …), y por eso se comportan de forma idéntica en todas partes.

Subcomando	Qué hace	Permiso
setup	Abre el menú de configuración del plugin. Solo jugadores.	permiso de setup del plugin
initialize	Abre el menú de configuración inicial para jugadores si el plugin registra ese flujo. No requiere modos preestablecidos; FreeMinecraftModels también lo registra. Consulta la página de comandos de cada plugin.	permiso de initialize del plugin
recommendedplugins	Muestra los plugins complementarios recomendados (menú en el juego, lista en chat desde consola).	permiso de setup del plugin
downloadpluginupdate	Descarga solo el jar de actualización del plugin. Sin contenido.	permiso de admin del plugin
downloadall	Descarga la actualización del plugin y después todo el contenido disponible.	permiso de admin del plugin
downloadallcontent	Descarga todo el contenido disponible, sin actualización del plugin. Solo lo registran los plugins que incluyen paquetes de contenido.	permiso de setup del plugin
updatecontent (alias updateallcontent)	Descarga actualizaciones solo para el contenido ya desactualizado. Solo lo registran los plugins que incluyen paquetes de contenido.	permiso de setup del plugin
forcereinstallcontent <package|all>	Vuelve a descargar contenido a través de la ruta normal autenticada de importación y recarga, incluso cuando la versión instalada ya está al día. all cubre todos los paquetes que estén descargados, instalados o desactualizados; pasa directamente el slug de un paquete si sus archivos faltan por completo. Solo lo registran los plugins que incluyen paquetes de contenido.	permiso de admin del plugin

El nodo de permiso exacto detrás de cada columna lo elige el plugin, así que consulta la página del propio plugin para conocer sus nombres de nodo. initialize es un flujo de guía inicial — no reemplaza el menú de configuración ni los comandos de gestión de contenido.

Como downloadall empieza por la actualización del plugin, se detiene antes del paso de contenido cuando la cuenta no tiene token o el token falló la autenticación. Arregla primero el token y después vuelve a ejecutarlo.

MagmaCore también tiene un sistema de inicialización separado al inicio del plugin, pero no es lo mismo que los comandos initialize orientados al jugador documentados aquí.

Actualizaciones automáticas

Cada plugin gestionado por Nightbreak escribe una clave compartida en su propio config.yml:

nightbreak:
  autoDownloadPluginUpdates: false

Cuando se pone en true, ese plugin descarga automáticamente, unos minutos después del arranque:

• un jar de actualización del plugin disponible, y
• archivos de actualización para cualquier paquete de contenido desactualizado que gestione.

Las actualizaciones de plugin y de contenido descargadas se usan después de reiniciar el servidor — nada se intercambia en caliente en un servidor en marcha. La opción vale false por defecto, así que de serie te quedas con el botón de actualización dentro del juego.

Las descargas automáticas del jar del plugin requieren tanto un token de cuenta válido como una membresía activa de supporter en Patreon en la cuenta de Nightbreak vinculada. Sin ellas la descarga se rechaza y el plugin registra el motivo. Las descargas también se verifican: el jar se comprueba por checksum y se valida como artefacto de plugin real antes de colocarse en la carpeta update del servidor, y una comprobación fallida descarta el archivo en lugar de instalarlo.

Al margen de la opción de descarga automática, cada plugin vuelve a comprobar discretamente si hay una versión más reciente aproximadamente una vez por hora, para que el menú de configuración pueda mostrar un estado de actualización preciso. Esa comprobación nunca descarga nada por sí sola.

Flujo recomendado para propietarios de servidores

1. Instala primero el plugin

Coloca el archivo jar del plugin y cualquier dependencia obligatoria en plugins/, luego inicia el servidor una vez.

2. Ejecuta el flujo de configuración inicial

Si el plugin expone un comando initialize, úsalo primero. Los menús actuales están diseñados para:

• marcar la configuración inicial como completada
• dirigirte a la vinculación de cuenta Nightbreak
• dirigirte hacia el menú de configuración actual
• aclarar cuándo las importaciones manuales siguen siendo válidas

Abre el menú de configuración inicial para jugadores si el plugin registra ese flujo. No requiere modos preestablecidos; FreeMinecraftModels también lo registra. Consulta la página de comandos de cada plugin.

3. Vincula tu cuenta Nightbreak

Ve a la página de cuenta Nightbreak, obtén tu token de servidor y ejecuta:

/nightbreaklogin <token>

El token se comparte a través de MagmaCore, por lo que un token vinculado puede ser reutilizado por todos los plugins compatibles de MagmaGuy en ese servidor.

4. Usa el menú de configuración para la gestión diaria de contenido

Los menús de configuración son la fuente de verdad actual para:

• estados de paquetes
• estados de acceso
• contenido instalado vs descargado
• contenido parcialmente instalado que necesita reparación
• contenido desactualizado
• filtros de contenido por categoría

Si tienes un token vinculado, los menús de configuración son el lugar recomendado para instalar y actualizar contenido.

5. Usa la instalación/actualización masiva cuando quieras velocidad

Usa el comando downloadall cuando quieras configurar un servidor rápidamente y el comando updatecontent cuando quieras actualizar todo lo que esté desactualizado.

El descargador masivo compartido solo intenta paquetes gestionados por Nightbreak que:

• tienen un slug de Nightbreak
• son accesibles para el token vinculado
• aún no están descargados o están marcados como desactualizados

Los comandos masivos interactivos piden al plugin propietario que se recargue después de al menos una descarga exitosa. Las descargas automáticas de contenido al arrancar deliberadamente no recargan el plugin; surten efecto después de reiniciar el servidor.

Conceptos compartidos

Descargado vs instalado

Un paquete puede existir localmente sin estar habilitado. El significado exacto varía ligeramente según el plugin, pero el estado del menú de configuración importa más que si existe un zip en imports.

Las descargas masivas también aterrizan en la misma carpeta imports del plugin utilizada por las importaciones manuales antes de que finalice el paso de importación/recarga específico del plugin.

Contenido con reconocimiento de acceso

Los menús de configuración ahora pueden distinguir entre contenido que:

• está disponible para tu token
• necesita ser comprado o desbloqueado
• está instalado
• está solo parcialmente instalado
• está descargado pero deshabilitado
• está desactualizado

Las importaciones manuales siguen siendo válidas

Los plugins gestionados por Nightbreak aún soportan flujos de importación manual. La importación manual es ahora la ruta alternativa, no la ruta predeterminada. Consulta Importaciones manuales vs gestión dentro del juego.

Plugins que no usan este flujo

No todos los plugins en esta wiki usan contenido descargable gestionado por Nightbreak.

• BetterFood no usa gestión de paquetes de Nightbreak
• ResourcePackManager gestiona paquetes de recursos, no paquetes DLC de Nightbreak

Esos dos plugins sí registran el armazón de configuración compartido y los comandos compartidos de actualización del plugin y de changelog; lo que les falta son los paquetes de contenido de Nightbreak.

ResurrectionChest y WorldCannon no son excepciones — ambos declaran paquetes de contenido, ambos registran los subcomandos de contenido compartidos y ambos ejecutan el importador compartido, así que también aceptan zips de paquetes colocados a mano. Consulta Importaciones manuales vs gestión dentro del juego.