Aller au contenu principal

Liaison de compte Nightbreak et tokens

Les téléchargements de contenu géré par Nightbreak utilisent désormais un flux de tokens partagé via MagmaCore.

Comment générer un token et le lier à votre serveur​

  1. Ouvrez votre page de compte Nightbreak.
  2. Générez votre token de serveur en cliquant sur le bouton Generate New Token.
capture d'écran du bouton de génération de token
  1. Copiez la commande depuis la page de compte et exécutez-la en jeu :
/nightbreaklogin <token>
  1. Redémarrez le serveur pour terminer la configuration du token.

Une fois réussi, les plugins MagmaGuy compatibles sur le même serveur peuvent utiliser le token partagé pour les vérifications d'accès et les téléchargements Nightbreak.

Chaque plugin chargé vérifie la date de modification du fichier de token partagé lors de son prochain accès au token : il peut donc remarquer un nouveau token sans redémarrage. Un redémarrage reste toutefois l'étape finale recommandée, car certains traitements de démarrage des plugins — dont les téléchargements automatiques de mises à jour — ne s'exécutent que pendant l'activation du plugin.

La permission partagée enregistrée par MagmaCore pour cette commande est nightbreak.login, qui est attribuée par défaut aux opérateurs du serveur sauf si un administrateur la modifie.

Les tokens émis par Nightbreak commencent par nbk_. Si vous collez quelque chose qui ne commence pas ainsi, la commande vous avertit et l'enregistre quand même. Les valeurs vides et l'espace réservé littéral YOUR_TOKEN_HERE sont refusés d'emblée.

Déconnecter un serveur​

Pour délier un serveur de son compte Nightbreak, exécutez :

/nightbreaklogout

Cette commande utilise la même permission nightbreak.login que la connexion. Elle supprime purement et simplement plugins/MagmaCore/nightbreak.yml au lieu d'en vider la valeur, afin qu'aucune copie du token ne subsiste dans le fichier. Les plugins chargés constatent la disparition du fichier lors de leur prochaine vérification de token et reviennent à leur comportement non lié sans redémarrage.

Utilisez ceci avant de céder un serveur à quelqu'un d'autre, avant de téléverser une copie de serveur où que ce soit, ou si vous suspectez une fuite du token. La déconnexion ne retire le token que de ce serveur — révoquez-le également sur la page de compte Nightbreak s'il a pu être exposé.

Comment lier votre compte Patreon ou Itch à votre compte Nightbreak​

  1. Ouvrez votre page de compte Nightbreak.
  2. Descendez jusqu'à la section Linked Accounts et cliquez sur le bouton Link du service que vous souhaitez lier.
capture d'écran de la section des comptes liés
  1. Vous serez redirigé vers la page web du service, où il vous sera demandé de vous connecter si ce n'est pas déjà fait, puis directement vers la fenêtre d'autorisation où il vous sera demandé d'autoriser Nightbreak à accéder aux données nécessaires pour lier vos comptes.
  2. Une fois vos comptes liés, vous devriez avoir accès au contenu obtenu via ce service sur votre compte Nightbreak et en jeu, si le token a été correctement configuré.

Où le token est stocké​

Le token est stocké dans :

plugins/MagmaCore/nightbreak.yml

sous la clé token, pas dans le dossier privé de chaque plugin.

Cela signifie :

  • vous n'avez pas besoin d'enregistrer le token séparément pour chaque plugin
  • réinstaller un plugin ne perd pas nécessairement le token
  • supprimer la configuration partagée de MagmaCore peut nécessiter un nouvel enregistrement du token

Ce que le token déverrouille​

Un token lié est utilisé pour :

  • vérifier si le compte serveur peut accéder à un paquet de contenu
  • vérifier les métadonnées de version distantes pour les paquets gérés
  • télécharger du contenu directement dans les dossiers d'importation du plugin
  • détecter si les paquets installés sont obsolètes
  • activer les états du menu de configuration avec prise en charge Nightbreak

Il ne contourne pas les exigences spécifiques au plugin telles que :

  • installer un pack de ressources
  • activer un paquet de contenu dans le menu de configuration
  • maintenir les dépendances installées

Notes de sécurité​

  • Traitez le token comme un identifiant de serveur.
  • Ne le publiez pas dans un chat public, des captures d'écran ou des journaux de support.
  • Si vous pensez qu'il a été compromis, exécutez /nightbreaklogout, puis révoquez-le depuis la page de compte Nightbreak et générez-en un nouveau.
  • MagmaCore avertit si le token ne commence pas par nbk_, mais tente quand même de le sauvegarder.

Dépannage​

"No token registered"​

Le plugin ne voit pas encore de token Nightbreak partagé valide. Exécutez /nightbreaklogin <token> à nouveau et confirmez que plugins/MagmaCore/nightbreak.yml contient maintenant un vrai token au lieu d'une valeur manquante ou de substitution. Si le fichier n'est pas là du tout, soit le token n'a jamais été enregistré, soit quelqu'un a exécuté /nightbreaklogout.

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

Le token est valide, mais le compte Nightbreak lié ne déverrouille pas actuellement ce paquet.

Un plugin fonctionne, un autre non​

Vérifiez la page de configuration spécifique au plugin. Certains plugins nécessitent encore :

  • un menu de configuration initiale complété
  • un rechargement après les importations
  • une étape d'installation du pack de ressources
  • une dépendance optionnelle comme FreeMinecraftModels ou ResourcePackManager