Zum Hauptinhalt springen

Nightbreak-Kontoverknüpfung und Tokens

Von Nightbreak verwaltete Inhaltsdownloads verwenden einen gemeinsamen Konto-Token über MagmaCore. Verknüpfe einen Server einmal, und jedes kompatible MagmaGuy-Plugin darauf verwendet denselben Token.

  1. Führe /nightbreaklogin ohne Token aus, im Spiel oder in der Konsole.
  2. Der Server gibt einen nightbreak.io-Link und einen Code wie K7QF-9XMB aus. Im Spiel ist der Link anklickbar.
  3. Öffne den Link, melde dich an oder erstelle ein kostenloses Nightbreak-Konto, prüfe, ob die Seite denselben Code wie der Server anzeigt, und genehmige den Server.
  4. Innerhalb weniger Sekunden speichert der Server deinen Konto-Token, nennt das Konto, mit dem er jetzt verknüpft ist, und erinnert dich daran, dass /nightbreaklogout die Verbindung wieder trennt.
  5. Starte den Server neu, um die Einrichtung abzuschließen.

Der Link läuft nach 30 Minuten ab. Läuft er ab oder wird er abgelehnt, führe /nightbreaklogin erneut aus, um einen neuen zu erhalten. Das Starten eines neuen Links bricht den vorherigen ab.

Die Genehmigungsseite nennt den Server, das Plugin und die Minecraft-Version, von denen die Anfrage stammt. Befindet sich der Server in einem anderen Netzwerk als dem, an das dein Token gebunden ist, warnt die Seite, dass das Verknüpfen deine Server im alten Netzwerk für bis zu 48 Stunden aussperrt.

Das Genehmigen übergibt dem Server den Token, den dein Konto bereits hat, sodass die Server, die du zuvor verknüpft hast, weiter funktionieren. Ein Konto ohne Token erhält einen. Wurde dein Token erstellt, bevor es die Server-Verknüpfung gab, fragt die Seite, ob er ersetzt werden soll. Das Ersetzen trennt jeden Server, der den alten Token verwendet hat, bis du den jeweiligen Server erneut verknüpfst.

Ein Server, der bereits einen funktionierenden Token hat, wechselt das Konto nicht von selbst. Nach der Genehmigung behält er den alten Token und fordert dich auf, innerhalb von 5 Minuten /nightbreaklogin confirm auszuführen, um zu wechseln. Hat Nightbreak den gespeicherten Token abgelehnt, ersetzt der genehmigte Link ihn sofort.

Die Option Recommended Setup im Ersteinrichtungsmenü von BetterStructures, FreeMinecraftModels, EternalTD, CannonRTP und ResurrectionChest startet einen Link für dich, wenn der Server noch nicht verknüpft ist.

Kann der Server nightbreak.io nicht erreichen oder ist das Verknüpfen nicht verfügbar, sagt der Befehl dies und verweist dich auf den Token-Weg weiter unten.

Der Token-Weg funktioniert weiterhin, zum Beispiel für automatisierte Einrichtungen oder wenn sich kein Link starten lässt.

  1. Öffne deine Nightbreak-Kontoseite.
  2. Erzeuge deinen Server-Token durch einen Klick auf „Generate New Token“.
image
  1. Kopiere den Befehl von der Kontoseite und führe ihn im Spiel aus:
/nightbreaklogin <token>
  1. Starte den Server neu, um die Token-Einrichtung abzuschließen.

„Generate New Token“ ersetzt den bisherigen Token und macht ihn ungültig. Nutze dieselbe Aktion, um einen offengelegten Token zu widerrufen. Vorhandene Tokens bleiben verborgen und lassen sich nicht erneut kopieren. Bewahre den neu erzeugten Befehl sicher auf und aktualisiere jeden Server, der den alten Token verwendet hat, oder verknüpfe jeden einzeln erneut mit /nightbreaklogin.

Sobald der Token gespeichert ist, über einen Link oder mit diesem Befehl, können kompatible MagmaGuy-Plugins auf demselben Server ihn für Nightbreak-Zugriffsprüfungen und Downloads verwenden.

Die Erfolgsmeldung beim Anmelden bestätigt, dass der Token lokal gespeichert wurde. Der Befehl führt nicht sofort eine authentifizierte Zugriffsprüfung durch. Öffne ein Inhaltsmenü oder fordere einen berechtigten Download an, um zu bestätigen, dass Nightbreak den Token akzeptiert und das verknüpfte Konto auf das Paket zugreifen darf.

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.

  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
  • das Herunterladen von Plugin-Jars im Spiel, sowohl Plugin-Updates als auch fehlende Plugins aus /nightbreak plugins. Nightbreak erlaubt diese Downloads nur für Unterstützer. Bei Plugin-Updates bedeutet das eine aktive Supporter-Patreon-Mitgliedschaft

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.
  • Genehmige nur Links, die du selbst gestartet hast, und prüfe, ob der Code auf der Seite zu deinem Server passt. Jeder, der den Code eines Links sieht, kann sein eigenes Konto für diesen Server genehmigen, und ein Link, den dir jemand anderes schickt, würde dessen Server mit deinem Konto verbinden.
  • Um eine Verknüpfung rückgängig zu machen, führe /nightbreaklogout auf dem betreffenden Server aus. Um einem Server, den du nicht mehr kontrollierst, den Zugriff zu entziehen, generiere auf der Kontoseite einen neuen Token. Der alte Token funktioniert dann nirgends mehr, verknüpfe daher deine eigenen Server erneut.

Fehlerbehebung​

„Kein Token registriert“​

Das Plugin sieht noch keinen gültigen gemeinsamen Nightbreak-Token. Verknüpfe den Server erneut mit /nightbreaklogin oder /nightbreaklogin <token> 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.

„Der gespeicherte Konto-Token muss aktualisiert werden“​

Nightbreak hat den gespeicherten Token abgelehnt, zum Beispiel weil ein neuerer Token ihn ersetzt hat. Die Konsole protokolliert die erste Ablehnung mit der Antwort des Servers und blendet spätere Token-Fehler aus. Bis du einen neuen Token registrierst, stoppen Inhalts-Downloads, Downloads von Plugin-Updates und Plugin-Installationen im Spiel mit dieser Meldung. Führe /nightbreaklogin aus und genehmige den Link, der den abgelehnten Token sofort ersetzt, oder erzeuge auf der Nightbreak-Kontoseite einen neuen Token und führe /nightbreaklogin <token> aus.

/nightbreaklogin fragt nach einem Token​

Das Nightbreak-Plugin, das zuerst geladen wird, registriert /nightbreaklogin, und auf diesem Server ist dieses Plugin älter als die Server-Verknüpfung, sodass der Befehl nur einen Token akzeptiert. Aktualisiere deine Nightbreak-Plugins oder nutze den Token-Weg.

Der Befehl konnte nightbreak.io nicht erreichen, das Verknüpfen ist gerade nicht verfügbar, oder der Server hat innerhalb weniger Minuten zu viele Links angefordert. Die Meldung nennt die Ursache und zeigt den Token-Weg. Warte ein paar Minuten und versuche es erneut, oder verknüpfe mit einem Token.

Führe /nightbreaklogin erneut aus, um einen neuen Link zu erhalten. Ein Link gilt 30 Minuten, und der Server wartet nicht mehr, sobald jemand ihn auf der Seite ablehnt.

Der Server hatte bereits einen funktionierenden Token. Führe innerhalb von 5 Minuten nach der Genehmigung /nightbreaklogin confirm aus, um zum neuen Konto zu wechseln, oder ignoriere es, um das alte zu behalten.

„Du hast keinen Zugriff auf diesen Inhalt“​

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