FiveM-Script (Resource) installieren: Schritt für Schritt

Um ein FiveM-Script zu installieren, kopierst du seinen Resource-Ordner (den, in dem die fxmanifest.lua liegt) in das Verzeichnis resources deines Servers, startest zuerst seine Abhängigkeiten, konfigurierst es, ergänzt hinter diesen eine ensure-Zeile in der server.cfg und liest die Konsole. Vorher ein Backup machen.

Geprüft anhand der verlinkten Dokumentation von Cfx.re und der Frameworks am 2026-10-13. Das ist ein Dokumentationsabgleich, kein Praxistest: RPScripts hat diese Schritte nicht in einer isolierten Testumgebung ausgeführt. Die Schritte gehen von GTA V Legacy aus; Enhanced wird nur in Schritt 1 erwähnt. Alles, was in monospace steht, etwa resource_name, ist ein Platzhalter für deinen eigenen Wert.

Schritt 1: Edition, Framework und Abhängigkeiten prüfen

Lies die Produktseite oder die Readme und notiere dir: das Framework (ESX, QBCore, Qbox oder Standalone), die benötigten Bibliotheken, die Inventar- und Target-Resources sowie die unterstützte GTA-V-Edition. Ein Framework-Badge verrät dir die Edition nicht.

Die Cfx.re-Seite zu Legacy/Enhanced beschreibt einen Enhanced-Server mit anders benannten Serverdateien und einen Ordner stream_enhanced für Assets, die sich von stream unterscheiden. Außerdem führt sie Asset Escrow für Enhanced als “Not implemented yet” auf. Frag den Ersteller nach dem genauen Release, wenn du Enhanced nutzt. Hintergrund: FiveM Standard vs. Enhanced: Welche Version solltest du nutzen?.

Erfolgskontrolle: Du kannst Framework, Edition und Abhängigkeiten aus dem Text des Erstellers selbst aufzählen. Wenn nicht: Stopp, frag den Verkäufer, bevor du installierst.

Schritt 2: Backup anlegen, damit du zurückrollen kannst

Kopiere die server.cfg, die Resource-Ordner, die du ändern wirst, und alle gemeinsam genutzten Item- oder Job-Dateien, und exportiere die Datenbank. Probiere die Installation zuerst auf einem Testserver mit Testdatenbank aus. Siehe FiveM-Server sichern und wiederherstellen.

Erfolgskontrolle: Du weißt, wo die Kopien liegen und welche Datei du als Erstes zurückspielen würdest.

Schritt 3: Entpacken und den Resource-Ordner finden

Entpacke das Archiv. Eine Resource ist ein Ordner, in dem die fxmanifest.lua direkt liegt; die Einführung in Resources von Cfx.re sagt: “Every resource is required to contain a resource manifest by the name of fxmanifest.lua”. Ein Download kann mehrere Resources enthalten, und eine Zip-Datei kann einen zusätzlichen Wrapper-Ordner mitbringen.

Erfolgskontrolle: Jeder Ordner, den du kopierst, hat die fxmanifest.lua auf oberster Ebene, nicht einen Ordner tiefer. Beleg, falls nicht: eine Ordneransicht, die zeigt, wo das Manifest liegt.

Lade den richtigen Build herunter. Zwei dokumentierte Beispiele sagen, dass du ein Release statt des Quellcode-Archivs des Repositorys nehmen sollst: Die QBCore-Dokumentation sagt, du sollst den Release-Build von oxmysql verwenden, und die ox_inventory-Dokumentation sagt, dass die UI gebündelt sein muss, und empfiehlt das vorgebündelte Release (ox_inventory.zip).

Schritt 4: In resources ablegen und den Ordnernamen beibehalten

Verschiebe jeden Resource-Ordner nach resources oder in einen Klammer-Ordner wie resources/[scripts]. Die Servercommands von Cfx.re akzeptieren Klammernamen als Kategorien, zum Beispiel start [cars].

Im Beispielbaum von Cfx.re heißt die Resource wie ihr Ordner, also ist der Ordnername der Name, den du an ensure übergibst; Scripts, die von ihr abhängen, verweisen in der Regel unter diesem Namen darauf. Die Cfx.re-Seite sagt, du darfst Ordner nennen, wie du willst, aber ein gekauftes Script umzubenennen ist ein Risiko, von dem RPScripts abrät, außer der Ersteller sagt es ausdrücklich.

Erfolgskontrolle: Der Pfad lautet resources/[optional_group]/resource_name/fxmanifest.lua. Unter Linux ist die Groß- und Kleinschreibung relevant.

Schritt 5: Das Manifest lesen

Öffne die fxmanifest.lua, ohne sie zu verändern. Die Manifest-Referenz führt fx_version und game auf (gta5 läuft auf FiveM, rdr3 auf RedM) und sagt zu dependency: “Requires the specified resource to load before the current resource.” Jede Datei, die in client_script, server_script, shared_script oder files genannt wird, sollte im Ordner existieren. Wenn du selbst eines schreiben willst, siehe Eine FiveM-fxmanifest.lua schreiben und prüfen und den fxmanifest-Generator.

Erfolgskontrolle: Du kannst jede Abhängigkeit benennen, und jede aufgeführte Datei existiert.

Schritt 6: Abhängigkeiten installieren und starten

Abhängigkeit	Warum sie wichtig ist	Quelle
oxmysql	Datenbankzugriff. Setze mysql_connection_string mit set, bevor irgendeine Resource startet, und starte oxmysql ganz oben in der Liste.	oxmysql-Dokumentation
ox_lib	Wird über shared_scripts { '@ox_lib/init.lua' } im Manifest einer Resource eingebunden, die Bibliothek muss also installiert sein.	ox_lib-Dokumentation
Framework	es_extended, qb-core oder qbx_core müssen laufen, bevor Scripts starten, die sie nutzen.	Siehe die Framework-Tabelle in Schritt 12
Inventar und Target	Müssen zu den Optionen in der Config des Scripts passen (zum Beispiel ox_inventory gegenüber qb-inventory).	Die Readme des Scripts

Jede Abhängigkeit selbst der Reihe nach in der server.cfg aufzulisten ist eine Vorsichtsmaßnahme von RPScripts, keine dokumentierte Vorgabe.

Erfolgskontrolle: Jede Abhängigkeit ist installiert und läuft bereits für sich allein.

Schritt 7: SQL sorgfältig importieren

Nur manche Scripts liefern eine .sql-Datei mit. Lies sie, bevor du sie ausführst: DROP TABLE, TRUNCATE, DELETE, REPLACE und ALTER TABLE können vorhandene Daten entfernen oder verändern, und CREATE TABLE IF NOT EXISTS prüft nicht, ob eine bestehende Tabelle die richtigen Spalten hat. Eine Datei für Neuinstallationen ist kein Update. Importiere in die Datenbank, die in deinem Connection-String steht, und zuerst in die Testdatenbank. Details und häufige Fehler: SQL-Dateien und Datenbankfehler.

Die Installationsseite von Qbox verlangt MariaDB 10.9.0 oder neuer, nicht MySQL. Gleiche deine eigene Datenbank-Engine vor dem Import mit der Anforderung des Frameworks ab.

Erfolgskontrolle: Der Import meldet keine Fehler, und die erwarteten Tabellen existieren. Beleg, falls er fehlschlägt: das fehlgeschlagene Statement und die genaue Fehlermeldung, ohne Passwörter.

Schritt 8: Konfigurieren

Bearbeite die config.lua (oder den Ordner config), sodass Framework-, Inventar-, Target- und Benachrichtigungsoptionen auf Resources zeigen, die du tatsächlich betreibst. Registriere alle Items, die das Script braucht, im Item-System deines Frameworks. Hinweise pro Framework stehen in der Tabelle in Schritt 12.

Erfolgskontrolle: Jeder Resource-Name in der Config existiert in deinem Ordner resources.

Schritt 9: Die ensure-Zeile in der richtigen Reihenfolge eintragen

# server.cfg (placeholders: use your own framework and resources)
set mysql_connection_string "..."   # your own value, keep it private
ensure oxmysql
ensure ox_lib
ensure your_framework
ensure your_inventory_and_target

ensure resource_name

Die oxmysql-Dokumentation sagt, du sollst start oxmysql “to the top of your resource list” setzen, und die ox_inventory-Seite zu Qbox sagt, du sollst es “immediately after qbx_core” starten, die Reihenfolge ist also wichtig. Dein Script kommt hinter alles, wovon es abhängt. Startreihenfolge pro Framework: QBCore, ESX, Qbox; allgemeine Referenz: FiveM server.cfg konfigurieren und Änderungen prüfen und der server.cfg-Generator. Kommentare in der server.cfg beginnen mit #, wie in der QBCore-Vorlage.

Erfolgskontrolle: Deine Zeile steht unter der Zeile jeder Abhängigkeit.

Schritt 10: Starten und das Ergebnis prüfen

Die Seite Servercommands von Cfx.re dokumentiert refresh, das resources neu einliest und Manifeste lädt, damit neue Resources gestartet werden können, und ensure, das eine Resource startet oder neu startet, falls sie läuft. Führe in der Serverkonsole refresh aus und dann ensure resource_name; ein Neustart des Servers lädt sie ebenfalls. Nach dem Hinzufügen von Items, Jobs oder SQL empfiehlt RPScripts vorsichtshalber einen vollständigen Neustart (redaktioneller Rat, keine Aussage von Cfx.re).

1. Keine Fehlerzeilen in der Serverkonsole erwähnen resource_name.
2. Verbinde dich mit einem Testaccount und drücke F8: keine Fehlerzeilen für die Resource.
3. Nutze die Funktion (Menü öffnen, Item benutzen, die Karte betreten).
4. Verbinde dich neu und starte einmal neu, um zu bestätigen, dass gespeicherte Daten erhalten bleiben.

Belege, die du sammeln solltest, wenn eine Kontrolle fehlschlägt: die erste Fehlerzeile nach dem Start (nicht die letzte), der Resource-Name, dein Framework mit Version, die FXServer-Artifact-Nummer, die Edition sowie der ensure-Block über und unter deiner Zeile. Wenn sie nicht startet, geht es weiter mit FiveM-Resource startet nicht: Fehler anhand der Konsolenmeldung beheben.

Schritt 11: Sauber zurückrollen

Führe stop resource_name aus, setze ein # vor die ensure-Zeile und stelle dann die Config-Dateien und die Datenbank aus dem Backup von Schritt 2 wieder her. Behalte den Datenbankexport aus Schritt 2, denn eine teilweise importierte SQL-Datei wird nicht rückgängig gemacht, indem du die Resource stoppst.

Schritt 12: Unterschiede zwischen den Frameworks

Framework	Core-Resource	Items und Daten	Quelle
ESX	es_extended	Items und Jobs liegen in Datenbanktabellen, außer du nutzt ox_inventory (siehe die ESX-Hinweise von RPScripts). Die Troubleshooting-Seite von ESX führt “Error ESX = nil” mit der Lösung “update your es_extended to the latest version” auf.	ESX-Dokumentation
QBCore	qb-core	Die Vorlage startet ensure qb-core, dann ensure [qb] und [standalone].	QBCore-Dokumentation
Qbox	qbx_core	Nutzt ox_inventory: Füge setr inventory:framework "qbx" ein, bevor Resources starten, und starte ox_inventory direkt nach qbx_core.	ox_inventory-Setup für Qbox
Standalone	keine	Braucht nur das, was seine Readme nennt.	Ersteller

Ein Script, das für ein Framework gemacht wurde, lässt sich nicht durch bloßes Kopieren auf einem anderen installieren; siehe FiveM-Scripts zwischen ESX, QBCore und Qbox konvertieren. RPScripts verkauft Scripts, dieser Kategorie-Link ist also kommerziell: QBCore-Scripts. Die Schritte hier gelten für eine Resource aus jeder Quelle.

Escrow-geschützte Resources

Resources, die durch Cfx.re Asset Escrow geschützt sind, enthalten meist eine .fxap-Datei; siehe Was ist eine .fxap-Datei in einer FiveM-Resource?. Bearbeite, verschmelze oder lösche die geschützten Dateien nicht. Laut den Cfx.re-Asset-Escrow-Docs kann ein Server ohne die passende Berechtigung die Resource nicht starten und gibt “You lack the required entitlement” in der Konsole aus; Lösungen findest du in So behebst du den FiveM-Fehler zur fehlenden Entitlement. Die Docs beschreiben eine escrow_ignore-Direktive, mit der ein Ersteller ausgewählte Dateien, etwa eine Config, ungeschützt lassen kann; bearbeite nur Dateien, die der Ersteller nennt. Dokumentationen von Verkäufern berichten, dass beschädigte Dateiübertragungen Escrow-Resources kaputt machen. JG Scripts sagt, du sollst die .zip unverändert hochladen und nach der Übertragung entpacken, statt Dateien einzeln zu übertragen, und dass FileZilla Dateien beschädigen kann (versuche WinSCP); Lation sagt, FileZilla beschädige Escrow-Dateien häufig, und empfiehlt WinSCP. Das ist eine Herstellerempfehlung, keine Aussage von Cfx.re.

FAQ

Muss ich den Server nach dem Hinzufügen eines Scripts neu starten?

Nicht immer. refresh und danach ensure resource_name lädt laut Cfx.re-Docs eine neue Resource. Nach dem Hinzufügen von Items, Jobs oder SQL-Änderungen ist ein vollständiger Neustart eine Vorsichtsmaßnahme von RPScripts.

Kann ich ein QBCore-Script auf ESX oder Qbox installieren?

Nicht allein durch Kopieren. Prüfe die Produktseite auf dein Framework; ein Script, das das Inventar oder die Core-Funktionen eines anderen Frameworks aufruft, braucht eine Konvertierung oder eine Bridge, die der Ersteller dokumentiert.