So schreibst und überprüfst du eine FiveM fxmanifest.lua

Öffne den fxmanifest Generator & Validator

Eine fxmanifest.lua gehört in das Stammverzeichnis einer FiveM-Ressource. Darin werden das unterstützte Spiel, Skripte, Abhängigkeiten und clientseitig gelieferte Dateien deklariert. Wähle das Beispiel, das zu deiner Ressource passt, und ersetze jeden Beispiel-Dateinamen durch eine tatsächlich existierende Datei.

Die hier gezeigten Konfigurations- und Codebeispiele beziehen sich auf FiveM für GTA V Legacy. Enhanced hat andere Laufzeit- und Kompatibilitätsregeln; überprüfe die Legacy-zu-Enhanced-Änderungen von Cfx.re bevor du sie auf einen Enhanced-Server anwendest.

Eine minimale Skriptressource

fx_version 'cerulean'
game 'gta5'

client_script 'client.lua'
server_script 'server.lua'

Verwende client_script für Code, der auf dem Client jedes Spielers läuft, und server_script für FXServer-Code. Füge bei Bedarf Autor-, Beschreibungs- und Versionsmetadaten hinzu. Eine Abhängigkeit kann deine Version überprüfen, aber Versionsmetadaten ändern die Ausführung selbst nicht. Aktuelles CfxLua verwendet Lua 5.4; der lua54-Schalter ist veraltet.

Geteilte Dateien und Abhängigkeiten

fx_version 'cerulean'
game 'gta5'

dependencies { 'ox_lib', 'oxmysql' }
shared_scripts { '@ox_lib/init.lua', 'config.lua' }
client_scripts { 'client/*.lua' }
server_scripts { '@oxmysql/lib/MySQL.lua', 'server/*.lua' }

Dieses Beispiel erfordert die genannten Bibliotheken; lasse sie weg, wenn deine Ressource sie nicht verwendet. Geteilte Skripte werden an Clients geliefert, daher halte Anmeldeinformationen, Webhooks und serverseitige Berechtigungsprüfungen aus geteilten Dateien fern. Deklariere die Abhängigkeiten, die dein Code tatsächlich benötigt, und befolge deren dokumentierte Startreihenfolge.

Eine Browser-Oberfläche mit NUI

fx_version 'cerulean'
game 'gta5'

ui_page 'web/index.html'
files { 'web/index.html', 'web/style.css', 'web/app.js' }
client_script 'client.lua'

Liste alle erforderlichen lokalen UI-Assets auf, einschließlich Schriftarten und Bilder. Eine leere Oberfläche erfordert die Überprüfung sowohl ihres Seitenpfads als auch fehlender Assets. Ein Ladebildschirm verwendet loadscreen und seinen eigenen Lebenszyklus anstelle dieses ui_page-Beispiels.

Karten und zusätzliche Archetypen

fx_version 'cerulean'
game 'gta5'

this_is_a_map 'yes'
files { 'stream/example.ytyp' }
data_file 'DLC_ITYP_REQUEST' 'stream/example.ytyp'

Lege streamfähige Assets in stream ab. Die hier gezeigte YTYP-Registrierung ist für eine Ressource, die diese Datei enthält; eine einfache YMAP-only-Ressource benötigt keine fiktive YTYP. Verwende die data-file-Deklaration, die vom tatsächlichen Asset-Typ benötigt wird.

Starten und überprüfen

1. Überprüfe, ob der Ordner direkt fxmanifest.lua enthält und ob alle Pfade mit den tatsächlichen Dateinamen übereinstimmen, einschließlich der Groß-/Kleinschreibung.
2. Installiere die deklarierten Abhängigkeiten. Füge ensure gefolgt vom Ressource-Ordnernamen zu server.cfg nach den dokumentierten Abhängigkeiten hinzu.
3. Führe refresh und ensure resource-name in der Konsole des Entwicklungsservers aus und setze dabei für resource-name deinen tatsächlichen Ordnernamen ein. Lies den ersten Startfehler.
4. Tritt bei, teste die Ressource und prüfe F8 sowie die Serverkonsole. Teste einen vollständigen Serverneustart, um Abhängigkeits- und Paketierungsfehler zu erkennen, die Hot Reloads verdecken können.

Häufige Fehler

Fehlende Datei: Vergleiche den genauen Manifestpfad und Dateinamen. Fehlender Export: Überprüfe die Abhängigkeitsversion und Initialisierungsreihenfolge. Für Clients sichtbare Geheimnisse: Verschiebe sie aus geteilten/Client-Dateien und rotiere exponierte Werte.

Verkürze kein Anbieter-Manifest, indem du dieses Tutorial darüber kopierst. Verwende die offizielle Manifest-Referenz und data-file Referenz , um jede Deklaration zu verstehen, bevor du sie änderst.