Saltar al contenido principal

Configuracion de Nightbreak y gestion de contenido

Esta pagina es la guia compartida de configuracion para los plugins administrados por Nightbreak.

Se aplica directamente a:

  • EliteMobs
  • BetterStructures
  • FreeMinecraftModels
  • EternalTD

Estos plugins ahora comparten el mismo ciclo general:

  1. Instala el plugin y cualquier dependencia obligatoria.
  2. Inicia el servidor una vez para que se generen los archivos y los menus.
  3. Ejecuta el comando de configuracion inicial del plugin si lo tiene.
  4. Vincula un token de Nightbreak con /nightbreaklogin <token>.
  5. Usa el menu de configuracion del plugin para explorar, instalar, habilitar, deshabilitar y actualizar contenido.
  6. Usa los comandos de descarga o actualizacion masiva cuando quieras una puesta en marcha inicial mas rapida.

Lo que MagmaCore comparte realmente

MagmaCore es la capa compartida detras del flujo administrado por Nightbreak. Proporciona:

  • el comando compartido /nightbreaklogin <token>
  • el almacenamiento compartido del token en plugins/MagmaCore/nightbreak.yml
  • primitivas compartidas del menu de configuracion usadas por los menus de cada plugin
  • comprobaciones compartidas de acceso, version y descarga de Nightbreak
  • logica compartida de descarga masiva que coloca los archivos en la carpeta imports del plugin propietario

Los comandos especificos de cada plugin, como /em initialize o /bs setup, siguen implementados por cada plugin. MagmaCore aporta los sistemas compartidos que esos comandos usan.

Patron compartido de primera configuracion

La mayoria de los plugins actuales administrados por Nightbreak exponen:

PluginComando inicialMenu de configuracionInstalacion masivaActualizacion masiva
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 es un flujo de orientacion para la primera vez. No sustituye el menu de configuracion especifico del plugin ni los comandos de gestion de contenido.

MagmaCore tambien tiene un sistema independiente de inicializacion al arrancar el plugin, pero no es lo mismo que los comandos initialize orientados al jugador documentados aqui.

Flujo recomendado para administradores

1. Instala primero el plugin

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

2. Ejecuta el flujo de primera configuracion

Si el plugin expone un comando initialize, usalo primero. Los menus actuales estan diseñados para:

  • marcar la configuracion inicial como completada
  • dirigirte al proceso de vinculacion de la cuenta de Nightbreak
  • llevarte al menu de configuracion actual
  • aclarar cuando las importaciones manuales siguen siendo validas

El comportamiento del menu inicial es compartido, pero el nombre exacto del comando y la logica posterior siguen siendo especificos de cada plugin.

3. Vincula tu cuenta de Nightbreak

Ve a la pagina de cuenta de Nightbreak, consigue el token de tu servidor y ejecuta:

/nightbreaklogin <token>

El token se comparte a traves de MagmaCore, asi que un unico token vinculado puede reutilizarse en todos los plugins compatibles de MagmaGuy del mismo servidor.

4. Usa el menu de configuracion para la gestion diaria del contenido

Los menus de configuracion son ahora la fuente de verdad para:

  • estados de los paquetes
  • estados de acceso
  • contenido instalado frente a descargado
  • contenido parcialmente instalado que necesita reparacion
  • contenido desactualizado
  • filtros de contenido por categoria

Si tienes un token vinculado, los menus de configuracion son el lugar recomendado para instalar y actualizar contenido.

5. Usa la instalacion o actualizacion masiva cuando quieras velocidad

Usa el comando downloadall cuando quieras preparar un servidor rapidamente y updatecontent cuando quieras actualizar todo lo que este desactualizado.

El descargador masivo compartido solo intenta procesar paquetes administrados por Nightbreak que:

  • tienen un slug de Nightbreak
  • son accesibles para el token vinculado
  • aun no se han descargado, o estan marcados como desactualizados

La mayoria de los plugins actuales se recargan automaticamente despues de descargas masivas correctas.

Conceptos compartidos

Descargado frente a instalado

Un paquete puede existir localmente sin estar habilitado. El significado exacto varia ligeramente segun el plugin, pero el estado del menu de configuracion importa mas que el hecho de que exista un zip dentro de imports.

Las descargas masivas tambien terminan en la misma carpeta imports del plugin que usan las importaciones manuales antes de que finalice el paso especifico de importacion o recarga del plugin.

Contenido con control de acceso

Los menus de configuracion ahora pueden distinguir entre contenido que:

  • esta disponible para tu token
  • debe comprarse o desbloquearse
  • esta instalado
  • esta solo parcialmente instalado
  • esta descargado pero deshabilitado
  • esta desactualizado

Las importaciones manuales siguen siendo validas

Los plugins administrados por Nightbreak siguen admitiendo flujos de importacion manual. La importacion manual es ahora la via de respaldo, no la via predeterminada. Consulta Importaciones manuales vs gestion dentro del juego.

Plugins que no usan este flujo

No todos los plugins de esta wiki usan contenido descargable administrado por Nightbreak.

  • BetterFood no usa gestion de paquetes de Nightbreak
  • ResurrectionChest no usa gestion de paquetes de Nightbreak
  • WorldCannon no usa gestion de paquetes de Nightbreak
  • ResourcePackManager gestiona paquetes de recursos, no paquetes DLC de Nightbreak