Die Kunst, FiveM-Scripts zu debuggen
Das Debuggen von FiveM-Scripts unterscheidet sich grundlegend vom Debuggen von Standardanwendungen. Du hast es mit einer geteilten Client-Server-Architektur zu tun, bei der Code auf zwei separaten Laufzeiten ausgeführt wird, Ereignisse über das Netzwerk übertragen werden und sich der Spielstatus in jedem Frame ändert. Wenn etwas schief geht, kann es sein, dass der Fehler auf dem Server entsteht, sich aber auf dem Client manifestiert, oder umgekehrt. Durch die Entwicklung eines systematischen Debugging-Ansatzes sparest du unzählige Stunden und beschleunigen deinen Entwicklungsworkflow erheblich. Dieser Leitfaden behandelt die wesentlichen Tools, Techniken und Muster, die professionelle FiveM-Entwickler täglich verwenden.
Print-Anweisungen effektiv nutzen
Das grundlegendste Debugging-Tool in FiveM ist die Funktion print(), aber ihre effektive Nutzung erfordert mehr als nur das Dumpen von Variablen. Strukturiere deine Debug-Ausgabe mit Präfixen, die das Script, die Seite (Client oder Server) und die Funktion identifizieren, auf der der Ausdruck erfolgt. Verwende Farbcodes, um wichtige Nachrichten in der Konsole hervorzuheben. Erstelle ein Debug-Dienstprogramm, das du ein- und ausschalten können, ohne Debugzeilen aus deinem Code zu entfernen.
Verwenden des Debug-Dienstprogramms
Mit diesem Dienstprogramm kannst du in deinen Scripts eine Debug-Protokollierung hinzufügen, die in der Produktion völlig geräuschlos erfolgt. Aktiviere es, indem du set myresource_debug true zu deiner Serverkonfiguration hinzufügen, wenn du eine Fehlerbehebung durchführen müssen. Die strukturierte Ausgabe macht es einfach, Konsolenprotokolle zu durchsuchen und genau das zu finden, wonach du suchen.
Häufige FiveM-Fehler und Lösungen
SCRIPT-FEHLER: Versuch, einen Nullwert zu indizieren
Dies ist der häufigste Lua-Fehler in der FiveM-Entwicklung. Das bedeutet, dass du versuchen, auf eine Eigenschaft oder Methode einer Variablen zuzugreifen, die nil ist. Die häufigsten Ursachen sind der Zugriff auf Player-Daten vor dem Laden, der Verweis auf eine Framework-Funktion, die in der von Ihnen verwendeten Version nicht vorhanden ist, oder das Lesen eines Konfigurationswerts mit einem Tippfehler im Schlüssel. Prüfe immer auf Null, bevor du auf verschachtelte Eigenschaften zugreifen.
SCRIPT-FEHLER: Versuch, einen Nullwert aufzurufen
Dieser Fehler tritt auf, wenn du versuchen, eine Funktion aufzurufen, die nicht existiert. In FiveM geschieht dies häufig, wenn du einen Export von einer Ressource aufrufen, die noch nicht gestartet wurde, eine Framework-Funktion verwenden, die in einem Update umbenannt wurde, oder vergessen, eine freigegebene Datei in dein Manifest zu laden. Überprüfe dein fxmanifest.lua, um sicherzustellen, dass alle erforderlichen Dateien aufgelistet und in der richtigen Reihenfolge sind.
Veranstaltung wurde nicht registriert
Wenn du ein Ereignis auslösen, für das kein Script einen Handler registriert hat, verwirft FiveM es stillschweigend und ohne Fehler in der Konsole. Das kann beim Debuggen wahnsinnig werden, weil alles korrekt aussieht, aber nichts passiert. Verwende eine Hilfsfunktion, um zu überprüfen, ob Ereignisse registriert sind, bevor du sie auslösen, und fügst du während der Entwicklung eine Protokollierung rund um deine Ereignisauslöser hinzu.
NUI-Debugging mit DevTools
Für Scripts mit NUI-Schnittstellen sind die integrierten Chromium DevTools von unschätzbarem Wert. Öffne sie mit der F8-Konsole, indem du nui_devtools eingeben, um auf den vollständigen Chrome-Inspektor zuzugreifen. Dadurch erhältst du das Bedienfeld „Elemente“ zum Überprüfen der DOM-Struktur, die Konsole für JavaScript-Fehler, die Registerkarte „Netzwerk“ zum Laden von Ressourcen und das Bedienfeld „Quellen“ zum Festlegen von Haltepunkten. Bei NUI-Kommunikationsproblemen protokollierest du beide Seiten der Nachrichtenbrücke.
Profiling mit Resmon und Timing
Über die grundlegende resmon-Überwachung hinaus kannst du eine präzise Timing-Instrumentierung in deine Scripts integrieren. Messe, wie lange bestimmte Vorgänge dauern, und protokollierest du Warnungen, wenn sie akzeptable Schwellenwerte überschreiten. Dies ist besonders wichtig für Datenbankabfragen, komplexe Berechnungen und Schleifen, die viele Entitäten verarbeiten.
State-Bag-Debugging
Staatstaschen sind eine wirkungsvolle, aber manchmal verwirrende Funktion. Wenn Status-Bag-Werte nicht wie erwartet aktualisiert werden, liegt das normalerweise daran, dass du sie auf die falsche Entität festlegen, der Handler nicht den richtigen Bag-Namen abfängt oder die Replikation verzögert ist. Erstelle einen State-Bag-Inspector-Befehl, der den gesamten Status für eine bestimmte Entität ausgibt.
Grundlegende Debugging-Checkliste
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.