FiveM Phone Scripts Fehlerbehebung FAQ: 12 häufige Probleme gelöst

Drei häufige Ursachen: (1) Die Telefon-Ressource ist in der server.cfg nicht mit „ensure“ versehen oder wurde nach dem Framework nicht gestartet, (2) der NUI-Build-Schritt wurde übersprungen (moderne Telefone benötigen „npm install && npm run build“ im Ressourcenordner), oder (3) der Spieler hat kein Telefon-Item im Inventar, wenn das Skript eines verlangt. Prüfe zuerst mit F8 auf NUI-Fehler, dann überprüfe die Inventar-Anforderung in der Konfiguration des Telefons.

Fehlende Kontakte bedeuten entweder, dass die Tabelle „phone_contacts“ leer ist, oder dass das Identifikator-Format des Spielers nicht mit den gespeicherten Datensätzen übereinstimmt. Führe „SELECT COUNT(*) FROM phone_contacts WHERE identifier = ?“ mit deinem tatsächlichen Identifikator aus – bei null Zeilen wurden nie Kontakte geschrieben. Bei mehr als null Zeilen, aber das Telefon zeigt keine an, hat dein Server wahrscheinlich das Identifikator-Format gewechselt (Steam-Hex zu License zu CitizenID) und alte Datensätze passen nicht zu neuen Identifikatoren.

Fehlgeschlagene Nachrichten sind fast immer SQL-Fehler beim Einfügen in „phone_messages“. Überprüfe die Serverkonsole auf Fehler beim Senden. Häufige Ursachen: Spaltenkonflikt (das Skript erwartet „sender_identifier“, aber die Tabelle hat „senderIdentifier“), eine fehlende NOT-NULL-Spalte oder eine Foreign-Key-Verletzung, wenn der Empfänger nicht registriert ist. Teste durch direktes Einfügen per SQL, um festzustellen, ob es am Skript oder an der Datenbank liegt.

Die Kamera stürzt ab, wenn die Ressource „screenshot-basic“ fehlt, nicht gestartet ist oder keine Upload-Konfiguration hat. Stelle sicher, dass „screenshot-basic“ läuft, und überprüfe die Kamera-Konfiguration des Telefons auf die Upload-Methode – die meisten Telefone nutzen Imgur, manche benutzerdefinierte Endpunkte. Eine falsch konfigurierte Upload-URL führt zu einem schwarzen Bildschirm; eine fehlende Ressource verursacht sofort einen NUI-Fehler.

Soziale Medien-Apps sind eigenständig mit eigenen Datenbanktabellen. Wenn der Feed leer bleibt: Überprüfe, ob die Tabelle „phone_twitter“ oder eine äquivalente existiert und Daten enthält, verifiziere, dass das NUI-IFrame ohne CORS-Fehler lädt (F8 DevTools > Netzwerk-Tab), und bestätige, dass der Spieler ein registriertes Profil in „phone_twitter_accounts“ hat. Die häufigste Lösung ist, die SQL-Installationsdatei des Telefons erneut auszuführen, um fehlende App-Tabellen zu erstellen.

App-Store-Fehler resultieren aus fehlenden oder beschädigten App-Metadaten in der Konfiguration/Tabelle „phone_apps“. Jede installierbare App benötigt einen gültigen Namen, Icon-Pfad, Version und Aktiviert-Flag. Meistens handelt es sich um eine Konfigurationsverschiebung nach einem Telefon-Update – das Telefon erwartet neue Felder (wie „min_version“ oder „category“), die die DB-Migration nicht hinzugefügt hat. Führe die Migrations-SQL des Telefons erneut aus, um das Schema mit der aktuellen Version abzugleichen.

Telefon-GPS verwendet „SetNewWaypoint(x, y)“ clientseitig. Wenn das Setzen eines Ziels nichts bewirkt, überprüfe, ob die übergebenen Koordinaten gültige Zahlen (nicht nil, nicht NaN) sind, und suche nach anderen Skripten, die „DeleteWaypoint“ aufrufen oder Wegpunkte in einer Schleife löschen. Manche HUD-Skripte und Minimap-Ersetzungen stören Wegpunkte – deaktiviere sie vorübergehend zum Isolieren.

Fehlgeschlagene Anrufe resultieren aus einer defekten Integration mit deiner VOIP-Ressource (pma-voice, mumble-voip). Überprüfe, ob die Konfiguration des Telefons auf den korrekten Voice-Ressourcennamen zeigt, dass die Voice-Ressource VOR dem Telefon in der server.cfg mit „ensure“ versehen ist, und dass die Exports der Voice-Ressource mit den vom Telefon erwarteten übereinstimmen. Wenn Anrufe verbunden werden, aber die Audio stumm bleibt, öffnet die Voice-Ressource keinen privaten Anrufkanal – prüfe auf Versionskonflikte.

Entweder die Sounddateien befinden sich nicht im Audio-Ordner des Telefons, sind nicht in der fxmanifest.lua deklariert, oder das NUI blockiert die automatische Audiowiedergabe. Modernes Chromium-embedded NUI blockiert Audio, bis der Benutzer mit der Seite interagiert. Die meisten Telefon-Skripte behandeln dies mit einem Klick beim Laden, aber benutzerdefinierte Forks brechen es oft. Überprüfe die DevTools (F8) auf Warnungen wie „play() failed because the user didn't interact with the document“.

Dark Mode ist eine reine NUI-Funktion, die über eine CSS-Klasse auf dem Wurzelelement umgeschaltet wird. Wenn der Klick auf den Schalter nichts bewirkt, wird der Klick-Handler nicht ausgelöst (prüfe F8 DevTools), oder die CSS-Klasse existiert nicht im Stylesheet. Wenn die Umschaltung funktioniert, aber nicht persistent ist, speichert das Telefon die Einstellung im localStorage, den das NUI zwischen Sitzungen löscht – behebe dies, indem du die Einstellungen serverseitig in einer „phone_settings“-Tabelle speicherst.

Benutzerdefinierte Apps benötigen drei Dinge: (1) einen Eintrag in der App-Konfiguration des Telefons, der exakt dem App-Ordnernamen entspricht, (2) die HTML/JS-Dateien im Pfad, der in der Konfiguration angegeben ist, und (3) die Aufnahme in den „files“-Block der fxmanifest.lua, damit sie an das NUI ausgeliefert werden. Fehlt eines davon, bleibt die App unsichtbar. Durchsuche den Ressourcenordner des Telefons nach deinem App-Namen, um zu überprüfen, ob alle drei Punkte erfüllt sind.

Telefon-Rechnungs-Apps verbinden sich mit einer separaten Rechnungs-/Invoicing-Ressource (okokBilling, qb-banking, esx_billing). Beide Ressourcen müssen laufen, und die Event-Namen auf beiden Seiten müssen übereinstimmen. Überprüfe die Rechnungs-Konfiguration des Telefons auf die Ziel-Ressource, verifiziere, dass diese Ressource mit „ensure“ versehen ist, und beobachte die Serverkonsole beim Öffnen der Rechnungs-App – du siehst, ob das Trigger-Event feuert (oder nicht).