FiveM Admin-Skripte FAQ zur Fehlerbehebung: 12 häufige Probleme behoben

Adminmenüs öffnen sich nicht, wenn deine Identifier nicht in der Admin-Konfiguration stehen, das Identifier-Format falsch ist (Steam vs. License vs. Discord) oder die NUI nicht geladen hat. Gib deine Identifier über die F8-Konsole mit `GetPlayerIdentifiers(PlayerId())` aus und vergleiche jeden einzelnen mit der Admin-Konfiguration. Stimmen die Identifier überein, das Menü öffnet sich aber trotzdem nicht, suche in F8 nach NUI-Build-Fehlern – moderne Adminmenüs (ESX-Menu, qb-adminmenu) benötigen einen npm-Build-Schritt.

Berechtigungsfehler entstehen durch falsche Identifier-Formate oder eine unvollständige ACE-Berechtigungseinrichtung. FiveM hat mehrere Identifier-Typen: steam, license, discord, fivem, ip. Dein Admin-Script prüft möglicherweise nur einen. Finde das Identifier-Format in der Admin-Konfiguration und prüfe, ob dein tatsächlicher Identifier dieses Typs exakt übereinstimmt. Bei ACE-basierten Systemen werden sowohl `add_ace` als auch `add_principal` benötigt – fehlt einer, wird der Zugriff stillschweigend verweigert.

NoClip geht kaputt, wenn ein Anti-Cheat-Resource die plötzliche Geschwindigkeitsänderung als unbefugte Bewegung markiert oder ein Bewegungs-Script die Spielersteuerung überschreibt. Whiteliste deinen Admin-Identifier in der Anti-Cheat-Konfiguration und überprüfe, ob kein Ausdauer-, Sprint- oder Bewegungs-Script die Geschwindigkeit in einer Schleife zurücksetzt. Kontrolliere außerdem, ob `SetEntityCollision` mit den richtigen Boolean-Argumenten aufgerufen wird – vertauschte Argumente erzeugen einen Ped, der zwar durch die Welt clippt, sich aber nicht bewegen kann.

Teleport verwendet `SetEntityCoords`, um den Spieler zu versetzen. Schlägt der Teleport von Spieler zu Spieler fehl, funktioniert aber mit statischen Koordinaten, dann werden die Koordinaten des Zielspielers nicht synchronisiert – meist weil das Koordinaten-Event vor dem Teleport noch nicht aufgelöst wurde. Anti-Cheat-Resources blockieren zudem oft plötzliche große Positionsänderungen. Whiteliste den Teleport-Eventnamen aus deinem Admin-Resource in der Anti-Cheat-Konfiguration.

Eine leere Spielerliste bedeutet, dass der serverseitige `GetPlayers()`-Aufruf keine Ergebnisse zurückgegeben hat oder die Antwort nie beim Client angekommen ist. Das passiert, wenn das Admin-Resource startet, bevor sich Spieler verbinden (normal), oder wenn der Event-Handler für die Spielerliste einen Fehler hat. Überprüfe die Server-Konsole auf Fehler, die beim Öffnen des Spielerlisten-Panels ausgelöst werden. Liefert `GetPlayers()` auf einem laufenden Server eine leere Tabelle zurück, hat ein Framework-Update die API geändert.

Eine dauerhafte Bann-Speicherung erfordert eine Datenbanktabelle. Werden Banns beim Neustart zurückgesetzt, schreibt das Bann-Event in eine speicherinterne Tabelle, anstatt einen INSERT-Query auszuführen. Überprüfe, ob die Bann-Tabelle in deiner Datenbank existiert – führe `SELECT * FROM bans` aus. Fehlt die Tabelle, führe die SQL-Installationsdatei des Admin-Scripts aus. Wenn Zeilen vorhanden sind, aber gebannte Spieler trotzdem beitreten können, fragt die Bann-Prüfung beim Spielerbeitritt nicht die Datenbank ab oder verwendet die falsche Identifier-Spalte.

Schwarze Bildschirme im Spectate-Modus treten auf, wenn die Kamera angebracht wird, bevor der Standort des Ziels auf dem Client des Zuschauers geladen ist, oder wenn sich das Ziel in einem Interior befindet, das noch nicht angefordert wurde. Rufe `PinInteriorInMemory` und `LoadInterior` auf, bevor du die Kamera anbringst. Befindet sich das Ziel im Freien und der Spectate zeigt trotzdem schwarz, feuert das Netzwerk-Kamera-Attach-Event möglicherweise, bevor der Ped des Zielspielers gestreamt ist – füge eine kurze `HasEntityLoaded`-Prüfung ein.

Fehler bei Admin-Logs haben drei Ursachen: Die Tabelle `admin_logs` existiert nicht, die Protokollierung ist in der Konfiguration deaktiviert (`Config.EnableLogs = false` o.ä.) oder eine Discord-Webhook-URL ist ungültig oder wird ratenlimitiert. Überprüfe die Existenz der Tabelle mit `SELECT COUNT(*) FROM admin_logs`. Falls Discord-Webhooks verwendet werden, teste die URL mit einem manuellen curl-POST – eine 429-Antwort bedeutet Ratenlimitierung. Aktiviere sowohl Datenbank- als auch Discord-Protokollierung, um einen Fallback zu haben.

God-Mode setzt `SetEntityInvincible` auf den Ped des Spielers. Schaltet er sich zufällig aus, ruft ein anderes Resource `SetEntityHealth` in einer Schleife auf und der Unverwundbarkeitsstatus wird aufgehoben. HUD-Scripts (Hunger/Durst/Rüstungs-Updates), Schadenshandler-Scripts und Status-Systeme sind die häufigsten Übeltäter. Überwache die Gesundheit mit einer Debug-Schleife und achte auf den genauen Tick, an dem sie fällt – der Call-Stack zeigt dir, welches Resource verantwortlich ist.

Das Admin-Fahrzeug-Spawning verwendet `CreateVehicle` mit einem Model-Hash. Schlägt das Spawning stillschweigend fehl, ist der Modellname ungültig (falsch geschrieben oder falsche Groß-/Kleinschreibung) oder das Modell befindet sich nicht im Streaming-Manifest. Standard-GTA-Fahrzeuge werden immer korrekt gehasht – wenn auch sie fehlschlagen, liegt das Problem im `CreateVehicle`-Aufruf des Spawners. Benutzerdefinierte Modded-Fahrzeuge benötigen ihren exakten DLC-Spawn-Namen, der sich vom Anzeigenamen unterscheidet. Verwende den Ordnernamen des Fahrzeugs im Stream-Verzeichnis.

Wetter- und Zeitbefehle ändern server-synchronisierte Werte, aber Wetter-Sync-Resources überschreiben diese in einer Schleife – normalerweise alle 1 bis 5 Minuten. Wenn dein Admin-Befehl ausgeführt wird, das Wetter aber innerhalb von Minuten zurückgesetzt wird, setzt ein Sync-Resource es zurück. Nutze entweder die eigene API des Sync-Resources, um das Wetter zu ändern (falls vorhanden), stoppe das Sync-Resource temporär zum Testen oder füge eine Ausnahme in der Konfiguration des Sync-Resources für vom Admin gesetztes Wetter hinzu.

Der Admin-Chat sendet auf einen separaten Chat-Kanal, der möglicherweise nicht so konfiguriert ist, dass er für Nicht-Admins angezeigt wird, oder der Event-Name hat sich nach einem Resource-Update geändert. Überprüfe das Admin-Chat-Event und stelle sicher, dass es `TriggerClientEvent` an alle Spieler mit dem korrekten Chat-Resource-Event-Namen aufruft. Bei QBCore ist das Chat-Resource qb-chat und Admin-Nachrichten verwenden ein bestimmtes Channel-Tag. Bei ESX mit es_extended-Chat überprüfe, ob der Channel registriert und sichtbar ist.