Dashboard

Das Dashboard ist eine Webseite, um deinen Server von außerhalb des Spiels zu verwalten. Es listet aktive Strafen und Spieler online auf, lässt dich jeden Spieler suchen und Maßnahmen ergreifen, und stellt jeden Schlüssel aus der config.yml als bearbeitbares Formular bereit.

Es ist optional. Verité funktioniert genau gleich, ob du es öffnest oder nicht.

Öffnen

Führe /verite dashboard im Spiel aus. Verité antwortet mit einem privaten Link und einer anklickbaren Verknüpfung.

[Verité] Your dashboard is ready. [Click here] to open it, or click the link below:
https://verite.gg/dashboard/<key>

Der Link gilt nur für diese Sitzung. Wer ihn besitzt, kann die damit geladenen Daten sehen. Behandle ihn wie ein Passwort und füge ihn nicht in den öffentlichen Chat ein.

Eine Verbindung bestätigen

Den Link zu öffnen reicht nicht, um irgendetwas zu steuern. Sobald sich die Seite verbindet, erhalten alle Spieler mit verite.admin eine Meldung im Chat:

[Verité] A dashboard window has connected. If it was you, [click here] to trust the session.

Klicke darauf oder führe /verite dashboard trust <code> mit dem auf der Seite angezeigten Code aus. Bis die Sitzung bestätigt ist, kann die Seite nur die beim Laden abgerufenen Daten anzeigen; sie kann nichts weiter lesen und keine Änderungen vornehmen.

Nach der Bestätigung wird der Browser gemerkt. Eine erneute Verbindung aus demselben Browser überspringt die Bestätigung für 30 Tage. Das Vertrauen wird pro Administrator gespeichert: Deinen eigenen Browser zu bestätigen bestätigt den von niemandem sonst.

Ablaufzeiten

Jeder Teil einer Sitzung läuft für sich ab.

Ein abgelaufener Link lässt sich nicht wiederbeleben. Führe /verite dashboard erneut aus, um einen neuen zu erhalten.

Was du tun kannst

Übersicht zeigt Spielerzahl, TPS, Speicher, Laufzeit, wie viele Spieler unsichtbar sind und wer gerade online ist. Klicke auf einen Spieler online, um ihn zu öffnen.

Spieler ist der Ort für die Suche. Gib einen Namen oder eine UUID ein. Namen, die nie auf deinem Server waren, werden über Mojang aufgelöst, du kannst also jemanden vor seinem ersten Beitritt bannen. Ein ausgewählter Spieler öffnet ein Fenster mit seinem Strafverlauf, seinen bekannten Namen und Adressen sowie den folgenden Steuerungen.

Strafen aus dem Dashboard werden unter deinem eigenen Namen erfasst, nicht unter einem Sammelkonto, sodass /history und /staffhistory sie korrekt zuordnen.

Strafen listet alles derzeit Aktive auf, mit einem Suchfeld, das nach Spieler, Grund, Teammitglied oder Art filtert.

Einstellungen stellt jeden Schlüssel aus der config.yml bereit.

Die Konfiguration bearbeiten

Jeder Schlüssel wird passend zu seinem Typ dargestellt: ein Auswahlfeld für wahr und falsch, ein Zahlenfeld für Zahlen und ein Textfeld für alles andere. Beim Ändern eines Werts erscheinen Speichern und Zurücksetzen.

Beim Speichern wird genau die geänderte Zeile direkt in die config.yml geschrieben. Deine Kommentare, Leerzeilen, Einrückung und Anführungszeichen bleiben erhalten, und nichts anderes in der Datei wird angefasst. Eine Kopie der vorherigen Datei wird als config.yml.bak aufbewahrt.

Verité lädt anschließend seine eigene Konfiguration neu. Der Server wird nicht neu gestartet und niemand wird getrennt.

Manche Schlüssel wirken erst nach einem Neustart, genau wie beim Bearbeiten der Datei von Hand. Die wichtigsten sind die Modulschalter (chat.filter.enabled, moderation.enabled, vanish.enabled) und die beiden Optionen für automatische Aktualisierungen.

Selbst hosten

general.dashboard.url verweist auf die Seite, die das Dashboard bereitstellt. Lass sie unverändert, außer du hostest eine eigene Kopie.

general:
  dashboard.url: "https://verite.gg"

Wie es funktioniert

Gut zu wissen, wenn du entscheidest, ob du das in deinem Netzwerk erlaubst.

Das Plugin und der Browser erzeugen jeweils ein eigenes Schlüsselpaar und signieren jede Nachricht, die sie senden. Beide Seiten prüfen jede empfangene Nachricht, und alles, was die Signaturprüfung nicht besteht, wird verworfen und protokolliert. Die Vermittlungsstelle dazwischen transportiert den Verkehr, kann ihn aber nicht fälschen.

Dein Server sendet beim Öffnen der Sitzung eine Momentaufnahme. Danach fordert die Seite an, was sie braucht, und dein Server schickt Änderungen, sobald sie auftreten, sodass die Seite ohne ständiges Abfragen aktuell bleibt.

Nichts erreicht deinen Server, ohne dass die Sitzung zuvor im Spiel bestätigt wurde. Jede Bestätigung, jede abgelehnte Nachricht und jede über das Dashboard vorgenommene Änderung werden mit dem Namen des verantwortlichen Administrators in die Konsole geschrieben.

Das Plugin hält keine Datenbank-Zugangsdaten. Es spricht mit der eigenen API der Seite, die sie serverseitig verwahrt.