FiveM Server Scripts installieren – ESX und QBCore

FiveM Scripts installierst du, indem du die Ressource in den resources/ Ordner legst, sie in der server.cfg mit ensure startest und Abhängigkeiten wie ESX, QBCore oder Datenbanktreiber vorher lädst. Entscheidend sind eine saubere Ordnerstruktur, die richtige Startreihenfolge, ein geprüfter SQL-Import und ein Blick in die Serverkonsole nach dem Neustart.

Voraussetzungen

Du brauchst Zugriff auf die Serverdateien, die server.cfg, die Serverkonsole und, falls das Script Datenbanktabellen nutzt, auf deine MySQL- oder MariaDB-Datenbank. Bei einem gemieteten FiveM Server gehört dazu in der Regel ein Dateimanager, FTP/SFTP und ein Datenbanktool wie phpMyAdmin oder Adminer. Wenn du den kompletten Server noch planst, hilft der interne Guide FiveM Server mieten und einrichten bei der Grundstruktur.

FiveM nennt Scripts technisch Ressourcen. Laut offizieller Cfx.re-Dokumentation beschreibt die fxmanifest.lua, welche Dateien, Scripts und Metadaten zu einer Ressource gehören. Prüfe deshalb immer zuerst, ob der entpackte Ordner eine gültige Manifest-Datei enthält. Ohne Manifest kann der Server die Ressource nicht korrekt laden.

Script-Struktur prüfen

Eine typische FiveM Ressource sieht so aus:

mein_script/
├── fxmanifest.lua      # Manifest-Datei
├── client.lua          # Client-Code
├── server.lua          # Server-Code
├── config.lua          # Konfiguration
└── html/               # NUI (Web-Interface)

Wichtig ist, dass du nicht versehentlich einen zusätzlichen Verpackungsordner hochlädst. Falsch wäre zum Beispiel resources/mein_script-main/mein_script/fxmanifest.lua, wenn die Ressource eigentlich direkt unter resources/mein_script/fxmanifest.lua liegen soll. Öffne nach dem Entpacken den Ordner und kontrolliere die Ebene, auf der fxmanifest.lua liegt.

Script installieren

1. Script herunterladen
2. In den resources/ Ordner entpacken
3. In server.cfg hinzufügen:

ensure mein_script

4. Server neustarten

Nutze als Ressourcenname exakt den Ordnernamen oder den Namen, den die README vorgibt. Viele Fehler entstehen durch abweichende Schreibweisen, Leerzeichen im Ordnernamen oder Sonderzeichen. Empfehlenswert sind kurze Namen mit Kleinbuchstaben, Bindestrichen oder Unterstrichen.

ESX Scripts einrichten

ESX Scripts hängen davon ab, dass die ESX-Basis und benötigte Zusatzressourcen vorher gestartet werden. Die konkrete Reihenfolge kann je nach ESX-Version und Script variieren, deshalb gilt: README des Scripts prüfen und vorhandene Framework-Dokumentation beachten.

# Basis ESX
ensure es_extended
ensure esx_menu_default
ensure esx_menu_dialog
ensure esx_menu_list

# Jobs
ensure esx_policejob
ensure esx_ambulancejob
ensure esx_mechanicjob
ensure esx_taxijob

# Features
ensure esx_banking
ensure esx_vehicleshop
ensure esx_property

Wenn ein Job-Script eigene Datenbanktabellen oder Items erwartet, importiere die mitgelieferte SQL-Datei vor dem ersten produktiven Start. Sichere vorher die Datenbank. Bei bestehenden Roleplay-Servern können SQL-Dateien Spalten, Items oder Jobs überschreiben, wenn sie nicht auf deine Installation abgestimmt sind.

QBCore Scripts einrichten

QBCore-Ressourcen benötigen ihre Abhängigkeiten vor dem Framework beziehungsweise vor dem jeweiligen Script. Das folgende Beispiel setzt voraus, dass diese Versionen oxmysql nutzen; zusätzliche README-Abhängigkeiten ergänzt du an der passenden Stelle:

ensure oxmysql
ensure qb-core
ensure qb-inventory
ensure qb-garages
ensure qb-policejob
ensure qb-ambulancejob
ensure qb-phone

Prüfe besonders Konfigurationsdateien wie config.lua, shared/config.lua oder Framework-spezifische Item-Dateien. Manche QBCore Scripts erwarten Einträge in Items, Jobs, Gangs oder Permissions. Trage nur Werte ein, die das Script dokumentiert. Wenn du Ressourcen, txAdmin und Serverbetrieb im größeren Zusammenhang planen willst, lies auch FiveM Server mieten: GTA RP einrichten, Ressourcen & txAdmin 2025.

Startreihenfolge beachten

Die Startreihenfolge folgt den tatsächlich dokumentierten Abhängigkeiten:

1. Datenbanktreiber und gemeinsame Bibliotheken, etwa oxmysql, sofern verlangt
2. Framework wie ESX oder QBCore
3. Basis-Ressourcen, etwa Inventar oder Garagen
4. Jobs und weitere Funktionen, die diese Basis verwenden
5. Kosmetische Ressourcen, soweit ihre eigenen Abhängigkeiten bereits laufen

Ein dependency-Eintrag im Manifest beschreibt eine Voraussetzung. Der Cfx.re-Manifest-Referenz zufolge muss die betreffende Ressource vor der abhängigen Ressource laden. Die README der installierten Version entscheidet über die genaue Reihenfolge.

Setze gemeinsam genutzte Dependencies möglichst zentral und vor allen abhängigen Ressourcen. Wenn mehrere Scripts dieselbe Bibliothek verlangen, sollte sie nur einmal gestartet werden. Bei Datenbankanbindung muss der Datenbanktreiber laufen, bevor Ressourcen SQL-Abfragen senden.

Kostenlose Script-Quellen

Lade Scripts nur aus Quellen, die Code, Changelog oder Community-Rückmeldungen nachvollziehbar machen. Bei unbekannten Downloads solltest du besonders auf verschleierten Lua-Code, unerklärliche HTTP-Requests, fremde Webhooks und hart codierte Tokens achten. Installiere neue Ressourcen zuerst auf einer Testinstanz oder außerhalb der Haupt-Spielzeiten.

Ergebnis prüfen

Starte den Server neu und beobachte die Konsole. Eine korrekt geladene Ressource erscheint ohne Manifest-, Dependency- oder SQL-Fehler. Im Spiel prüfst du anschließend genau die Funktion, die das Script bereitstellt: Job-Menü, Inventar-Interaktion, Marker, Command, NUI-Fenster oder Datenbankänderung. Teste mit den Rollen und Rechten, die echte Spieler später verwenden.

Nutze zusätzlich refresh und ensure mein_script in der Serverkonsole nur für kontrollierte Tests. Für produktive Änderungen ist ein sauberer Neustart oft aussagekräftiger, weil er die vollständige Startreihenfolge abbildet.

Troubleshooting

SCRIPT ERROR

Prüfe zuerst die Zeile in der Konsole. Häufig fehlt eine Dependency, eine Config-Variable ist falsch gesetzt oder eine exportierte Funktion wird vor dem Start der Zielressource aufgerufen. Vergleiche die Fehlermeldung mit der README des Scripts.

SQL-Fehler

Importiere die mitgelieferten Tabellen oder Spalten, falls das Script sie verlangt. Wenn Tabellen bereits existieren, führe SQL nicht blind erneut aus. Erstelle ein Backup und passe die Statements an deine bestehende Datenbankstruktur an.

Script lädt nicht

Kontrolliere Ordnername, ensure-Eintrag und fxmanifest.lua. Ein Tippfehler in der Manifest-Datei oder ein falsch verschachtelter Ordner reicht aus, damit die Ressource nicht startet.

Funktion erscheint nicht im Spiel

Prüfe Rechte, Jobs, Items, Koordinaten und Framework-Version. Viele Roleplay-Scripts funktionieren nur für bestimmte Jobs oder Gruppen. Teste deshalb nicht nur als Admin, sondern auch mit einem normalen Spielerprofil.

FAQ

Muss ich den Server nach jedem Script neu starten?

Für einen zuverlässigen Test ja. Einzelne Ressourcen lassen sich zwar per Konsole neu laden, aber ein kompletter Neustart zeigt, ob die Startreihenfolge und alle Dependencies wirklich stimmen.

Kann ich ESX und QBCore gleichzeitig nutzen?

In der Praxis solltest du dich für ein Framework entscheiden. Viele Scripts sind klar für ESX oder QBCore gebaut und erwarten jeweils andere Events, Tabellen und Config-Strukturen.

Was mache ich, wenn ein Script keine fxmanifest.lua hat?

Prüfe zusätzlich, ob ein älteres __resource.lua-Manifest vorhanden ist. Cfx.re dokumentiert dieses Format weiterhin als veraltet; das Fehlen von fxmanifest.lua allein beweist deshalb keinen kaputten Download. Verwende für neue Ressourcen das aktuelle Format und migriere Altbestände nach der Manifest-Referenz. Benenne die alte Datei nicht bloß um, ohne ihre Syntax und Inhalte zu prüfen.

Sollte ich kostenlose Scripts direkt auf dem Live-Server testen?

Besser nicht. Teste neue Ressourcen zuerst separat, sichere Dateien und Datenbank und prüfe die Konsole. Gerade bei Roleplay-Servern können fehlerhafte Scripts Inventar, Jobs oder Spielerfortschritt beeinflussen.

Wie viele Scripts kann ein FiveM Server verwenden?

Es gibt keine sinnvolle pauschale Zahl. Entscheidend sind Script-Qualität, Abhängigkeiten, Datenbanklast, Tick-Verhalten und Spielerzahl. Plane Ressourcen bewusst und entferne ungenutzte Scripts konsequent.