X2R Reko Tool

Owned by Lukas Fellner
Last updated: Nov 13, 2024
10 min read

Links X2R Webseite:

Report Formular: https://www.x2r-simracing.de/x2r-report-formular

Streamer Einblendungen: X2R Reko Streamer Overlay

Reko Adminbereich: https://www.x2r-simracing.de/backend/x2r-reko/

Changelog

Hier werden Änderungen am Reko Tool festgehalten.

13.11.2024

Anpassungen und Verbesserungen

  • Reports haben nun eine eindeutige ID pro Event, die auch gleich bleibt, sollte ein Report gelöscht werden. Das war bisher nicht der Fall. Dadurch stimmt nun auch die Nummer des Reports in der Übersicht pro Team.

  • Die Nummer des Reports wird nun auch in der Übersicht beim Report Formular angezeigt

  • Discord Benachrichtungen beinhalten nun die Nummer des Reports und zusätzlich noch den Namen der Serie und des Events. Sowohl in der Benachrichtigung an die Reko als auch in der an die Fahrer:

    grafik-20241113-123437.png

  • Quick Links in die Übersicht aufgenommen, damit man von dort direkt zum Report Formular springen kann. Zusätzlich befindet sich dort auch der Link zu RaceApp

    grafik-20241113-124751.png

  • Die Fehlermeldungen beim Report Formular wurden angepasst (Kein Event gefunden, falsches Event angegeben, ein Event ohne Reko ausgewählt)

29.10.2024

Anpassungen und Verbesserungen

  • X2R Reko: Es ist nun möglich Reports zu löschen (egal in welchem Zustand sich diese befinden). Bitte beachte aber, dass es derzeit keine Möglichkeit gibt dies wieder rückgängig zu machen, daher bitte die Funktion mit Vorsicht verwenden. Wichtig ist auch dabei zu beachten, dass es eine explizite Berechtigung dafür gibt, welche standardmäßig auf "nicht erlaubt" gesetzt ist. Adminuser dürfen Reports löschen, normale Reko User haben standardmäßig keine Berechtigung dazu

  • X2R Reko: Bei Sprint Cup Reports wird nun auch im Detail Fenster angezeigt ob der Report zur RaceApp übertragen wurde oder nicht. Und wenn der Report nicht übertragen wurde, wird nun ein anderer Text für das Zurücksetzen angezeigt

  • X2R Events: Es gibt nun eine API Schnittstelle die es ermöglicht die RaceApp Buchungen vor einem Event nochmals zu aktualisieren, sodass die auszuwählenden Fahrer zum Rennstart korrekt von RaceApp synchronisiert wurden und aktuell sind

Fehlerbehebungen

  • X2R Reko: Wenn ein Sprint Cup Report nicht zu RaceApp gesendet wurde, wurde der Status auch nicht aktualisiert

  • X2R Reko: Wenn bei einem Sprint Cup Report bei der Zeitstrafe und der Punktestrafe 0 eingetragen wurde, wurde dieser Wert nicht gspeichert

  • X2R Reko: Bei abgeschlossenen Reports für die Sprint Cups wurde das Symbol (Augen Symbol) für das ausblenden des Reports für die Fahrer fälschlicherweise angezeigt

  • X2R Reko: Bei abgeschlossenen Reports für die Sprint Cups wurde die Strafe in der Übersicht falsch angezeigt bzw. wurde zu viel angezeigt was im Hintergrund zu einem Fehler geführt hat (Die Kurzbeschreibung im Report Fenster wurde auch ergänzt und wird nun korrekt angezeigt)

  • X2R Reko: Im letzten Update wurde die Möglichkeit hinzugefügt Reports zu speichern ohne die Strafe automatisch zu RaceApp zu übertragen. Leider konnte in so einem Fall der Status des Reports nicht mehr zurückgesetzt werden. Dieser Fehler wurde behoben und nun kann der Status für Reports in allen Fällen wieder korrekt zurückgesetzt werden

07.10.2024

Anpassungen und Verbesserungen

  • X2R Events: Es ist nun möglich die RaceApp Buchungen für ein Event von RaceApp im Adminbereich manuell zu laden (passiert sonst automatisch mit dem Event Sync alle 24 Stunden). Das ist in den X2R Events unter den drei Punkten möglich.

  • X2R Events: Es ist nun möglich den Reko Typ für ein Event anzupassen, sollte dieser aus irgendeinem Grund falsch gesetzt werden. Bitte beachte, dass diese Option bei einem erneuten RaceApp Sync wieder überschrieben wird.

  • X2R Events: Der RaceApp Event Sync wurde dahingehend angepasst, dass keine Events mehr gelöscht werden, die gerade laufen. Nachdem es in der Vergangenheit schon einmal vorgefallen ist, dass Events abgesagt bzw. gelöscht wurden (durch falsche Anlage in RaceApp), musste ich eine Möglichkeit schaffen diese Events auch wieder von der X2R Seite zu bekommen. Deshalb gibt es eine Abfrage, die Events automatisch löscht, sollten sie bei RaceApp nicht mehr vorhanden sein. Der Abfragezeitpunkt wurde nun angepasst und sollte daher nicht mehr in laufende Events eingreifen.

Fehlerbehebungen

  • X2R Reko: Reports die als "REKO" ausgefüllt wurden, konnten nicht abgesendet werden. Das Trennzeichen wurde hier noch nicht ausgetauscht auf das geänderte Zeichen.

  • X2R Reko: In der Übersicht im Adminbereich wurde die Kategorie bei den abgeschlossenen Reports falsch angezeigt, es wurde die Kategorie angezeigt, die der User beim Erstellen ausgewählt hatte und nicht die, die von der Reko angegeben wurde.

01.10.2024

Anfechtungen werden besser markiert

Während des ersten Events hat sich für die Reko herausgestellt, dass Anfechtungen nicht klar genug hervorgehoben werden. Das ist aber notwendig, da Strafen in so einem Fall schnell entfernt werden müssen.
Um das für die Reko einfacher zu gestalten werden die Anfechtungen nun Rot in der Übersicht hervorgehoben:

Auch die Discord Benachrichtigung wurde dahingehend angepasst, sodass es dort auch einfacher ersichtlich sein sollte:

Fortlaufende Nummer für Reports

Bei den Reports innerhalb eines Events werden nun in der ersten Spalte fortlaufende Nummer angezeigt um das gemeinsame Bearbeiten der Reports zu erleichtern

Info über Anzahl Vorfälle und Filterung

Es gibt nun eine Info für Fahrzeuge, sollte es für diese bereits mehrere Reports innerhalb eines Events oder innerhalb einer Serie geben. Beim Klick auf das Info Symbol wird außerdem ein Filter angewandt und es werden nur noch Vorfälle dieses Fahrzeugs innerhalb der Serie angezeigt.

Keine Pflichtfelder mehr

Beim Bearbeiten eines Reports ist es nun nicht mehr zwingend notwendig alle Felder auszufüllen. Nur beim Veröffentlichten eines Reports ist aber weiterhin notwendig, dass alle Felder befüllt sind.

Top Teams mit den meisten Penalties

In den Einstellungen kann die aktuelle ID der RaceApp Endurance Saison hinterlegt werden, diese ID wird dann für die Statistik der Top 3 Teams mit den meisten Penalties herangezogen. Für die Statistik werden nur tatsächliche Strafen gezählt und nicht die Anzahl der Reports.

Auswählen welche Informationen gepostet werden

Beim Veröffentlichten von Reports gibt es nun die Möglichkeit auszuwählen ob eine Discord Benachrichtigung erstellt wird. Auch ob eine Streamer Benachrichtigung erstellt wird, kann nun ausgewählt werden. Bei den Sprint Cups gibt es zusätzlich die Möglichkeit auszuwählen, dass Strafen nicht zu RaceApp gesendet werden.

Es gibt auch zusätzlich die Option den Report für die Fahrer/Besucher der Webseite in der Übersicht beim Report Formular auszublenden. Diese Meldung wird dann, obwohl sie abgeschlossen und veröffentlicht wurde, nicht für die Fahrer angezeigt.

Ein kleines Info Symbol gibt der Reko die Info, dass dieser Report für die Fahrer nicht angezeigt wird.

Weitere Anpassungen

  • Es wurden einige kleinere Anpassungen während dem Live Betrieb im ersten Endurance Event vorgenommen (z.B. Meldungen im Stream werden nun länger angezeigt)

  • Es wurden einige Fehler behoben

    • u.a. wurde das Trennzeichen für die Fahrzeugdetails angepasst, sodass es keine Probleme mehr mit gewissen Sonderzeichen geben sollte

  • In der Übersicht wird nun die Beschreibung des Vorfalls, welche vom Fahrer eingegeben wurde, auch im Status “saved” weiterhin angezeigt

  • Info Meldung beim Kopieren in die Zwischenablage

  • Buttons zum Schnellen kopieren der Reko Entscheidung und des Ingame Commands ist nun auch im Bearbeiten Fenster möglich

  • Im Adminbereich wird nun auch das Reglement beim Bearbeiten eines Reports verlinkt. Bei den Sprint Cups gibt es zusätzlich noch das Bild mit den Kategorien, welches geöffnet werden kann um die Strafen schnell nachzusehen:

02.09.2024

REKO als Reporter

Einloggte User können im Report Formular nun als “Reporter” den Wert “REKO” auswählen, damit wird ein Report quasi im Namen der Reko erstellt z.B. wenn sich nicht an die Safety Car Prozedur gehalten wurde und man eine Strafe aussprechen möchte.

Streamer Nachrichten

Die Beschriftung der Felder für neue Streamer Nachrichten wurde angepasst, sodass sie nun Sinn ergeben. Außerdem wurde ein Beispiel Foto ergänzt, damit man sich die Nachricht besser vorstellen kann.

Es gibt nun die Möglichkeit alle Streamer Nachrichten anzeigen zu lassen über diesen neuen Button:

In der Übersicht kann man sehen, wann welche Nachricht erstellt wurde und diese ggf. auch nochmals senden indem man eine Kopie erstellt

Report erstellen

Die Fahrer von X2R haben über ein Formular die Möglichkeit Reports für die Reko einzureichen.
Dabei handelt es sich um einen neuen Seitentyp, der auswählbar ist wenn das X2R Modul aktiv ist. Damit kann URL, Titel und andere Optionen selbst bestimmt werden. Um mehr über Seiten zu erfahren schaue hier: News / Seiten

Je nach aktivem Event kann ein Fahrer einen Report erstellen oder auch nicht.

Es gibt die Möglichkeit beim Aufrufen des Report Formulars ein bestimmtes Event in der URL anzugeben (Event ID aus RaceApp). z.B. mit ….reports/event/23578/ - Wenn man die Report Seite ohne Event ID aufruft, dann sucht das System automatisch nach einem aktiven Event.
Folgende Parameter werden derzeit für die Eventsuche verwendet:

  • bei Sprint Events von Eventbeginn bis 26 Stunden nach Eventende; Im Normalfall Eventbeginn 20 Uhr und somit Reports bis Folgetag 22 Uhr möglich

  • bei Endurance Events eine Woche vor Beginn des Events + 24 Stunden nach Eventende

Sollte es mehr als ein Event geben, dass in den genannten Zeitraum fällt, bekommt der User eine Übersicht der Events angezeigt und kann sich das passende Event raussuchen:

Je nach Event Typ - also ob Sprint Cup oder Endurance Serie - sieht das Formular etwas anders aus:

Endurance Serie

Bei einem Endurance Event gibt es außerdem noch eine Liste der abgeschlossenen Reports, die für alle einsehbar ist. Diese Liste muss vom User selbst aktualisiert werden, eine Auto Reload gibt es hier derzeit nicht!

Sprint Cup

Beim Sprint Cup gibt es z.B. keine Auswahl des Teams sondern nur der Fahrer. Außerdem unterscheiden sich die Report Kategorien (Zwischenfall) bei diesen Events im Vergleich zu den Endurance Events.

Viele der angezeigten Informationen, wie der Text oben oder die Links zu den Reglements, können in den Reko Einstellungen geändert werden.

Mit der entsprechenden Event ID kann ein User theoretisch für jedes Event einen Report absenden, auch wenn das Event eventuell in der Vergangenheit oder Zukunft liegt. Dem User wird aber eine entsprechende Info angezeigt:

Reports anzeigen und bearbeiten

In der Reko Übersicht werden alle Reports von Events aus den letzten 3 Monaten angezeigt.
Die Reports sind nach den Events aufgeteilt und die Auflistung erfolgt nach Datum der Events, das neueste Event wird oben angezeigt, das älteste unten.
Sollte es keine Reports geben, ist die Übersicht leer.
Zu sehen sind auf einen Blick alle wichtigen Informationen:

  • Status des Reports

    • new: Report wurde erstellt und bisher nicht bearbeitet

    • saved: Für den Report wurden bereits Informationen zur Straflage hinterlegt

    • done: Report Bearbeitung wurde abgeschlossen und veröffentlicht

  • Erstelldatum: Wann der Report erstellt wurde

  • Melder: Von welchem Team/Fahrer der Report erstellt wurde

  • Gegner: Welches Team/Fahrer beschuldigt wird

  • Zwischenfall/Reko Ergebnis: Hier stehen die wichtigsten Infos wie Runde, Kurve und Replay Zeit oder nach der Bearbeitung steht hier die Reko Entscheidung

  • Optionen: Buttons um Reports zu bearbeiten bzw. im Nachhinein alle Details anzuzeigen

Diese Tabelle aktualisiert sich alle 60 Sekunden automatisch, eine entsprechende Info wird rechts oben eingeblendet:

 

Das Formular zum Bearbeiten eines Report sieht je nach Event Typ - also ob ein Rennen aus den Sprint Cups oder aus der Endurance Serie - etwas anders aus.

Bei Endurance Rennen kann die Strafe aus einer Vorauswahl betroffen werden. Basierend auf dieser Auswahl wird dann auch die Benachrichtigungen an den Streamer und ein Text und Ingame Comand zum Kopieren erstellt.

Bei den Sprint Cups hingegeben kann man die Strafe auf Basis der Auswahl von RaceApp treffen. Und zusätzlich kann man hier Strafpunkte und Strafsekunden vergeben. Beim Klicken auf Speichern & Veröffentlichen wird die Strafe außerdem automatisch zu RaceApp gesendet und dort beim Event hinterlegt. Ein manuelles Eintragen bei RaceApp ist damit nicht mehr notwendig.

Wenn ein Report dann veröffentlicht wurde, ändert sich der Status und die angezeigten Informationen in der Übersicht. Dort gibt es dann auch die Möglichkeit die Kurzbeschreibung und den Ingame Command zu kopieren

 

Live Reko und Post Reko Unterschiede

Post Reko Funktionen

RaceApp Anbindung

Bei der Post Reko für die Sprint Cups wird beim Veröffentlichen von Reports die entsprechende Strafe automatisch zu RaceApp über deren API gesendet und dort beim Event gespeichert. Ein manuelles Anlegen der Strafen in RaceApp ist damit nicht mehr notwendig.

Sollte der Report falsch ausgefüllt worden sein oder sich ein anderer Fehler eingeschlichen haben, gibt es immer die Möglichkeit den Status des Reports wieder zurückzusetzen, das löscht dann auch die Strafe von RaceApp wieder. Das System merkt sich die entsprechende ID der Strafe, die von RaceApp vergeben wird und kann diese dann wieder entfernen.

Wenn keine Strafe gewünscht ist, also z.B. bei NFA dann kann in den beiden Feldern einfach “0” eingetragen werden und somit gibt es keine Strafe

Live Reko Funktionen

Streamer Benachrichtigung

Wenn ein Report bearbeitet und veröffentlicht wird, wird daraufhin eine Benachrichtigung für den Streamer/Stream erstellt. In dieser Benachrichtigung werden dann die Infos aus dem Report angezeigt.
Außerdem können manuelle Benachrichtigungen erstellt werden, welche nützliche Infos beinhalten (Berechtigung wird benötigt).

In meinen Tests habe ich hier die URL einfach in eine Browser Quelle in OBS eingefügt und dort eine Breite von 1100 Pixel und Höhe von 400 Pixel angegeben. Audio sollte entsprechend auch über die Browserquelle wiedergegeben werden zwecks Benachrichtigungssound bei einer neuen Benachrichtigung. Die Benachrichtigungen aktualisieren sich alle 60 Sekunden.

Über diesen Button kann eine neue manuelle Benachrichtigung an den Streamer/Stream erstellt werden. Bitte beachte aber, dass diese Meldung im Stream sichtbar ist!

Dort dann die entsprechenden Infos eintragen, die man dem Streamer oder Stream mitteilen will und auf Erstellen klicken.

 

Discord Benachrichtigungen via Webhook

Diese Funktionen steht sowohl für die Sprint als auch die Endurance Cups zur Verfügung.
Es wird aber nur etwas gepostet, wenn eine gültige Webhook URL in den Einstellungen hinterlegt ist.

Reko Discord Webhook wenn ein neuer Report erstellt wird:

Reko Discord Webhook Benachrichtigung bei Bearbeitung eines Reports:

Reko Einstellungen

In den Reko Einstellungen können diverse Einstellungen vorgenommen werden, dafür wird aber eine entsprechende Berechtigung benötigt.

Diverse Einstellungen

In den Einstellungen ganz oben können diverse Informationen hinterlegt werden.
Hier können z.B. Links zu den Reglements hinterlegt werden oder die Discord Webhook URLs für die Discord Benachrichtigungen.

Strafen

Hier können die Strafen, welche von der Reko beim Bearbeiten eines Reports ausgewählt werden, bearbeitet werden. Wichtig dabei ist, dass die Strafen zwischen Endurance und Sprint Cups unterschiedlich sein können. Es gibt auch die Möglichkeit eine Strafe bei allen Cups anzuzeigen oder komplett auszublenden.
Eine neue Strafe kann oben in der Liste hinzugefügt werden.

Bei Sprint Cup Strafen ist es außerdem wichtig, dass die RaceApp ID ausgefüllt wird, da ohne dieser ID der Report nicht automatisch zu RaceApp übertragen werden kann bzw. dann unvollständig ist.

 

Strafen Kategorien

Hier können die verschiedenen Kategorien bearbeitet werden. Das sind jene Kategorien die die Fahrer beim Erstellen eines Reports auswählen können. Wichtig dabei ist, dass bei den Kategorien zwischen Endurance und Sprint Cups unterschiedlich sein können. Es gibt auch die Möglichkeit eine Kategorie bei allen Cups anzuzeigen oder komplett auszublenden.
Eine neue Kategorie kann oben in der Liste hinzugefügt werden.

Bitte beachte: Änderungen an diesen Kategorien kann auch Auswirkungen auf bereits vorhandene Reports haben, da dort die Beschreibung entsprechend auch angepasst wird

Track Map

Um das Melden von Vorfällen zu erleichtern gibt es die Möglichkeit einen Track Map anzuzeigen. Diese kann in den Einstellung einer Strecke bei der X2R BOP ausgewählt und geändert werden.

Da die Streckenverwaltung in der X2R BOP ist, ist auch dort die Einstellung der Track Map zu finden. Eine entsprechende Berechtigung für die X2R BOP vorausgesetzt.