FiveM-Resource startet nicht: Fehler anhand der Konsolenmeldung beheben

Eine FiveM-Resource startet nicht, wenn der Server sie nicht findet, ihr Manifest nicht lesen kann, sie vor einer Abhängigkeit startet, ein Lua-Fehler auftritt oder die Berechtigung (Entitlement) verweigert wird. Suche den ersten Fehler, der die Resource nennt, und nutze dann den passenden Abschnitt unten.

Meldungen werden nur zitiert, wenn eine Cfx.re-Seite, eine Framework- oder Bibliotheksdokumentation, die Doku eines Verkäufers oder ein Beitrag im Cfx.re-Forum sie zeigt; die Quelle steht jeweils daneben. Wo sich keine genaue Meldung belegen ließ, steht das im Abschnitt. Das ist eine Dokumentationsprüfung vom 2026-10-13, kein Praxistest: Nichts davon wurde auf einem Server nachgestellt.

Zuerst die Konsole lesen

1. Starte den Server neu und suche in der Serverkonsole (oder in der txAdmin Live Console, siehe So findest und liest du txAdmin-Logs) nach dem Namen der Resource.
2. Nimm den ersten Fehler, der sie erwähnt. Spätere Zeilen sind oft nur Folgen: Eine fehlgeschlagene Abhängigkeit lässt jede Resource scheitern, die sie braucht.
3. Kopiere diese Zeile samt Dateipfad und Zeilennummer und notiere dir Resource-Version, Framework, FXServer-Artifact-Nummer und GTA-V-Edition.

Der FiveM-Script-Tester hat einen Fehler-Explainer, der in deinem Browser läuft; schwärze Lizenzschlüssel und IPs, bevor du ein Log teilst.

Welche Meldung hast du?

Du siehst	Verweist auf	Quelle
Couldn't find resource	Ordner oder Manifest liegt nicht dort, wo der Server sucht	Cfx.re-Forumsthread
does not specify an `fx_version` in fxmanifest.lua dann Couldn't start resource ...	Manifest-Version fehlt oder wird nicht unterstützt	Cfx.re-Forumsthread
Could not start dependency X for resource Y.	Resource X ist zuerst fehlgeschlagen	Derselbe Thread
No such export ... in resource ...	Provider läuft nicht, startet später oder der Export-Name ist falsch	ox_inventory-Doku
Error parsing script / Error loading script / Failed to load script	Lua-Syntaxfehler oder Fehler beim Laden	Forum, Forum
You lack the required entitlement	Server-Key und Besitzer der Resource passen nicht zusammen	Asset-Escrow-Doku
Native XXXXXXXX is not supported	Veraltetes Server-Artifact	ESX-Doku

1. Der Server findet die Resource nicht

Bedeutung: Laut der Cfx.re-Einführung ins Scripting braucht eine Resource ein Manifest, damit sie erkannt wird. Gibt es unter diesem Namen keinen Ordner mit einer lesbaren fxmanifest.lua, gibt es nichts zu starten.

Prüfen: Liste den Pfad auf. Gewünscht ist resources/[optional_group]/resource_name/fxmanifest.lua. ZIP-Archive können zu resource_name/resource_name/fxmanifest.lua entpackt werden. Vergleiche den Namen nach ensure mit dem Ordnernamen, einschließlich -, _ und unter Linux der Groß- und Kleinschreibung. Bei einem Ordner, der hinzugefügt wurde, während der Server läuft, durchsucht refresh resources erneut und lädt die Manifeste (Server-Befehle).

Lösung: Verschiebe den inneren Ordner eine Ebene nach oben, korrigiere den Namen, führe refresh aus und dann ensure resource_name. Fehlen alle eigenen Resources, während die Standard-Resources funktionieren, prüfe auch den Upload: Im oben verlinkten Forumsthread berichtete der Fragesteller, dass der Wechsel des FTP-Clients (von WinSCP zu FileZilla) das Problem behoben habe, ohne zu wissen, warum. Das ist ein Einzelfall, und die in Abschnitt 5 zitierten Verkäufer-Docs berichten für geschützte Dateien das Gegenteil (FileZilla beschädigt sie). Das Archiv erneut hochzuladen und auf dem Server zu entpacken ist der sicherere Test.

2. Das Manifest fehlt, ist falsch oder zu neu

Bedeutung: Die Manifest-Referenz besagt, dass eine Resource eine Manifest-Version angeben muss und dass Resources ohne eine derzeit einen Standardwert erhalten, der entfernt werden soll. Sie nennt cerulean, bodacious und adamant als fx_version-Werte sowie gta5 und rdr3 unter den game-Werten.

Prüfen: Öffne fxmanifest.lua und prüfe, ob fx_version und game vorhanden sind. Im Forumsthread widersprechen sich die Antworten: Eine sagt, der Wert bodacious brauche einen neueren Server-Build (er kam mit 2207 dazu), eine andere rät, das neueste Artifact herunterzuladen, und eine dritte hatte denselben Fehler bei jedem Build. Betrachte ein veraltetes Artifact als eine mögliche Ursache. Prüfe außerdem, ob jede Datei in client_script, server_script, shared_script und files existiert. Für die genaue Meldung bei einer fehlenden, aufgelisteten Datei fand ich keine Cfx.re-Quelle; bestätige es daher, indem du das Manifest mit dem Ordnerinhalt abgleichst.

Lösung: Stelle das Original-Manifest aus dem Download wieder her oder aktualisiere das Artifact. Ein eigenes schreiben: So schreibst und prüfst du eine FiveM fxmanifest.lua.

3. Eine Abhängigkeit wurde nicht gestartet

Bedeutung: Die dependency-Direktive im Manifest verlangt, dass die genannte Resource vor der aktuellen geladen wird. Im Forumsthread zeigt das Log, wie die Abhängigkeit mit einer eigenen Warnung scheitert, gefolgt von Could not start dependency essentialmode for resource esplugin_mysql. Die abhängige Resource ist nur das Symptom.

Prüfen: Scrolle nach oben zum ersten Fehler zur Abhängigkeit und lies ihn. Prüfe dann, ob die Abhängigkeit in der server.cfg per ensure gestartet wird (üblicherweise oberhalb deiner Resource) und ob der Name im Manifest dem Ordnernamen der Abhängigkeit entspricht.

Lösung: Repariere die Abhängigkeit; ihre Meldung findest du in den anderen Abschnitten. Referenzen zur Startreihenfolge: QBCore, ESX, Qbox und FiveM server.cfg konfigurieren und Änderungen prüfen.

4. No such export

Bedeutung: Die ox_inventory-Doku nennt drei wahrscheinliche Ursachen für No such export * in resource ox_inventory: Beim Start von ox_inventory oder einer Abhängigkeit wie ox_lib ist ein Fehler aufgetreten; die aufrufende Resource startet vor ox_inventory; oder der aufgerufene Export existiert nicht. Dasselbe Muster, no such export getPlayerData in resource mumble-voip, taucht in einem Cfx.re-Forumsthread auf, der unbeantwortet ist.

Prüfen: (1) Die genannte Resource ist ohne Fehler gestartet, (2) ihre ensure-Zeile steht über der des Aufrufers, (3) der Export-Name im Aufrufer stimmt mit dem Code und dem Manifest des Providers überein. Die Lua-Runtime-Seite ergänzt, dass Manifest-Exports erst nach dem ersten Scheduler-Tick verfügbar sind; Code, der einen sehr früh aufruft, ist deshalb verdächtig.

Lösung: Behebe zuerst den eigenen Fehler des Providers, dann die Reihenfolge, dann den Namen. Lege niemals einen leeren Export an, um die Zeile zum Schweigen zu bringen.

5. Lua-Fehler beim Laden eines Scripts

In den Forumsthreads tauchen zwei Formen auf: Error parsing script ... in resource ...: ... unexpected symbol (die Datei lässt sich nicht parsen) und Error loading script ... in resource ...: ... attempt to index a nil value (global 'ESX') (die Datei wurde geparst, scheiterte dann aber bei der Ausführung); beide werden meist von Failed to load script ... gefolgt.

• nil-Framework-Objekt. Im es_extended-Thread trat Failed to load script @es_extended/imports.lua zusammen mit global 'ESX' als nil auf. Die Antworten schlugen vor, zu prüfen, wie das Manifest imports.lua einbindet, und ein neueres ESX zu verwenden; der Thread hält keine bestätigte Lösung fest. Prüfe, dass das Framework zuerst startet und dass das Script zur Framework-Version passt, die du betreibst.
• Parse-Fehler an einem seltsamen Byte. Der Config-Thread zeigt unexpected symbol near '<\239>' in config.lua, danach global 'Config' als nil in server/main.lua. Der Thread liefert keine Erklärung. Meine Deutung, keine dokumentierte Ursache: \239 ist dezimal für 0xEF, das erste Byte eines UTF-8-Byte-Order-Marks, und der zweite Fehler wirkt wie eine Folge des ersten. Speichere die Datei neu als UTF-8 ohne BOM und teste erneut.
• Ein Syntaxfehler in einer Datei, die du nie bearbeitet hast. Verkäufer-Docs (Lation, JG Scripts) führen syntax error near <\1> für geschützte Dateien auf und verbinden ihn mit Lösungen zu beschädigten oder unvollständigen Übertragungen und veralteten Servern. Lade das originale Archiv erneut hoch, entpacke es auf dem Server und aktualisiere das Artifact.

Lösung: Gehe zu Datei und Zeile der ersten Meldung, vergleiche mit deinem Backup und mache deine letzte Änderung an Config- oder Item-Dateien rückgängig. Bearbeite keine geschützten Dateien.

6. Die Datenbank ist nicht verbunden

Ich konnte keine einheitliche oxmysql-Fehlermeldung belegen. Suche daher nach dem ersten Datenbankfehler, den oxmysql oder das Script ausgibt. Die oxmysql-Doku sagt, du sollst mysql_connection_string vor dem Start der Resources mit set setzen („only ever use set“), oxmysql weit oben starten und ; , / ? : @ & = + $ # in den Verbindungswerten vermeiden, weil sie möglicherweise nicht unterstützt werden. Die Troubleshooting-Seite von ESX nennt „ESX Multicharacter couldn't connect to the database“ und führt es auf einen falschen Connection String in der server.cfg oder eine nicht funktionierende Datenbankverbindung zurück.

Prüfen: Der Datenbankserver läuft, die Zugangsdaten funktionieren in einem Datenbanktool, und die Tabellen, die das Script braucht, existieren. Details: SQL-Dateien und Datenbankfehler und mysql-async-Resources sicher auf oxmysql migrieren.

7. Asset Escrow und der Server-Key

Laut der Asset-Escrow-Doku startet eine Resource ohne Berechtigung nicht, und die Konsole zeigt You lack the required entitlement. Verkäufer-Docs ergänzen, dass die Resource an den Cfx.re-Account gebunden ist, dem sie gehört, der Registrierungs-Key des Servers also von diesem Account stammen muss, und dass nach der Erstinstallation ein vollständiger Neustart nötig sein kann. Eine weitere von Verkäufern dokumentierte Meldung ist [svadhesive] Failed to verify protected resource ..., die die Verkäufer mit unvollständigen Neustarts, beschädigten Uploads oder einer fehlenden .fxap-Datei in Verbindung bringen. Schritte: So behebst du den FiveM-Fehler „Required Entitlement“ und Was ist eine .fxap-Datei in einer FiveM-Resource?

8. Legacy und Enhanced passen nicht zusammen

Ich habe keine dokumentierte Fehlermeldung gefunden, die speziell für eine Edition-Unstimmigkeit gilt. Der Cfx.re-Vergleich dokumentiert Unterschiede, die dazu führen können, dass eine Resource nicht funktioniert: Einige Enhanced-Serverdateien heißen anders (zum Beispiel cfx-server.exe statt FXServer.exe), Resources können stream_enhanced neben stream mitliefern, und Asset Escrow ist für Enhanced als noch nicht implementiert aufgeführt. Wenn du Enhanced betreibst, prüfe, ob der Ersteller genau diesen Release unterstützt; siehe FiveM Standard vs. Enhanced: Welche Version solltest du nutzen?

Das schickst du an den Support

Die erste Fehlerzeile, Name und Version der Resource, Framework und Version, Artifact-Nummer, Edition und die relevanten server.cfg-Zeilen ohne Keys und Passwörter. Siehe Startfehler und was der Support braucht.

FAQ

Was bedeutet „Couldn't start resource“ in FiveM?

Das ist die Meldung des Servers, dass die Resource nicht gestartet ist. Der Grund steht in den Zeilen davor, zum Beispiel in einer Manifest-Warnung. Lies den ersten Fehler, der die Resource nennt.

Was verursacht „No such export“?

Die Resource, die den Export bereitstellt, ist nicht gestartet, startete nach dem Aufrufer oder hat diesen Export nicht. Die ox_inventory-Doku nennt diese drei Ursachen.

Was bedeutet „Failed to load script“?

Eine Datei konnte nicht geladen werden. Die Fehlerzeilen darum herum nennen das eigentliche Problem, etwa einen Syntaxfehler oder ein nil-Framework-Objekt. Behebe diesen Fehler, nicht die allgemeine Zeile.

Spielt die Reihenfolge der ensure-Zeilen eine Rolle?

Ja, wenn Resources voneinander abhängen: Starte eine Resource nach ihrem Framework, ihren Bibliotheken und jeder Resource, deren Exports sie aufruft (die ox_inventory-Doku listet deshalb eine Startreihenfolge auf).