Tracking
Überblick
Tracking erfasst die Position jedes Spielers in regelmäßigen Abständen. Bei jedem Beitritt eines Spielers beginnt eine neue Sitzung, und die Erweiterung fügt ihr alle paar Sekunden einen Punkt (Koordinaten, Welt und Zeit) hinzu, bis der Spieler den Server verlässt. Sitzungen werden in einem Artifact gespeichert.
Admins können anschließend eine Sitzung untersuchen. Der Weg wird als animierte Spur aus Staubpartikeln um den Admin herum erneut abgespielt und, falls du BlueMap nutzt, auf der Webkarte als Linie mit einem Marker an jedem Punkt gezeichnet. Das ist ein gutes Werkzeug, um zu verstehen, wie sich Spieler durch ein Bauwerk bewegen, wo sie sich verirren, oder um eine verdächtige Sitzung zu prüfen.
Funktionen
- Sitzungsaufzeichnung — eine Sitzung pro Spieler und Login, mit Koordinaten, Welt und Zeitstempel.
- Konfigurierbares Intervall — ein Punkt alle
pointIntervalSecondsSekunden, standardmäßig 20. - Wiedergabe im Spiel — eine animierte Partikelspur, die nur der untersuchende Admin sieht.
- BlueMap-Anzeige — eine Pfadlinie in einer vom Spieler abgeleiteten Farbe und optionale Punktmarker.
- Persistente Speicherung — Sitzungen werden einige Sekunden nach jeder Änderung in ein TypeWriter-Artifact geschrieben.
- Begrenzte Größe — pro Sitzung werden höchstens 10.000 Punkte gespeichert.
- Folia-sicher — die Aufzeichnungs- und Partikelschleifen verwenden regionssichere Scheduler.
Installation
- Installiere PacketEvents, das TypeWriter ohnehin benötigt. Die Partikelspur wird darüber gesendet.
- Optional: Installiere BlueMap, um Sitzungen auf der Webkarte zu sehen.
- Lege die Tracking-JAR in
plugins/Typewriter/extensions/ab und starte den Server neu.
Erste Schritte
- Öffne im TypeWriter-Web-Panel eine Manifest-Page und füge ein Tracking Artifact hinzu. Behalte seine
artifactIdbei (Standard isttracking_storage). - Füge ein Tracking Manifest hinzu und verknüpfe das Artifact in
storage. Ohne verknüpftes Artifact wird nichts aufgezeichnet. - Setze
pointIntervalSeconds(zum Beispiel10) und prüfe, dasstrackingEnabledaktiviert ist. - Veröffentliche. Spieler, die ab jetzt beitreten, erhalten eine Sitzung. Spieler, die beim Veröffentlichen bereits online waren, haben keine, bis sie sich neu verbinden.
- Führe nach einer Weile
/tracking sessions <player>aus, um die Sitzungs-IDs eines Spielers aufzulisten. - Führe
/tracking inspect <player> <session>aus, um eine Sitzung erneut abzuspielen. Ist BlueMap installiert, erscheint der Pfad auch auf der Karte. - Führe
/trackingohne Argument aus, um die Untersuchung zu beenden.
Tracking speichert die genauen Koordinaten deiner Spieler ohne Ablaufdatum. Erwähne dies in deinen Regeln, wo es dein lokales Recht verlangt, und lösche die Artifact-Datei, sobald du die Daten nicht mehr benötigst.
Funktionsweise
Sitzungs-IDs sind Zahlen, die über alle Spieler hinweg der Reihe nach vergeben werden (1, 2, 3 ...), nicht pro Spieler. Eine Sitzung endet, wenn der Spieler den Server verlässt.
Befehle
Der Befehl ist ein normaler Serverbefehl, der als /tracking registriert ist (auch /typewriter:tracking), kein Unterbefehl von /typewriter. Er kann nur von Spielern verwendet werden und benötigt typewriter.tracking.inspect.
| Befehl | Beschreibung |
|---|---|
/tracking sessions <player> | Listet die für einen Spieler aufgezeichneten Sitzungs-IDs auf. |
/tracking inspect <player> | Listet die Sitzungs-IDs eines Spielers auf. |
/tracking inspect <player> <session> | Startet die Untersuchung einer Sitzung: Partikelspur für dich und, falls aktiviert, BlueMap-Marker. |
/tracking | Beendet deine Untersuchung und entfernt deren BlueMap-Marker. |
Du kannst auch Spieler untersuchen, die offline sind, solange ihr Name dem Server bekannt ist.
Berechtigungen
| Berechtigung | Gewährt |
|---|---|
typewriter.tracking.inspect | Jeden /tracking-Befehl. |
Konfiguration
Alle Einstellungen befinden sich im Entry Tracking Manifest. Es wird nur das erste gefundene Manifest verwendet, und Änderungen werden innerhalb weniger Sekunden übernommen.
trackingEnabledschaltet die Aufzeichnung ein oder aus. Beim Ausschalten werden keine Punkte mehr hinzugefügt. Neue Sitzungen werden nur für Spieler erstellt, die beitreten, während die Option aktiviert ist.blueMapEnabled,showBlueMapPointsundshowBlueMapPathsteuern, was auf BlueMap gezeichnet wird. Sind beide Anzeigeoptionen deaktiviert, wird nichts gezeichnet.- Die Spur wird nur für Segmente im Umkreis von etwa 30 Blöcken um den Admin gezeichnet, und zwar in der Welt, in der sich der Admin befindet.
Entries
2 Einträge, aus dem Quellcode der Erweiterung generiert.
Artefakte1
- Tracking ArtifactStores player tracking sessions and points
Manifeste1
- Tracking ManifestMaster configuration for Player Tracking
Fehlerbehebung
Es wird keine Sitzung aufgezeichnet. Das Manifest muss existieren, trackingEnabled aktiviert haben und ein verknüpftes storage-Artifact besitzen. Sitzungen beginnen, wenn ein Spieler beitritt; Spieler, die vor dem Veröffentlichen online waren, müssen sich daher neu verbinden.
/tracking inspect meldet "No tracking sessions found". Der Spieler hat noch keine aufgezeichnete Sitzung, oder der Name ist falsch. Führe /tracking sessions <player> aus. Sitzungen benötigen mindestens einen Punkt, um nützlich zu sein: Der erste Punkt wird nach pointIntervalSeconds aufgezeichnet.
Die Partikelspur ist unsichtbar. Du benötigst mindestens 2 Punkte in der Welt, in der du stehst, und musst dich im Umkreis von etwa 30 Blöcken um den Pfad befinden. Die Spur ist nur für den Admin sichtbar, der die Untersuchung ausführt.
Auf BlueMap wird nichts angezeigt. BlueMap muss installiert und aktiviert sein, blueMapEnabled muss mit mindestens einer der Anzeigeoptionen aktiviert sein, und die Welt der Punkte muss BlueMap bekannt sein. Marker werden entfernt, wenn du /tracking ausführst.
Eine Sitzung wächst nicht mehr. Eine Sitzung behält höchstens 10.000 Punkte. Beim Standardintervall sind das mehr als 55 Stunden Spielzeit.
Daten sind nach einem Absturz verschwunden. Daten werden 5 Sekunden nach der letzten Änderung und beim Entladen gespeichert. Ein Absturz innerhalb dieses Zeitfensters kann die neuesten Punkte kosten.