Saltar al contenido principal

Vinculación de cuenta Nightbreak y tokens

Las descargas de contenido gestionado por Nightbreak utilizan un token de cuenta compartido a través de MagmaCore. Vincula un servidor una vez y todos los plugins compatibles de MagmaGuy que haya en él usan el mismo token.

  1. Ejecuta /nightbreaklogin sin token, en el juego o desde la consola.
  2. El servidor imprime un enlace de nightbreak.io y un código como K7QF-9XMB. En el juego, se puede hacer clic en el enlace.
  3. Abre el enlace, inicia sesión o crea una cuenta gratuita de Nightbreak, comprueba que la página muestra el mismo código que el servidor y aprueba el servidor.
  4. En unos segundos el servidor guarda el token de tu cuenta, indica a qué cuenta está vinculado ahora y te recuerda que /nightbreaklogout lo desconecta.
  5. Reinicia el servidor para terminar la configuración.

El enlace caduca a los 30 minutos. Si caduca o se rechaza, vuelve a ejecutar /nightbreaklogin para obtener otro. Iniciar un enlace nuevo cancela el anterior.

La página de aprobación indica el servidor, el plugin y la versión de Minecraft que hicieron la solicitud. Si el servidor está en una red distinta de aquella a la que está vinculado tu token, la página avisa de que la vinculación deja sin acceso a tus servidores de la red anterior durante un máximo de 48 horas.

Aprobar entrega al servidor el token que tu cuenta ya tiene, así que los servidores que vinculaste antes siguen funcionando. Una cuenta sin token recibe uno. Si tu token se creó antes de que existiera la vinculación de servidores, la página pide sustituirlo. Sustituirlo desconecta todos los servidores que usaban el token anterior hasta que los vincules de nuevo.

Un servidor que ya tiene un token que funciona no cambia de cuenta por sí solo. Tras la aprobación conserva el token anterior y te pide que ejecutes /nightbreaklogin confirm en un plazo de 5 minutos para cambiar. Si Nightbreak había rechazado el token guardado, el enlace aprobado lo sustituye de inmediato.

La opción Configuración recomendada del menú de configuración inicial de BetterStructures, FreeMinecraftModels, EternalTD, CannonRTP y ResurrectionChest inicia una vinculación por ti cuando el servidor aún no está vinculado.

Si el servidor no puede conectar con nightbreak.io, o la vinculación no está disponible, el comando lo indica y te remite a la ruta del token que aparece más abajo.

La ruta del token sigue funcionando, por ejemplo para configuraciones automatizadas o cuando no se puede iniciar un enlace.

  1. Abre tu página de cuenta Nightbreak.
  2. Genera tu token de servidor haciendo clic en el botón Generate New Token.
image
  1. Copia el comando de la página de la cuenta y ejecútalo en el juego:
/nightbreaklogin <token>
  1. Reinicia el servidor para terminar la configuración del token.

Generate New Token sustituye e invalida el token anterior; usa esta misma acción para revocar un token expuesto. Los tokens existentes están ocultos y no se pueden volver a copiar. Guarda el nuevo comando de forma segura y actualiza todos los servidores que usaban el token anterior, o vincula cada uno de nuevo con /nightbreaklogin.

Una vez guardado el token, ya sea mediante un enlace o con este comando, los plugins compatibles de MagmaGuy en el mismo servidor pueden usarlo para verificaciones de acceso y descargas de Nightbreak.

El mensaje de inicio de sesión correcto confirma que el token se ha guardado localmente. El comando no realiza una comprobación inmediata de acceso autenticado. Abre un menú de contenido o solicita una descarga autorizada para confirmar que Nightbreak acepta el token y que la cuenta vinculada tiene acceso al paquete.

Cada plugin cargado comprueba la fecha de modificación del archivo compartido la próxima vez que accede al token, por lo que puede detectar un token nuevo sin reiniciar. Aun así, reiniciar sigue siendo el paso final recomendado, porque parte del trabajo de arranque de algunos plugins — incluidas las descargas automáticas de actualizaciones — solo se ejecuta mientras el plugin se está habilitando.

El permiso compartido registrado por MagmaCore para este comando es nightbreak.login, que por defecto está disponible para los operadores del servidor a menos que un administrador lo cambie.

Los tokens emitidos por Nightbreak empiezan por nbk_. Si pegas algo que no lo hace, el comando te avisa y lo guarda igualmente. Los valores vacíos y el marcador de posición literal YOUR_TOKEN_HERE se rechazan directamente.

Desconectar un servidor​

Para desvincular un servidor de su cuenta de Nightbreak, ejecuta:

/nightbreaklogout

Esto usa el mismo permiso nightbreak.login que iniciar sesión. Elimina plugins/MagmaCore/nightbreak.yml por completo en lugar de vaciar el valor, así que no queda ninguna copia del token en el archivo. Los plugins cargados ven desaparecer el archivo en su siguiente comprobación de token y vuelven a su comportamiento sin vincular sin necesidad de reiniciar.

Usa esto antes de entregar un servidor a otra persona, antes de subir una copia del servidor a cualquier sitio, o si sospechas que el token se ha filtrado. Cerrar sesión solo elimina el token de este servidor — revócalo también en la página de cuenta de Nightbreak si puede haber quedado expuesto.

  1. Abre tu página de cuenta Nightbreak.
  2. Baja hasta la sección Linked Accounts y haz clic en el botón Link del servicio que quieras vincular.
image
  1. Se te llevará a la página web del servicio, donde se te pedirá iniciar sesión si aún no lo has hecho, y después directamente a la ventana de autorización, donde se te pedirá permitir que Nightbreak acceda a los datos necesarios para vincular tus cuentas.
  2. Después de vincular tus cuentas, deberías tener acceso al contenido adquirido a través de ese servicio en tu cuenta de Nightbreak y en el juego, si el token se configuró correctamente.

Dónde se almacena el token​

El token se almacena en:

plugins/MagmaCore/nightbreak.yml

bajo la clave token, no dentro de la carpeta privada de cada plugin.

Esto significa:

  • no necesitas registrar el token por separado para cada plugin
  • reinstalar un plugin no necesariamente pierde el token
  • eliminar la configuración compartida de MagmaCore puede requerir que registres el token de nuevo

Qué desbloquea el token​

Un token vinculado se usa para:

  • verificar si la cuenta del servidor puede acceder a un paquete de contenido
  • verificar metadatos de versiones remotas para paquetes gestionados
  • descargar contenido directamente en las carpetas de importación del plugin
  • detectar si los paquetes instalados están desactualizados
  • habilitar estados del menú de configuración con reconocimiento de Nightbreak
  • descargar jars de plugins dentro del juego, tanto actualizaciones de plugins como plugins que faltan desde /nightbreak plugins. Nightbreak solo permite estas descargas a los supporters. Para las actualizaciones de plugins, eso significa una membresía activa de supporter en Patreon

No omite requisitos específicos del plugin como:

  • instalar un paquete de recursos
  • habilitar un paquete de contenido en el menú de configuración
  • mantener las dependencias instaladas

Notas de seguridad​

  • Trata el token como una credencial del servidor.
  • No lo publiques en chat público, capturas de pantalla o registros de soporte.
  • Si crees que se ha filtrado, ejecuta /nightbreaklogout, y después revócalo desde la página de cuenta Nightbreak y genera uno nuevo.
  • MagmaCore advierte si el token no empieza por nbk_, pero aún intenta guardarlo.
  • Aprueba solo los enlaces que hayas iniciado tú, y comprueba que el código de la página coincide con el de tu servidor. Cualquiera que vea el código de un enlace puede aprobar su propia cuenta en ese servidor, y un enlace que te envíe otra persona conectaría su servidor a tu cuenta.
  • Para deshacer una vinculación, ejecuta /nightbreaklogout en ese servidor. Para cortar el acceso de un servidor que ya no controlas, genera un token nuevo en la página de cuenta. El token anterior deja de funcionar en todas partes, así que vincula de nuevo tus propios servidores.

Solución de problemas​

"No token registered"​

El plugin aún no ve un token compartido de Nightbreak válido. Vincula el servidor de nuevo con /nightbreaklogin o /nightbreaklogin <token> y confirma que plugins/MagmaCore/nightbreak.yml ahora contiene un token real en lugar de un valor ausente o de marcador de posición. Si el archivo no está ahí en absoluto, o el token nunca se registró o alguien ejecutó /nightbreaklogout.

"The saved account token needs to be updated"​

Nightbreak rechazó el token guardado, por ejemplo porque lo sustituyó un token más reciente. La consola registra el primer rechazo con la respuesta del servidor y oculta los errores de token posteriores. Hasta que registres un token nuevo, las descargas de contenido, las descargas de actualizaciones de plugins y las instalaciones de plugins dentro del juego se detienen con este mensaje. Ejecuta /nightbreaklogin y aprueba el enlace, que sustituye de inmediato el token rechazado, o genera un token nuevo en la página de cuenta de Nightbreak y ejecuta /nightbreaklogin <token>.

/nightbreaklogin pide un token​

/nightbreaklogin lo registra el plugin de Nightbreak que cargue primero, y en este servidor ese plugin es anterior a la vinculación de servidores, así que el comando solo acepta un token. Actualiza tus plugins de Nightbreak o usa la ruta del token.

El comando no pudo conectar con nightbreak.io, la vinculación no está disponible en este momento o el servidor pidió demasiados enlaces en pocos minutos. El mensaje indica la causa y muestra la ruta del token. Espera unos minutos y vuelve a intentarlo, o vincula con un token.

Vuelve a ejecutar /nightbreaklogin para obtener un enlace nuevo. Un enlace dura 30 minutos, y el servidor deja de esperar en cuanto alguien lo rechaza en la página.

El servidor ya tenía un token que funcionaba. Ejecuta /nightbreaklogin confirm en un plazo de 5 minutos desde la aprobación para cambiar a la cuenta nueva, o ignóralo para conservar la anterior.

"You don't have access to this content"​

El token es válido, pero la cuenta Nightbreak vinculada actualmente no desbloquea ese paquete.

Un plugin funciona, otro no​

Revisa la página de configuración específica del plugin. Algunos plugins aún necesitan:

  • un menú de configuración inicial completado
  • una recarga después de las importaciones
  • un paso de instalación del paquete de recursos
  • una dependencia opcional como FreeMinecraftModels o ResourcePackManager