Agency-Admin: Professionelle Moderationstools für echte FiveM-Communitys

Die Lücke zwischen Hobby- und Profi-Tools

Die meisten FiveM-Admin-Menüs sind auf Hobby-Niveau: Waffen geben, teleportieren, Noclip und ähnliche Funktionen. Agency-Admin wurde für Communities entwickelt, die Moderation genauso ernst nehmen wie ein Moderationsteam in einem echten Spielestudio.

Aktionsprotokollierung mit Kontext

Jede Admin-Aktion wird mit Admin-ID, Ziel, Aktion, Zeitstempel und Begründung in einem manipulationssicheren Protokoll festgehalten. Schluss mit Rätseln wie „Wer hat diesem Spieler einen Rhino gegeben?“. Die Protokolle lassen sich über die Admin-Oberfläche filtern, nach Admin, Zeitraum und Aktionstyp. Das ist grundlegende Infrastruktur für Rechenschaftspflicht, die Staff-Teams wirklich brauchen.

Berechtigungsstufen

Drei integrierte Stufen: Moderator (kicken, Timeout, einfache Item-Prüfungen), Admin (bannen, Items geben, teleportieren), Senior-Admin (Konfigurationsänderungen, Berechtigungsverwaltung, Datenbankverwaltung). Die Aktionen jeder Stufe sind streng begrenzt, ein Moderator kann sich nicht durch das Finden einer Sicherheitslücke selbst höhere Rechte verschaffen. Wir haben dieses Modell in den letzten zwei Jahren mit mehreren großen Communities getestet.

Ban-Verwaltung

Bans unterstützen Dauer, Begründung, Beweis-URL (Screenshot oder Videolink), Einspruchsstatus und Prüfnotizen. Wenn ein gebannter Spieler versucht, erneut beizutreten, enthält die angezeigte Nachricht die Begründung und, falls konfiguriert, einen Einspruchslink. Transparente Moderation ist wirksame Moderation.

Bedrohungserkennung in Echtzeit

Agency-Admin enthält eine konfigurierbare Erkennungsebene, die verdächtige Muster markiert: plötzliche Geldsprünge, unmögliche Teleports, schnelle Item-Duplizierung und ungewöhnliche Waffen-Spawns. Markierungen erscheinen mit vollständigem Kontext im Admin-Dashboard. Wir sind kein Anticheat, sondern ein Erkennungstool, mit dem Admins statt Stunden nur noch Minuten für eine Reaktion brauchen.

Installation & Einrichtung

Agency-Admin benötigt oxmysql, um Protokolle dauerhaft zu speichern. Importiere admin.sql in deine Datenbank, füge die Resource zu deinem Server hinzu und ergänze ensure agency-admin in server.cfg . Die ersten Admins legst du über config.luafest. Trage dort die Kennungen der Personen ein, denen du am meisten vertraust, als Senior-Admins. Alle weiteren Berechtigungen werden anschließend über die Ingame-Oberfläche vergeben.

Die Resource erkennt dein Framework beim Start automatisch. Berechtigungsschnittstellen für QBCore und ESX sind enthalten. Bei standalone-Setups musst du die Funktion Config.IsAdmin(src, level) manuell implementieren.

Konfigurationsoptionen

Die config.lua enthält Einstellungen für Berechtigungen und Erkennung:

• Berechtigungsstufen, Namen und Funktionen der einzelnen Stufen lassen sich vollständig neu festlegen. Das Standardmodell mit drei Stufen ist ein Ausgangspunkt, keine Vorgabe.
• Erkennungsschwellenwerte, konfiguriere den Schwellenwert für Geldsprünge, die maximale Teleport-Distanz und die Item-Anzahl pro Zeitspanne, ab denen Markierungen ausgelöst werden.
• Discord-Webhook, alle Admin-Aktionen und Erkennungsmarkierungen können zusätzlich zum Ingame-Protokoll auch an einen Discord-Kanal gesendet werden.
• URL für Ban-Einsprüche, die URL, die gebannten Spielern in ihrer Ban-Nachricht angezeigt wird.
• Aufbewahrungsdauer der Protokolle, wie viele Tage Admin-Aktionsprotokolle vor der automatischen Bereinigung aufbewahrt werden. Standard: 90 Tage.
• Tarnmodus für erfahrene Admins, erfahrene Admins können den Server anonym durchsuchen, ohne in Spielerlistsen aufzutauchen.

Framework-Kompatibilität

Agency-Admin läuft mit QBCore, ESX und standalone-Setups. Die Berechtigungsebene ist der einzige Teil, der das Framework berührt. Alles andere (UI, Protokollierung, Ban-System, Erkennungs-Engine) ist frameworkunabhängig. Für benutzerdefinierte Frameworks besteht der Kompatibilitäts-Shim aus vier Funktionen in config.lua.

Warum das für Roleplay wichtig ist

Der Zustand des Servers hängt direkt von der Qualität der Moderation ab. Communities mit sichtbarer, konsequenter und nachvollziehbarer Moderation binden Spieler länger als solche, die sich auf informelle Einschätzungen verlassen. Das Audit-Protokoll von Agency-Admin ist der zentrale Mechanismus zur Rechenschaftspflicht: Wird eine Moderationsentscheidung angefochten, zeigt das Protokoll genau, was wann passiert ist und wer es autorisiert hat.

Die Erkennungsebene verändert die Arbeitsweise des Admin-Teams von reaktiv zu proaktiv. Statt auf Spielermeldungen über mutmaßliche Cheater zu warten, zeigt das Dashboard verdächtige Muster an, bevor sie dem gesamten Server schaden. Ein Money-Dupe, der in der ersten Stunde entdeckt wird, richtet deutlich weniger Schaden an als einer, der zwei Tage lang unentdeckt läuft.

Das Berechtigungsstufensystem schützt vor Risiken durch Insider. Wenn ein neu eingestellter Moderator denselben Zugriff wie ein erfahrener Admin hat, ist das ein Sicherheits- und Haftungsrisiko. Eng begrenzte Berechtigungen sorgen dafür, dass der Schaden selbst dann begrenzt bleibt, wenn ein Teammitglied aus der Reihe tanzt.

Häufig gestellte Fragen

Kann ich eigene Admin-Befehle hinzufügen, die in das Berechtigungssystem integriert sind?

Ja. Verwende exports['agency-admin']:RegisterCommand(name, tier, handler) um eigene Befehle zu registrieren, die die Berechtigungsprüfungen und die automatische Protokollierung von Agency-Admin übernehmen. Dein Befehl erscheint in der Befehlsliste der Admin-UI und wird genauso wie integrierte Aktionen protokolliert.

Wie geht das Ban-System mit VPNs und Zweitaccounts um?

Agency-Admin protokolliert beim Bannen den vollständigen Satz an Kennungen (license, steam, discord, IP). Bei erneuten Verbindungsversuchen werden alle Kennungen geprüft, nicht nur die für den Login verwendete. Für Server mit anhaltenden Problemen durch Ban-Umgehungen enthält das Dashboard ein Markierungssystem für verdächtige Kennungsmuster.

Können Moderatoren die Erkennungsmarkierungen sehen, bevor sie Maßnahmen ergreifen?

Markierungen werden allen Admins angezeigt, deren Berechtigungsstufe mindestens der für diesen Markierungstyp festgelegten Mindeststufe entspricht. Markierungen zu ungewöhnlichen Geldanstiegen sind für alle Admins sichtbar. Markierungen zu unmöglichen Teleports werden standardmäßig nur an Tech-Admins weitergeleitet. Auch das Anzeigen von Markierungen wird protokolliert. Admins können sehen, welche Markierungen ihre Kollegen geprüft haben und welche Maßnahmen (falls überhaupt) ergriffen wurden.

Verträgt sich Agency-Admin mit anderen Admin-Menüs wie vMenu oder qb-adminmenu?

Ja. Agency-Admin kann parallel zu anderen Menüs laufen. Sie verwenden unterschiedliche Tastenbelegungen und teilen keinen Status. Manche Server betreiben Agency-Admin während des Übergangs neben einem älteren Admin-Menü. Dabei nutzen sie Agency-Admin für Protokollierung und Erkennung und behalten vertraute Befehle für erfahrene Teammitglieder bei.

Voraussetzungen

• FiveM-Server (QBCore, ESX oder standalone)
• oxmysql
• cfx.re-Konto mit gültiger Agency-Admin-Lizenz
• Optional: Agency-Reports (für die integrierte Bearbeitung von Spielermeldungen)

Eine Teamkultur rund um die Tools aufbauen

Die besten Admin-Tools der Welt helfen nicht, wenn die Teamkultur keine Rechenschaftspflicht unterstützt. Das Audit-Protokoll von Agency-Admin ist in Communities besonders wertvoll, in denen das Team weiß, dass seine Aktionen protokolliert werden, und das als Standardverfahren statt als Überwachung betrachtet.

Stelle von Anfang an klar, dass alle Admin-Aktionen über die protokollierte Oberfläche laufen. Widerstehe der Versuchung, die Protokollierung „nur dieses eine Mal“ für schnelle Korrekturen zu umgehen. Der Wert des Protokolls liegt in seiner Vollständigkeit. Ein Protokoll mit Lücken ist fast so schlecht wie gar keines, wenn du Ereignisse nachträglich rekonstruieren musst.

Nutze die Erkennungsmarkierungen bei wöchentlichen Team-Reviews und nicht nur dann, wenn etwas schiefläuft. Wenn ihr die Markierungen einer Woche auch dann durchgeht, wenn nichts Besonderes passiert ist, lernt ihr, wie der Normalzustand aussieht. So fallen Anomalien leichter auf, wenn sie auftreten.

Das Berechtigungsstufensystem funktioniert am besten, wenn Beförderungen durch die Stufen bedeutsame Meilensteine sind. Ein Moderator, der sich nach drei Monaten sauber protokollierter Arbeit Admin-Zugriff verdient, bringt Erfahrung und Einsatzbereitschaft mit, die eine sofortige Freigabe aller Berechtigungen nicht schafft.