ESX vs QBCore: FiveM-Frameworks im Vergleich, mit Qbox, Datenbank, Performance und Umstieg
ESX Legacy, QBCore oder Qbox? Der Vergleich zeigt Unterschiede in Aufbau, Script-Angebot, Datenbank und Performance und hilft bei der Wahl für neue Server.
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.
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.
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:
mein_job/mein_job/fxmanifest.lua vor. FiveM findet dann keine Ressource. Das Manifest muss direkt im Ressourcenordner liegen.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.
resources-Ordners. Ein falscher SQL-Import ist schneller passiert als rückgängig gemacht.fxmanifest.lua.config.lua an, etwa Sprache, Koordinaten oder Jobnamen.ensure mein_job in die server.cfg ein, unterhalb aller 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.
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:
Duplicate column oder Table already exists ab, war das Skript schon einmal installiert. Dann nicht blind erneut importieren, sondern prüfen, welche Teile fehlen.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.
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.
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_jobrefresh 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.
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.
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.
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.
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.
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.
ESX Legacy, QBCore oder Qbox? Der Vergleich zeigt Unterschiede in Aufbau, Script-Angebot, Datenbank und Performance und hilft bei der Wahl für neue Server.
Vom Lizenzschlüssel bis zum ersten Connect: So erstellst du einen FiveM-Server auf Linux mit txAdmin, konfigurierst die server.cfg und vermeidest typische Startfehler.
RedM Server erstellen in klaren Schritten: Lizenzschlüssel, txAdmin, Datenbank, VORP oder RSG und die server.cfg-Zeilen, die sich von FiveM unterscheiden.