Zum Hauptinhalt springen

Nightbreak-Kontoverknüpfung und Tokens

Von Nightbreak verwaltete Inhaltsdownloads verwenden jetzt einen gemeinsamen Token-Ablauf über MagmaCore.

Wie du einen Token generierst und ihn mit deinem Server verknüpfst​

  1. Öffne deine Nightbreak-Kontoseite.
  2. Generiere oder kopiere deinen Server-Token.
  3. Führe aus:
/nightbreaklogin <token>
  1. Starte den Server neu, um die Token-Einrichtung abzuschließen.

Sobald das erfolgreich ist, können kompatible MagmaGuy-Plugins auf demselben Server den gemeinsamen Token für Nightbreak-Zugriffsprüfungen und Downloads verwenden.

Jedes geladene Plugin prüft beim nächsten Zugriff auf den Token die Änderungszeit der gemeinsamen Token-Datei und bemerkt so einen neuen Token ohne Neustart. Ein Neustart bleibt dennoch der empfohlene Abschlussschritt, weil ein Teil der Startarbeit eines Plugins — einschließlich automatischer Update-Downloads — nur während des Aktivierens läuft.

Die von MagmaCore für diesen Befehl registrierte gemeinsame Berechtigung ist nightbreak.login, die standardmäßig auf Serveroperatoren beschränkt ist, es sei denn, ein Serveradministrator ändert dies.

Von Nightbreak ausgegebene Tokens beginnen mit nbk_. Fügst du etwas ein, das das nicht tut, warnt der Befehl dich und speichert es trotzdem. Leere Werte und der wörtliche Platzhalter YOUR_TOKEN_HERE werden grundsätzlich abgelehnt.

Einen Server trennen​

Um einen Server von seinem Nightbreak-Konto zu lösen, führe aus:

/nightbreaklogout

Dies verwendet dieselbe Berechtigung nightbreak.login wie das Anmelden. Es löscht plugins/MagmaCore/nightbreak.yml vollständig, statt den Wert zu leeren, sodass keine Kopie des Tokens in der Datei zurückbleibt. Geladene Plugins sehen bei ihrer nächsten Token-Prüfung, dass die Datei verschwunden ist, und fallen ohne Neustart auf ihr Verhalten ohne Verknüpfung zurück.

Verwende dies, bevor du einen Server an jemand anderen übergibst, bevor du eine Serverkopie irgendwo hochlädst, oder wenn du vermutest, dass der Token kompromittiert wurde. Das Abmelden entfernt den Token nur von diesem Server — widerrufe ihn zusätzlich auf der Nightbreak-Kontoseite, falls er offengelegt worden sein könnte.

Wie du dein Patreon- oder Itch-Konto mit deinem Nightbreak-Konto verknüpfst​

  1. Öffne die Seite deines Nightbreak-Kontos.
  2. Scrolle zum Abschnitt „Linked Accounts" und klicke auf die Link-Schaltfläche für den Dienst, den du verknüpfen möchtest.
image
  1. Du wirst auf die Webseite des Dienstes weitergeleitet, wo du dich anmelden musst, falls noch nicht geschehen, und anschließend direkt zum Autorisierungsfenster geführt, in dem du Nightbreak den Zugriff auf die zur Kontoverknüpfung nötigen Daten erlauben sollst.
  2. Nachdem du deine Konten verknüpft hast, solltest du auf die über den Dienst erworbenen Inhalte auf deinem Nightbreak-Konto und im Spiel zugreifen können, sofern der Token korrekt eingerichtet wurde.

Wo der Token gespeichert wird​

Der Token wird gespeichert in:

plugins/MagmaCore/nightbreak.yml

unter dem token-Schlüssel, nicht im privaten Ordner jedes Plugins.

Das bedeutet:

  • du musst den Token nicht separat für jedes Plugin registrieren
  • die Neuinstallation eines Plugins führt nicht zwangsläufig zum Verlust des Tokens
  • das Löschen der gemeinsamen MagmaCore-Konfiguration kann erfordern, dass du den Token erneut registrierst

Was der Token freischaltet​

Ein verknüpfter Token wird verwendet für:

  • die Überprüfung, ob das Serverkonto auf ein Inhaltspaket zugreifen kann
  • die Überprüfung von Remote-Versionsmetadaten für verwaltete Pakete
  • das direkte Herunterladen von Inhalten in Plugin-Import-Ordner
  • die Erkennung, ob installierte Pakete veraltet sind
  • die Aktivierung von Nightbreak-bewussten Setup-Menü-Status

Er umgeht keine plugin-spezifischen Anforderungen wie:

  • die Installation eines Ressourcenpakets
  • die Aktivierung eines Inhaltspakets im Setup-Menü
  • das Beibehalten installierter Abhängigkeiten

Sicherheitshinweise​

  • Behandle den Token wie ein Server-Zugangsdatum.
  • Veröffentliche ihn nicht im öffentlichen Chat, in Screenshots oder Support-Protokollen.
  • Wenn du denkst, dass er kompromittiert wurde, führe /nightbreaklogout aus, widerrufe ihn dann auf der Nightbreak-Kontoseite und generiere einen neuen.
  • MagmaCore warnt, wenn der Token nicht mit nbk_ beginnt, versucht aber trotzdem, ihn zu speichern.

Fehlerbehebung​

"No token registered"​

Das Plugin sieht noch keinen gültigen gemeinsamen Nightbreak-Token. Führe /nightbreaklogin <token> erneut aus und bestätige, dass plugins/MagmaCore/nightbreak.yml jetzt einen echten Token statt eines fehlenden oder Platzhalter-Werts enthält. Ist die Datei überhaupt nicht vorhanden, wurde der Token entweder nie registriert oder jemand hat /nightbreaklogout ausgeführt.

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

Der Token ist gültig, aber das verknüpfte Nightbreak-Konto schaltet dieses Paket derzeit nicht frei.

Ein Plugin funktioniert, ein anderes nicht​

Überprüfe die plugin-spezifische Setup-Seite. Einige Plugins benötigen noch:

  • ein abgeschlossenes Ersteinrichtungsmenü
  • einen Neuladevorgang nach Importen
  • einen Installationsschritt für ein Ressourcenpaket
  • eine optionale Abhängigkeit wie FreeMinecraftModels oder ResourcePackManager