Scripts 2026-04-12

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

TDYSKY

TDYSKY

Founder & Lead Developer at Agency Scripts

Die Kluft zwischen Hobby- und Profi-Tooling

Die meisten FiveM-Admin-Menüs sind auf Hobbyniveau: Buttons für Waffenvergabe, Teleportieren, Noclip und solche Sachen. Agency-Admin ist für Communitys gebaut, die Moderation genauso ernst nehmen wie ein Moderationsteam bei einem echten Game-Studio.

Action-Logging mit Kontext

Jede Admin-Aktion wandert in ein manipulationssicheres Log mit Admin-ID, Ziel, Aktion, Zeitstempel und Grund. Schluss mit den 'Wer hat diesem Spieler einen Rhino gegeben?'-Rätseln. Logs sind über die Admin-UI mit Filtern für Admin, Zeitraum und Aktionstyp abfragbar. Das ist grundlegende Accountability-Infrastruktur, die Staff-Teams tatsächlich brauchen.

Berechtigungsstufen

Drei eingebaute Stufen: Moderator (kicken, Timeout, einfache Item-Checks), Admin (bannen, Items geben, teleportieren), Senior-Admin (Config-Änderungen, Berechtigungsverwaltung, Datenbank-Admin). Die Aktionen jeder Stufe sind strikt eingegrenzt - ein Moderator kann sich nicht durch ein Schlupfloch selbst hochstufen. Wir haben dieses Modell in den letzten zwei Jahren mit mehreren großen Communitys getestet.

Ban-Management

Banns unterstützen Dauer, Grund, Beweis-URL (Screenshot- oder Videolink), Einspruchsstatus und Review-Notizen. Wenn ein gebannter Spieler versucht, wieder beizutreten, enthält die Nachricht, die er sieht, den Grund und - falls konfiguriert - einen Einspruchslink. Transparente Moderation ist effektive Moderation.

Echtzeit-Bedrohungserkennung

Agency-Admin liefert eine konfigurierbare Erkennungsschicht, die verdächtige Muster markiert: plötzliche Geldspitzen, unmögliche Teleports, schnelle Item-Duplikation, ungewöhnliche Waffenspawns. Markierungen tauchen im Admin-Dashboard mit vollem Kontext auf. Wir sind kein Anticheat - wir sind ein Erkennungstool, das die Admin-Reaktionszeit von Stunden auf Minuten senkt.

Installation & Einrichtung

Agency-Admin benötigt oxmysql für die Protokoll-Persistenz. Importiere admin.sql in deine Datenbank, füge die Ressource zum Server hinzu und füge ensure agency-admin zur server.cfg hinzu. Die initiale Admin-Zuweisung erfolgt über config.lua — liste deine vertrauenswürdigsten Identifier als Senior-Admins auf.

Konfigurationsoptionen

  • Berechtigungsstufen — Namen und Fähigkeiten jeder Stufe sind vollständig neu definierbar.
  • Erkennungsschwellen — Konfiguriere Geldsprung-Schwellen, Teleport-Distanzlimits und Item-Anzahl-Geschwindigkeiten für Flags.
  • Discord-Webhook — Alle Admin-Aktionen und Erkennungsflags können parallel in einen Discord-Kanal weitergeleitet werden.
  • Protokoll-Aufbewahrung — Wie viele Tage Admin-Aktionsprotokolle aufbewahrt werden. Standard: 90 Tage.

Framework-Kompatibilität

Agency-Admin funktioniert auf QBCore, ESX und eigenständigen Setups. Die Berechtigungsschicht ist der einzige Framework-berührende Teil — alles andere ist Framework-agnostisch.

Warum das für das Roleplay wichtig ist

Server-Gesundheit hängt direkt von der Moderationsqualität ab. Gemeinschaften mit sichtbarer, konsistenter und verantwortungsvoller Moderation behalten Spieler länger als solche, die auf informellen Einzelfallentscheidungen basieren. Agency-Admins Audit-Log ist der Schlüssel-Accountability-Mechanismus: Wenn eine Moderationsentscheidung angefochten wird, liefert das Log den genauen Kontext.

Häufig gestellte Fragen

Kann ich benutzerdefinierte Admin-Befehle hinzufügen?

Ja. Nutze exports['agency-admin']:RegisterCommand(name, tier, handler), um benutzerdefinierte Befehle zu registrieren, die Agency-Admins Berechtigungsprüfungen und automatische Protokollierung erben.

Wie geht das Bann-System mit VPN/Alt-Accounts um?

Agency-Admin protokolliert den vollständigen Identifier-Satz (Lizenz, Steam, Discord, IP) zum Bann-Zeitpunkt. Bei Wiederverbindungsversuchen werden alle Identifier überprüft.

Voraussetzungen

  • FiveM-Server (QBCore, ESX oder eigenständig)
  • oxmysql
  • cfx.re-Konto mit gültiger Agency-Admin-Lizenz

Eine Staff-Kultur rund um das Tooling aufbauen

Die besten Admin-Tools der Welt helfen nicht, wenn deine Staff-Kultur keine Rechenschaftspflicht unterstützt. Agency-Admins Audit-Log ist am wertvollsten in Gemeinschaften, in denen Staff weiß, dass ihre Aktionen protokolliert werden und dies als Standardbetriebsverfahren akzeptiert, nicht als Überwachung.

Lege früh fest, dass alle Admin-Aktionen über die protokollierte Schnittstelle laufen. Widerstehe der Versuchung, die Protokollierung "nur dieses eine Mal" für schnelle Fixes zu umgehen — der Wert des Protokolls liegt in der Vollständigkeit.

Nutze die Erkennungsflags in wöchentlichen Staff-Reviews, nicht nur wenn etwas schiefläuft. Die Überprüfung einer Woche Flags, auch wenn nichts Bemerkenswertes passiert ist, baut Vertrautheit damit auf, wie normal aussieht, was Anomalien offensichtlich macht, wenn sie auftreten.

Das Berechtigungsstufensystem funktioniert am besten, wenn Beförderungen durch Stufen bedeutsame Meilensteine sind. Ein Moderator, der nach drei Monaten sauberer protokollierter Arbeit Admin-Zugang verdient, hat Kontext und Investition, die ein sofortiger Vollzugriff nicht schafft.

Bann-Transparenz und Community-Vertrauen

Servers, die ihre Bann-Entscheidungen öffentlich oder halböffentlich dokumentieren (anonymisierte Zusammenfassungen, keine persönlichen Details), bauen mehr Community-Vertrauen auf als solche, die Moderationsentscheidungen geheim halten. Agency-Admins strukturiertes Bann-Protokoll macht es leicht, monatliche Moderationsberichte zu erstellen. Spieler, die sehen, dass Cheating, Belästigung und Regelbrüche konsequent sanktioniert werden, fühlen sich sicherer zu investieren.

Notfallprotokolle und Server-Angriffe

Agency-Admin enthält spezifische Features für Notfallsituationen: Massenangriffe, organisierte Cheater-Gruppen, DDoS-begleitende Exploit-Angriffe. Das schnelle Bannen mehrerer Spieler über die Dashboard-Mehrfachauswahl reduziert Reaktionszeiten erheblich. Das "Serversperre"-Feature erlaubt Senior-Admins, alle neuen Verbindungen sofort zu blockieren, während aktive Reaktionen laufen.

Die Erkennungsschicht ist besonders wertvoll bei koordinierten Angriffen. Wenn fünf Spieler innerhalb einer Stunde ungewöhnliche Money-Spikes zeigen, erscheinen alle fünf im Dashboard zeitlich nebeneinander — ein sofortiges Pattern, das bei isolierter Betrachtung unsichtbar wäre. Koordinierte Erkennung ist oft der Unterschied zwischen einem Angriff, der ein Stunde dauert, und einem, der einen ganzen Tag unkontrolliert läuft.

Für Server mit regelmäßigen Angriffen empfehlen wir, den Discord-Webhook für alle Detection-Flags zu aktivieren, nicht nur für Admin-Aktionen. Das gibt deinem off-duty Senior-Admin-Team sofortige mobile Benachrichtigungen bei ungewöhnlicher Aktivität, auch wenn sie nicht eingeloggt sind.

Reaktion auf koordinierte Angriffe

Wenn ein Server Ziel einer koordinierten Gruppe wird — mehrere Cheater, die gleichzeitig einloggen und Schaden anrichten — ist die Reaktionsgeschwindigkeit entscheidend. Agency-Admins Dashboard ermöglicht die Erkennung des Musters (mehrere neue Accounts mit Exploit-Verhalten in kurzer Zeit) und die schnelle Massenban-Reaktion in einer einzigen UI-Aktion.

Das Flag-System ist bei koordinierten Angriffen besonders hilfreich. Wenn fünf neue Spieler innerhalb einer Stunde Geld-Spikes zeigen, erscheinen alle fünf Flags im Dashboard zeitlich nebeneinander. Dieses zeitliche Clustering ist das erkennende Muster — isoliert betrachtet könnte jeder einzelne Flag harmlos sein, zusammen zeigen sie koordiniertes Verhalten.

Die Serversperre-Funktion ist das Notfallwerkzeug. Wenn ein Angriff so schwerwiegend ist, dass keine neuen Verbindungen akzeptiert werden sollten, bis das Problem gelöst ist, sperrt ein einzelner Befehl alle neuen Verbindungen sofort. Bestehende Spieler können den Server weiterhin nutzen. Das gibt dem Admin-Team Zeit für die Untersuchung, ohne alle Spieler zu kicken.

Nach jedem größeren Vorfall empfehlen wir eine post-mortem Überprüfung des Audit-Logs. Was hat als erstes die Flags ausgelöst? Wie viel Zeit verging zwischen erstem Flag und Admin-Reaktion? Was hätte früher erkannt werden können? Diese Überprüfungen verbessern die Reaktionsmuster des Teams kontinuierlich.

Zusammenfassung

Agency Scripts baut seine gesamte Produktlinie nach denselben Grundprinzipien: Framework-agnostische Architektur, schlanke Performance-Eigenschaften, klar dokumentierte Konfiguration und eine API, die echte Composability zwischen den Scripts ermöglicht. Kein Script ist eine Insel — jedes ist so gebaut, dass es gut allein und noch besser als Teil des Ökosystems funktioniert.

Für Fragen zur Installation, Konfiguration oder Kompatibilität ist der Agency Scripts Discord der schnellste Weg zur Hilfe. Die Community dort ist aktiv und hilfsbereit, und das Core-Team ist regelmäßig präsent. Für kritische Probleme steht auch ein direktes Support-Ticket-System auf der Tebex-Produktseite zur Verfügung.

Updates für alle Agency-Scripts werden über Tebex-Benachrichtigungen kommuniziert. Active-Business-Abonnenten erhalten neue Scripts automatisch ohne zusätzlichen Kauf. Changelog-Details erscheinen im #changelog-Kanal des Discords, damit du Updates bewerten kannst, bevor du sie auf einem Produktionsserver installierst.

Share this article

Ready to upgrade your server?

Check out our premium FiveM scripts in the Agency Scripts store or join our Discord community for support and updates.