Vinculación de cuenta Nightbreak y tokens
Las descargas de contenido gestionado por Nightbreak ahora utilizan un flujo de tokens compartido a través de MagmaCore.
Cómo generar un token y vincularlo a tu servidor
- Abre tu página de cuenta Nightbreak.
- Genera tu token de servidor haciendo clic en el botón Generate New Token.
- Copia el comando de la página de la cuenta y ejecútalo en el juego:
/nightbreaklogin <token>
- Reinicia el servidor para terminar la configuración del token.
Una vez que tenga éxito, los plugins compatibles de MagmaGuy en el mismo servidor pueden usar el token compartido para verificaciones de acceso y descargas de Nightbreak.
Cada plugin vuelve a leer el archivo de token compartido cada vez que cambia, así que los plugins ya cargados detectan 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.
Cómo vincular tu cuenta de Patreon o Itch a tu cuenta de Nightbreak
- Abre tu página de cuenta Nightbreak.
- Baja hasta la sección Linked Accounts y haz clic en el botón Link del servicio que quieras vincular.
- 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.
- 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
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.
Solución de problemas
"No token registered"
El plugin aún no ve un token compartido de Nightbreak válido. Ejecuta /nightbreaklogin <token> de nuevo 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.
"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