Konnte Ressource nicht starten: Warum FiveM dein Skript nicht startet

Du führst ensure my_script aus oder startest den Server, und die Konsole zeigt:

Couldn't start resource my_script.

Diese Zeile sagt dir nur das Ergebnis. Die Ursache steht in den Zeilen über ihr. Dieser Leitfaden listet die üblichen Ursachen auf, in der Reihenfolge, wie es sich lohnt zu überprüfen, und zeigt wie man die Konsole liest, um zu wissen, welche man hat.

#Lese zuerst die Zeilen darüber

Scrolle auf in der Serverkonsole oder in der txAdmin Live-Konsole von Couldn't start resource. Die Zeile direkt darüber ist fast immer der Grund: eine fehlende Abhängigkeit, ein Parse-Fehler mit einer Datei und Zeilennummer oder ein Manifest-Problem.

Falls die Konsole zu laut ist, stoppe den Server, starte ihn neu und führe nur die fehlerhafte Ressource aus:

ensure my_script

Jetzt gehört alles, was direkt nach diesem Befehl gedruckt wird, zur Ressource.

#1. Die Ressource wird nicht gefunden

Couldn't find resource my_script.

FiveM sucht nach einem Ordner namens genau my_script irgendwo unter resources, und dieser Ordner muss eine Datei namens fxmanifest.lua (oder das alte __resource.lua) enthalten. Überprüfe drei Dinge:

• Der Name in server.cfg stimmt mit dem Ordnernamen überein, Buchstabe für Buchstabe. Auf einem Linux-Host sind My_Script und my_script unterschiedlich.
• Die Manifest-Datei heißt fxmanifest.lua, nicht fxmanifest.lua.txt (Windows verbergt bekannte Erweiterungen) und nicht fxmanifest (1).lua.
• Führe refresh in der Serverkonsole aus, nachdem du einen neuen Ordner hinzugefügt hast, dann ensure erneut. Ein laufender Server scannt nicht nach neuen Ordnern, bis du das tust.

#2. Verschachtelter Ordner nach dem Entpacken

Dies ist der häufigste Fehler bei heruntergeladenen Skripten. Du entpackst my_script.zip und landest bei:

resources/
  my_script/
    my_script/
      fxmanifest.lua
      client/
      server/

Das Manifest ist eine Ebene zu tief, daher sieht FiveM my_script als einen einfachen Ordner ohne Manifest. Verschiebe den inneren Ordner nach oben, so dass fxmanifest.lua direkt im Ordner sitzt, den du sicherst.

Kategorie-Ordner, die in Klammern geschrieben sind, wie [mic], sind in Ordnung: FiveM schaut durch sie. Eine Ressource in einer anderen Ressource ist nicht.

#3. Ein Lua-Syntaxfehler beim Laden

Error parsing script @my_script/server/main.lua in resource my_script: @my_script/server/main.lua:42: unexpected symbol near 'end'
Couldn't start resource my_script.

Die Meldung nennt die Datei und die Zeile (main.lua:42). Öffne diese Zeile und schau dir auch die davor an: ein fehlendes end, ein fehlendes Komma in einer Tabelle oder ein abweichender Charakter aus einem schlechten Copy und Paste. Behebe es, dann ensure erneut.

Zwei Ursachen, die wie Syntaxfehler aussehen, es aber nicht sind:

• Das Skript verwendet Lua 5.4-Syntax (<const>, <close>, ganzzahlige Division) und dem Manifest fehlt lua54 'yes'.
• Die Datei wurde mit einer anderen Kodierung gespeichert oder hat eine BOM. Speichere sie als UTF-8 ohne BOM.

#4. Fehlende Abhängigkeit

Could not find dependency ox_lib for resource my_script.
Couldn't start resource my_script.

Das Manifest verlangt eine andere Ressource, die nicht auf deinem Server ist. Installiere sie und halte den Ordnernamen genau. Die vollständige Erklärung ist in Konnte Abhängigkeit X für Ressource Y nicht finden.

#5. Manifest-Fehler

Ein schlechtes fxmanifest.lua stoppt die Ressource, bevor ein Skript läuft. Überprüfe:

fx_version 'cerulean'
game 'gta5'

client_scripts { 'client/*.lua' }
server_scripts { 'server/*.lua' }

Häufige Fehler: ein fehlendes fx_version oder game, ein fehlendes Komma zwischen Einträgen in einer { }-Liste, ein Dateipfad im Manifest, der nicht existiert und ein Pfad mit falscher Schrägstrich-Richtung oder Großschreibung. Verwende Schrägstriche. Falls die Ressource immer noch ein __resource.lua versendet, siehe Konvertiere __resource.lua zu fxmanifest.lua.

#6. Escrow, Berechtigung und Lizenz

Geschützte (verwahrte) Skripte überprüfen, dass der Lizenzschlüssel deines Servers dem Cfx.re-Konto gehört, das das Asset besitzt. Falls nicht, weigert sich die Ressource zu starten und die Zeile darüber sagt, dass dir die Berechtigung fehlt. Das ist eine separate Behebung: Escrow: Du brauchst die erforderliche Berechtigung.

#7. Die Ressource startet, schlägt dann auf andere Weise fehl

Manchmal ist der Start erfolgreich und der Fehler kommt eine Sekunde später aus einem SCRIPT ERROR in einer Skript-Datei, wie ein nil-Wert aus dem Framework. Das ist kein Start-Problem mehr. Lese die Fehler-Zeile, finde die Datei und Zeilennummer und behebe es. Falls das Framework-Objekt nil ist, beginne mit dem ESX oder QBCore Leitfaden.

#Ein schneller Weg, das Manifest zu testen

Beginne mit einer sauberen Test-Ressource. Erstelle resources/test_ok/fxmanifest.lua:

fx_version 'cerulean'
game 'gta5'

server_script 'server.lua'

und resources/test_ok/server.lua:

print('test_ok started')

Führe refresh dann ensure test_ok aus. Falls das funktioniert, sind dein Server und Pfade in Ordnung, und der Fehler ist innerhalb der Ressource, die du verfolgst.

#Checkliste