Agency-Reports: Das Meldewerkzeug für FiveM-Admins, das wirklich genutzt wird

Der Stand der FiveM-Reports im Jahr 2026

Die meisten Server verwenden für Spieler-Reports immer noch Discord-Tickets oder einen Chat-Befehl im Spiel. Beides funktioniert nicht. Discord kennt den Kontext des Spielers nicht, und bei einem Chat-Befehl geht alles verloren, sobald sich der meldende Spieler ausloggt. Admins müssen dann Detektiv spielen, obwohl sie eigentlich als Schiedsrichter agieren sollten. Agency-Reports ist das Tool, das wir uns gewünscht hätten, als wir unser eigenes Server-Team betreut haben.

Kontext wird automatisch erfasst

Wenn ein Spieler einen Report einreicht, erfassen wir automatisch seine Koordinaten, IDs der Spieler in der Nähe, die ausgerüstete Waffe, das Fahrzeug und die letzten 60 Sekunden des Chats. Admins sehen die Situation und nicht nur die Anschuldigung. Allein dadurch halbiert sich die Ermittlungszeit.

Intelligente Zuweisung

Reports werden je nach Typ, Priorität und aktuell online befindlichem Teammitglied an das passende Team weitergeleitet. Cheating-Reports gehen an Tech-Admins, RP-Streitfälle an RP-Admins und Belästigung an die gerade zuständige Person. Offline-Reports werden in die Warteschlange gestellt und über Discord gemeldet. Kein „Kümmert sich jemand darum?“ mehr im Team-Chat.

Nachverfolgung der Bearbeitung

Jeder Meldung wird ein Status zugewiesen: offen, übernommen, in Untersuchung, gelöst, geschlossen. Admins halten die Lösungshinweise dauerhaft bei der Meldung fest. Wenn derselbe Spieler sechs Monate später erneut eine Meldung einreicht, ist sein Verlauf nur einen Klick entfernt. So arbeiten professionelle Moderationsteams in MMOs, in FiveM ist das längst überfällig.

Feedbackschleife für Spieler

Wenn eine Meldung gelöst wird, erhält der Meldende eine kurze Nachricht mit einer Erklärung, was passiert ist. Selbst wenn die Antwort lautet: „Geprüft, keine Maßnahmen erforderlich“, fühlen sich Spieler gehört und nicht ignoriert. Communities, in denen Spieler sich gehört fühlen, bleiben loyal. Das ist der tatsächliche Bindungseffekt guter Moderationstools.

Installation & Einrichtung

Agency-Reports benötigt oxmysql, um den Meldungsverlauf zu speichern. Importiere reports.sql, lege den Resource-Ordner ab und füge hinzu ensure agency-reports in server.cfg. Verbinde deinen Discord-Webhook in config.lua für die Weiterleitung von Benachrichtigungen, wenn niemand online ist. Beim ersten Start werden die Routing-Regeln anhand deiner Konfiguration initialisiert, eine weitere Datenbankeinrichtung ist nicht erforderlich.

Spieler öffnen die Meldeoberfläche im Spiel über eine konfigurierbare Taste (standardmäßig: F9 oder einen Chatbefehl). Das Admin-Dashboard ist ein separates Panel, das nur Spielern mit Admin-Berechtigungsflags zugänglich ist.

Konfigurationsoptionen

Die config.lua steuert Routing, Aufbewahrung und Verhalten der UI:

• Meldekategorien, definiere beliebig viele Kategorien (Cheating, Belästigung, RP-Streitigkeiten, Fehlerberichte usw.) mit Routing-Regeln pro Kategorie.
• Weiterleitung an Teammitglieder, jede Kategorie wird an bestimmte Berechtigungsstufen weitergeleitet. Cheating an technische Admins, RP-Streitigkeiten an RP-Moderatoren usw.
• Liste der automatisch erfassten Daten, legt fest, welche Kontextdaten automatisch erfasst werden (Koordinaten, Spieler in der Nähe, Chat der letzten 60s, Fahrzeug, Waffe). Jedes Feld lässt sich einzeln aktivieren oder deaktivieren.
• Discord-Webhook, URL für die Weiterleitung von Meldungen, wenn niemand online ist. Meldungen, für deren Route kein passender Admin online ist, werden an Discord gesendet.
• Vorlagen für Lösungsmeldungen, passe die Nachricht an, die Spieler erhalten, wenn ihre Meldung geschlossen wird.
• Anonyme Meldungen, lege fest, ob Meldende eine Meldung einreichen können, ohne ihre Identität gegenüber anderen Spielern preiszugeben (Admins sehen immer, wer die Meldung eingereicht hat).

Framework-Kompatibilität

Agency-Reports funktioniert mit QBCore, ESX und standalone. Die einzige Komponente mit Framework-Bezug ist die Berechtigungsprüfung für den Zugriff auf das Admin-Dashboard. Richte für standalone-Setups Config.IsAdmin(src, level) in config.lua ein. Die Speicherung und Weiterleitung aller Meldungen sowie die UI sind framework-unabhängig.

Warum das für Roleplay wichtig ist

Jede ungelöste Spielermeldung ist ein Vertrauensverlust. Wenn ein Spieler eine Meldung einreicht und nie eine Antwort erhält, nimmt er die Sache entweder selbst in die Hand (und verschärft die Situation) oder wendet sich vollständig vom Server ab. Agency-Reports schließt diese Feedbackschleife mit dem System für Lösungsmeldungen. Spieler wissen dadurch, dass ihre Meldung eingegangen ist und bearbeitet wurde, auch wenn das Ergebnis nicht ihren Erwartungen entspricht.

Die automatische Kontexterfassung ist ein praktischer Multiplikator für die Moderation. Admins, die fünf Minuten nach einem Vorfall dazukommen, haben den vollständigen situativen Kontext: wo alle standen, was gesagt wurde und was der Beschuldigte bei sich trug. Sie verbringen ihre Zeit damit, Entscheidungen zu treffen, statt Ereignisse zu rekonstruieren. Diese Verkürzung der Untersuchungszeit erhöht direkt die Anzahl der Meldungen, die ein Admin-Team pro Stunde bearbeiten kann.

Der Zugriff auf den sechsmonatigen Verlauf ist eine oft übersehene Funktion, die Communities langfristig schützt. Muster, die sich über Monate im Meldungsverlauf zeigen, machen Spieler erkennbar, die Regeln langsam und nicht offensichtlich missbrauchen: der gemäßigte Regelbrecher, der drei Meldungen pro Monat einreicht und selbst drei gegen sich hat, aber immer knapp unter der Schwelle für Maßnahmen bleibt. Der Verlauf macht dieses Muster sichtbar.

Häufig gestellte Fragen

Können Spieler Screenshots oder Videos als Beweismaterial an eine Meldung anhängen?

Spieler können eine URL zu externen Beweisen angeben (Imgur, YouTube, Medal.tv). Das direkte Hochladen von Dateien auf den Server wird aus Sicherheits- und Speichergründen nicht unterstützt. Bei Meldungen mit Discord-Anbindung wird die Beweis-URL für eine einfache Prüfung in der Discord-Benachrichtigung aufgeführt.

Was passiert mit Meldungen, wenn der meldende Spieler die Verbindung trennt?

Meldungen bleiben unabhängig vom Verbindungsstatus des Spielers in der Datenbank erhalten. Alle zum Zeitpunkt der Meldung erfassten Kontextdaten (Koordinaten, Chat usw.) werden gespeichert. Admins können Meldungen untersuchen und lösen, nachdem der Meldende den Server verlassen hat. Die Lösungsmeldung wird zugestellt, sobald der Spieler das nächste Mal beitritt.

Können wir Agency-Reports in unseren bestehenden Ticket-Bot integrieren?

Ja, über die Weiterleitung per Discord-Webhook. Wenn dein Ticket-Bot einen Discord-Kanal ausliest, richte den Webhook auf diesen Kanal, damit Meldungen als Discord-Nachrichten erscheinen, die dein Bot verarbeiten kann. Für eine engere Integration löst die Resource ein serverseitiges Event aus agency-reports:onNewReport auf das jedes serverseitige Script reagieren kann.

Gibt es eine Funktion zum massenhaften Schließen von Meldungen bei Events mit vielen Reports?

Ja. Das Admin-Dashboard bietet eine Mehrfachauswahl in der Meldungsliste. Senior-Admins können mehrere Meldungen auswählen, eine gemeinsame Lösung hinzufügen und sie gesammelt schließen. Praktisch nach Server-Events, bei denen mehrere Meldungen zum selben Vorfall eingehen.

Voraussetzungen

• FiveM-Server (QBCore, ESX oder standalone)
• oxmysql
• cfx.re-Konto mit gültiger Agency-Reports-Lizenz
• Discord-Webhook-URL (für Benachrichtigungen, wenn du offline bist)

Neue Teammitglieder mit Agency-Reports einarbeiten

Neue Moderatoren profitieren besonders vom strukturierten Workflow von Agency-Reports. Das System führt sie durch den Untersuchungsprozess, ohne dass sie umfangreich geschult werden müssen. Wenn ein neuer Moderator seine erste Meldung übernimmt, erhält er automatisch den gesamten Kontext. Er muss nicht fragen: "Was ist passiert?", denn die zuvor erfassten Daten beantworten die meisten Fragen, noch bevor er ein Wort tippt.

Die Pflicht, eine Lösung zu dokumentieren (optional, aber per Konfiguration empfohlen), dient als Schulungsinstrument. Eine Lösung wie "Aufzeichnung geprüft, Spieler hat eindeutig gegen Regel 3.2 verstoßen, 24-Stunden-Bann verhängt" zwingt den Moderator, seine Begründung klar zu formulieren. Das verbessert mit der Zeit die Qualität der Entscheidungen und schafft eine nachvollziehbare Dokumentation für Eskalationen oder Einsprüche.

Wenn deine Community von Discord-Tickets auf Agency-Reports umsteigt, solltest du beide Systeme zwei bis vier Wochen parallel betreiben. Lass dein Team selbst entscheiden, welches System es bevorzugt, und erfasse dabei die Bearbeitungszeit und die Zufriedenheit der Meldenden. Die Daten zeigen in der Regel, dass Agency-Reports Tickets schneller löst. Nutze diese Erkenntnisse, um die freiwillige Einführung zu fördern, anstatt den Wechsel vorzuschreiben.