FiveM Ressourcen installieren: Ordnerstruktur, fxmanifest, ensure, Abhängigkeiten, SQL und Escrow

Ressource entpacken, richtig benennen, per ensure starten, SQL importieren: So installierst du FiveM-Skripte sauber und liest die typischen Fehler in der Konsole.

Um FiveM Ressourcen zu installieren, entpackst du den Ordner in resources/, prüfst, dass direkt darin eine fxmanifest.lua liegt, und trägst die Ressource mit ensure name in deine server.cfg ein. Bringt das Skript eine SQL-Datei mit, importierst du sie vorher in die Datenbank, und Abhängigkeiten wie oxmysql oder ox_lib müssen in der Startreihenfolge davor stehen. Klingt simpel, und meistens scheitert es genau an einem dieser drei Punkte.

Dieser Beitrag setzt voraus, dass dein Server schon läuft. Falls nicht, hilft dir zuerst die Anleitung FiveM Server erstellen mit txAdmin, server.cfg und Ports. Hier geht es um alles, was danach kommt: Skripte hinzufügen, ohne dass beim nächsten Start die Konsole rot wird.

Was eine FiveM-Ressource ausmacht

Eine Ressource ist für FiveM schlicht ein Ordner mit einer fxmanifest.lua. Der Ordnername ist gleichzeitig der Name der Ressource. Genau dieser Name steht später in der server.cfg und wird von anderen Skripten für Exports verwendet. Ältere Ressourcen nutzen noch __resource.lua, das ist veraltet, läuft aber teilweise noch.

Ein typisches Manifest sieht so aus:

fx_version 'cerulean'
game 'gta5'
lua54 'yes'

name 'mein_job'
version '1.0.0'

shared_scripts {
    '@ox_lib/init.lua',
    'config.lua'
}

client_scripts {
    'client/*.lua'
}

server_scripts {
    '@oxmysql/lib/MySQL.lua',
    'server/*.lua'
}

dependencies {
    'oxmysql',
    'ox_lib'
}

Du musst das Manifest nicht selbst schreiben, aber du solltest es vor der Installation kurz lesen. Die Zeilen mit @ox_lib und @oxmysql verraten dir sofort, welche anderen Ressourcen vorhanden und unter genau diesem Namen gestartet sein müssen. Bei RedM steht übrigens game 'rdr3' statt gta5, ein GTA-Skript läuft dort nicht einfach mit.

Ordnerstruktur: wohin die Ressource gehört

Alles liegt unterhalb von resources/ in deinem Server-Datenordner. Ordner in eckigen Klammern sind reine Kategorien: FiveM durchsucht sie, behandelt sie aber nicht als Ressource. So hältst du Ordnung, wenn es mehr als zwanzig Skripte werden.

server-data/
├── server.cfg
└── resources/
    ├── [core]/
    │   ├── oxmysql/
    │   └── ox_lib/
    ├── [framework]/
    │   └── es_extended/
    └── [jobs]/
        └── mein_job/
            ├── fxmanifest.lua
            ├── config.lua
            ├── client/
            └── server/

Zwei Fallen begegnen dir fast bei jedem Download:

  • Doppelte Verschachtelung: Nach dem Entpacken liegt oft mein_job/mein_job/fxmanifest.lua vor. FiveM findet dann keine Ressource. Das Manifest muss direkt im Ressourcenordner liegen.
  • Falscher Ordnername: GitHub-ZIPs heißen gern ox_lib-main oder mein_job-1.2.0. Benenne den Ordner auf den Namen um, den das Skript erwartet. Bei ox_lib ist das zwingend ox_lib, sonst finden andere Skripte @ox_lib/init.lua nicht.

Bei ox_lib und ähnlichen Ressourcen mit Weboberfläche gilt außerdem: Lade die fertige Datei unter Releases herunter, nicht den Quellcode-Button. Im Quellcode fehlt die gebaute Oberfläche.

FiveM Ressourcen installieren: Schritt für Schritt

  1. Erstelle ein Backup deiner Datenbank und des resources-Ordners. Ein falscher SQL-Import ist schneller passiert als rückgängig gemacht.
  2. Lies die README der Ressource. Dort steht, für welches Framework sie gedacht ist (ESX, QBCore, Qbox oder standalone) und welche Abhängigkeiten sie braucht.
  3. Entpacke die Ressource lokal, prüfe Ordnername und Lage der fxmanifest.lua.
  4. Lade den Ordner per SFTP oder Dateimanager in eine passende Kategorie hoch. Wie das bei einem gemieteten Gameserver geht, steht in der Hilfe zu Mods, Plugins und Dateien auf dem Game-Server.
  5. Importiere mitgelieferte SQL-Dateien in deine Datenbank (siehe unten).
  6. Passe die config.lua an, etwa Sprache, Koordinaten oder Jobnamen.
  7. Trage ensure mein_job in die server.cfg ein, unterhalb aller Abhängigkeiten.
  8. Starte den Server neu oder lade die Ressource per Konsole nach und lies die Ausgabe von oben nach unten.

Reihenfolge in der server.cfg und Abhängigkeiten

ensure startet eine Ressource, und wenn sie schon läuft, startet es sie neu. Deshalb hat ensure das ältere start weitgehend abgelöst. Entscheidend ist die Reihenfolge, denn die server.cfg wird von oben nach unten abgearbeitet.

Die Faustregel lautet: Datenbank, dann Bibliotheken, dann Framework, dann alles, was darauf aufbaut. Ein Job-Skript, das vor dem Framework startet, findet dessen Exports nicht und bricht ab.

set mysql_connection_string "mysql://fivem:geheim@127.0.0.1/fivem?charset=utf8mb4"

ensure oxmysql
ensure ox_lib

# Framework, je nach Setup es_extended, qb-core oder qbx_core
ensure es_extended

# Skripte, die auf dem Framework aufbauen
ensure ox_inventory
ensure mein_job
ensure [jobs]

Mit ensure [jobs] startest du eine ganze Kategorie auf einmal. Das ist bequem, aber du gibst die Kontrolle über die Reihenfolge innerhalb des Ordners ab. Für Skripte ohne Abhängigkeiten untereinander passt das, für alles mit Exports zwischen den Ressourcen solltest du einzeln eintragen.

Der Block dependencies im Manifest ist eine zusätzliche Absicherung: Fehlt eine dort genannte Ressource, verweigert FiveM den Start und sagt dir, was fehlt. Viele Skripte nutzen ihn aber nicht, verlass dich also nicht darauf. Achte auch darauf, dass ESX-Skripte nicht ohne Weiteres auf QBCore laufen und umgekehrt. Wenn du noch nicht festgelegt bist, hilft dir der Vergleich ESX vs QBCore mit Qbox und Datenbank.

SQL-Dateien in die Datenbank importieren

Viele Ressourcen speichern Daten in eigenen Tabellen oder ergänzen bestehende, etwa die users- oder players-Tabelle. Die nötigen Befehle liegen als .sql-Datei bei. Öffne sie vor dem Import und schau, was drinsteht: CREATE TABLE legt Neues an, ALTER TABLE verändert Bestehendes, INSERT fügt etwa Items oder Jobs hinzu.

Auf der Kommandozeile sieht der Import so aus:

# Sicherung vorher
mysqldump -u fivem -p fivem > backup_vor_mein_job.sql

# Import
mysql -u fivem -p fivem < "resources/[jobs]/mein_job/install.sql"

Die Anführungszeichen um den Pfad sind wichtig, weil die Shell eckige Klammern sonst als Muster interpretieren kann. Grafisch geht das genauso mit HeidiSQL oder phpMyAdmin: Datenbank auswählen, Datei öffnen, ausführen.

Drei Hinweise aus der Praxis:

  • Bricht der Import mit einer Meldung wie Duplicate column oder Table already exists ab, war das Skript schon einmal installiert. Dann nicht blind erneut importieren, sondern prüfen, welche Teile fehlen.
  • Item-Einträge sind framework-spezifisch. Bei ox_inventory werden Items oft nicht per SQL, sondern in einer Lua-Datei des Inventars eingetragen. Die README sagt dir, was gilt.
  • Bei Updates einer Ressource liegt manchmal eine eigene Update-SQL bei. Die ist für bestehende Installationen gedacht, die Install-SQL nur für neue.

Escrow-Ressourcen: was bei gekauften Skripten anders ist

Kostenpflichtige Skripte werden häufig über das Asset Escrow von Cfx.re ausgeliefert. Erkennbar ist das an einer .fxap-Datei im Ordner und an Lua-Dateien, die verschlüsselt und unlesbar sind. Meist bleiben Konfigurationsdateien offen, damit du sie anpassen kannst.

Damit eine Escrow-Ressource startet, muss der Lizenzschlüssel deines Servers zum selben Cfx.re-Konto gehören, über das das Skript gekauft wurde. Passt das nicht, erscheint sinngemäß die Meldung, dass dir das nötige Entitlement fehlt. Die Lösung liegt dann im Konto, nicht im Skript: Schlüssel prüfen oder das Asset auf das richtige Konto übertragen lassen.

Außerdem gilt: Escrow-Ressourcen brauchen eine aktuelle Server-Version, sehr alte Artefakte lehnen sie ab. Benenne den Ordner nicht um, wenn der Händler das nicht ausdrücklich erlaubt, und lade nach einem Kauf immer die Version aus deinem Konto herunter, nicht eine weitergegebene Kopie.

Fehler in der Konsole richtig lesen

Die wichtigste Regel zuerst: Lies den ersten Fehler nach dem Start, nicht den letzten. Folgefehler entstehen fast immer, weil weiter oben etwas nicht geladen wurde. Scroll in der Konsole oder in txAdmin also nach oben.

  • Couldn't find resource mein_job. Der Name in der server.cfg stimmt nicht mit dem Ordnernamen überein, das Manifest liegt eine Ebene zu tief oder du hast nach dem Hochladen kein refresh ausgeführt.
  • Could not find dependency ox_lib for resource mein_job. Die Abhängigkeit fehlt oder heißt anders, zum Beispiel ox_lib-main.
  • No such export ... in resource ... Die aufgerufene Ressource ist noch nicht gestartet, heißt anders oder ist in einer Version, die diesen Export nicht kennt. Häufigste Ursache ist die Reihenfolge.
  • SCRIPT ERROR: @mein_job/server/main.lua:42: attempt to index a nil value Datei und Zeile stehen direkt in der Meldung. Oft ist ein Framework-Objekt leer, weil das Skript für ein anderes Framework geschrieben wurde oder ein Config-Wert fehlt.
  • Table 'fivem.xyz' doesn't exist oder Unknown column kommen von oxmysql und bedeuten: SQL nicht oder in einer alten Version importiert.
  • Access denied for user heißt, der mysql_connection_string stimmt nicht.

Fehler im clientseitigen Code erscheinen nicht in der Serverkonsole, sondern im Spiel in der F8-Konsole. Wenn ein Menü nicht aufgeht, die Serverkonsole aber sauber ist, lohnt sich dort der Blick.

Ressourcen testen, ohne den ganzen Server neu zu starten

Für eine einzelne neue Ressource musst du nicht jedes Mal alles neu starten. In der Serverkonsole oder der txAdmin-Konsole reicht:

refresh
ensure mein_job

refresh liest den Ressourcenordner und die Manifeste neu ein, danach startet ensure die Ressource. Bei Änderungen an der config reicht oft restart mein_job. Bei Framework, Inventar oder oxmysql solltest du dagegen den ganzen Server neu starten, weil abhängige Skripte sonst mit veralteten Daten weiterlaufen. Teste neue Skripte am besten auf einem zweiten Testserver mit Kopie der Datenbank, bevor sie auf den Live-Server kommen.

Wo die Ressourcen laufen

Die Schritte oben funktionieren auf einem selbst verwalteten Linux-Server genauso wie auf einem gehosteten Gameserver, entscheidend sind Zugriff auf Dateien, Konsole und Datenbank. Wer sich die Grundinstallation sparen will, kann bei Hostleaf einen FiveM Server mieten. Im Panel stehen dort Konsole und Dateimanager bereit, die Server laufen in Rechenzentren in Deutschland und den Niederlanden mit standardmäßig aktivem DDoS-Schutz.

FAQ

Wo finde ich den resources-Ordner meines FiveM-Servers?

Er liegt im Server-Datenordner, also dort, wo auch die server.cfg liegt. Bei txAdmin-Installationen ist das meist ein eigener Ordner pro Server-Profil, getrennt von den Server-Artefakten.

Muss ich den Server nach jeder neuen Ressource neu starten?

Nein. Mit refresh und anschließend ensure name lädst du eine neue Ressource im laufenden Betrieb. Nur bei Kernressourcen wie Framework, Inventar oder oxmysql ist ein kompletter Neustart der sichere Weg.

Was ist der Unterschied zwischen ensure und start?

start startet eine Ressource nur, wenn sie noch nicht läuft. ensure startet sie oder startet sie neu, falls sie schon aktiv ist. In der server.cfg ist ensure heute der übliche Befehl.

Warum startet ein gekauftes Skript nicht, obwohl alles richtig liegt?

Bei Escrow-Ressourcen liegt das meist am Lizenzschlüssel: Er muss zum Cfx.re-Konto gehören, mit dem das Skript gekauft wurde. Prüfe außerdem, ob deine Server-Version aktuell ist und der Ordnername unverändert ist.

Weitere Beiträge