Ressourcen installieren und verwalten

In diesem Artikel erklären wir dir, wie du Ressourcen auf deinem FiveM Server installierst, aktivierst, aktualisierst und entfernst.

Ressourcen sind Erweiterungen für deinen FiveM Server. Sie können neue Funktionen, Fahrzeuge, Karten, Jobs, Menüs, Scripts, Frameworks oder Admin-Tools hinzufügen.

Was sind FiveM Ressourcen?

Eine Ressource ist ein Ordner mit Dateien, die vom FiveM Server geladen werden.

Typische Ressourcen sind zum Beispiel:

• Fahrzeuge

• Maps

• Scripts

• Jobs

• Admin-Menüs

• Framework-Erweiterungen

• Inventarsysteme

• Garagen

• Kleidung

• Waffen

• HUDs

• Datenbank-Scripts

Eine Ressource besteht meistens aus mehreren Dateien. Besonders wichtig ist die Datei fxmanifest.lua oder bei älteren Ressourcen __resource.lua.

Diese Datei beschreibt dem Server, was zur Ressource gehört und wie sie geladen werden soll.

Voraussetzungen

Bevor du eine Ressource installierst, benötigst du:

• Zugriff auf deinen FiveM Server im INSTANTPANEL

• Zugriff auf den Dateimanager oder SFTP

• die heruntergeladene Ressource

• einen entpackten Ressourcenordner

• Grundkenntnisse zur Datei server.cfg

Außerdem sollte dein Server gestoppt sein, bevor du Dateien hochlädst, entfernst oder größere Änderungen vornimmst.

Wichtig: Erstelle vor größeren Änderungen immer ein Backup. Fehlerhafte Ressourcen können dazu führen, dass dein Server nicht mehr startet oder bestimmte Funktionen nicht mehr korrekt arbeiten.

Geeignete Quellen verwenden

Lade Ressourcen nur aus vertrauenswürdigen Quellen herunter.

Achte besonders auf:

• bekannte Entwickler

• aktuelle Versionen

• Bewertungen oder Community-Rückmeldungen

• Dokumentation des Entwicklers

• passende FiveM-Version

• benötigte Abhängigkeiten

• Hinweise zur Installation

Vermeide unbekannte Downloads aus unsicheren Quellen. Fehlerhafte oder manipulierte Ressourcen können deinen Server beschädigen, Daten auslesen oder unerwünschte Funktionen ausführen.

Ressource herunterladen und entpacken

Viele Ressourcen werden als .zip- oder .rar-Archiv bereitgestellt.

Nach dem Download musst du das Archiv zuerst entpacken.

Der Ordner sollte danach direkt die Ressourcendateien enthalten.

Richtiges Beispiel:

Pfad	Bewertung
myresource/fxmanifest.lua	richtig
myresource/client.lua	richtig
myresource/server.lua	richtig

Falsches Beispiel:

Pfad	Problem
myresource-main/myresource/fxmanifest.lua	Ordner liegt eine Ebene zu tief
myresource.zip	Archiv wurde nicht entpackt
myresource/README.md ohne fxmanifest.lua	möglicherweise falscher Ordner

Wenn der Server die Ressource nicht erkennt, liegt häufig eine falsche Ordnerstruktur vor.

Ressourcenordner finden

FiveM Ressourcen liegen normalerweise im Ordner resources.

Je nach Serverpaket kann die Struktur etwas unterschiedlich aussehen.

Typische Pfade sind:

• resources

• server-data/resources

• resources/[local]

• resources/[standalone]

• resources/[esx]

• resources/[qb]

Ordner mit eckigen Klammern wie [local], [esx] oder [qb] dienen meistens nur zur besseren Sortierung. Sie helfen dabei, Ressourcen übersichtlicher zu gruppieren.

Ressource hochladen

Gehe so vor:

1. Stoppe deinen FiveM Server im INSTANTPANEL.

2. Öffne den Dateimanager oder verbinde dich per SFTP.

3. Öffne den Ordner resources.

4. Lade den entpackten Ressourcenordner hoch.

5. Prüfe, ob im Ressourcenordner eine fxmanifest.lua oder __resource.lua liegt.

6. Öffne danach die Datei server.cfg.

7. Trage die Ressource dort ein.

8. Starte den Server neu.

9. Prüfe die Konsole auf Fehler.

Ressource in der server.cfg aktivieren

Damit FiveM eine Ressource lädt, muss sie in der server.cfg gestartet werden.

Dafür wird meistens ensure verwendet.

Beispiel: ensure myresource

Der Name muss exakt dem Ordnernamen der Ressource entsprechen.

Wenn dein Ordner also myresource heißt, muss der Eintrag so aussehen:

ensure myresource

Wenn der Ordner carpack heißt, lautet der Eintrag:

ensure carpack

Wichtig: Achte auf Groß- und Kleinschreibung, Leerzeichen und Sonderzeichen. Der Eintrag in der server.cfg muss zum Ordnernamen passen.

Unterschied zwischen ensure und start

Bei FiveM werden häufig die Befehle ensure und start verwendet.

Befehl	Bedeutung
ensure ressourcenname	startet die Ressource und lädt sie bei Bedarf sauber neu
start ressourcenname	startet die Ressource
stop ressourcenname	stoppt die Ressource

Für die meisten Installationen ist ensure die bessere Wahl.

Beispiel:

ensure oxmysql

ensure es_extended

ensure myresource

Reihenfolge der Ressourcen

Die Reihenfolge in der server.cfg ist wichtig.

Manche Ressourcen benötigen andere Ressourcen, bevor sie starten können.

Beispiel:

oxmysql muss vor vielen ESX- oder QBCore-Scripts gestartet werden, weil diese Scripts eine Datenbankverbindung benötigen.

Eine einfache Reihenfolge kann so aussehen:

Reihenfolge	Beispiel
1	Datenbank-Ressourcen
2	Framework
3	Framework-Abhängigkeiten
4	Jobs und Systeme
5	Fahrzeuge, Maps und kleinere Scripts

Beispiel:

ensure oxmysql

ensure es_extended

ensure esx_society

ensure esx_jobs

ensure myjob

Wenn eine Ressource vor ihrer Abhängigkeit startet, kann sie Fehler erzeugen oder gar nicht geladen werden.

Abhängigkeiten prüfen

Viele Ressourcen benötigen zusätzliche Ressourcen.

Diese werden oft in der Beschreibung oder Dokumentation genannt.

Typische Abhängigkeiten sind zum Beispiel:

• oxmysql

• mysql-async

• ox_lib

• es_extended

• qb-core

• PolyZone

• NativeUI

• menuv

• pma-voice

Wenn eine Abhängigkeit fehlt, erscheinen in der Konsole häufig Fehlermeldungen.

Typische Hinweise sind:

• No such export

• Couldn't find resource

• Missing dependency

• attempt to call a nil value

• SCRIPT ERROR

Prüfe deshalb immer die Installationsanleitung der Ressource.

Datenbank-Scripts installieren

Viele Roleplay-Ressourcen benötigen eine Datenbank.

Das betrifft zum Beispiel:

• Jobs

• Inventare

• Garagen

• Shops

• Banking

• Housing

• Character-Systeme

• Frameworks

Wenn eine Ressource eine .sql-Datei enthält, muss diese häufig in deine Datenbank importiert werden.

Gehe allgemein so vor:

1. Öffne deine Datenbankverwaltung.

2. Wähle die passende Datenbank aus.

3. Importiere die .sql-Datei der Ressource.

4. Prüfe, ob neue Tabellen erstellt wurden.

5. Kontrolliere die Datenbankverbindung in der server.cfg.

6. Starte den Server neu.

Wenn die SQL-Datei nicht importiert wurde, startet die Ressource möglicherweise, funktioniert aber nicht richtig.

Ressource über die Konsole testen

Du kannst Ressourcen auch über die Konsole verwalten.

Typische Befehle:

Befehl	Bedeutung
ensure ressourcenname	Ressource starten oder neu laden
start ressourcenname	Ressource starten
stop ressourcenname	Ressource stoppen
restart ressourcenname	Ressource neu starten
refresh	Ressourcenliste neu einlesen

Beispiel:

restart myresource

Wenn du eine neue Ressource hochgeladen hast und sie nicht erkannt wird, kann refresh helfen. Danach kannst du die Ressource mit ensure ressourcenname starten.

Ressource aktualisieren

Beim Aktualisieren solltest du vorsichtig vorgehen.

Gehe so vor:

1. Stoppe den Server.

2. Erstelle ein Backup der bestehenden Ressource.

3. Lade die neue Version herunter.

4. Lies die Update-Hinweise des Entwicklers.

5. Prüfe, ob sich Konfigurationsdateien geändert haben.

6. Ersetze die alten Dateien.

7. Übernimm eigene Anpassungen vorsichtig.

8. Importiere neue SQL-Dateien nur, wenn es erforderlich ist.

9. Starte den Server.

10. Prüfe die Konsole auf Fehler.

Wichtig: Überschreibe nicht blind deine Konfigurationsdateien. Dabei können Einstellungen, Übersetzungen oder eigene Anpassungen verloren gehen.

Ressource entfernen

Wenn du eine Ressource nicht mehr verwenden möchtest, entferne sie sauber.

Gehe so vor:

1. Stoppe den Server.

2. Entferne den ensure-Eintrag aus der server.cfg.

3. Lösche oder verschiebe den Ressourcenordner.

4. Starte den Server neu.

5. Prüfe die Konsole auf Fehlermeldungen.

Wenn andere Ressourcen von der entfernten Ressource abhängig sind, können danach Fehler auftreten.

Ressource deaktivieren, ohne sie zu löschen

Du kannst eine Ressource auch nur deaktivieren.

Dafür entfernst du den Eintrag nicht zwingend, sondern kommentierst ihn aus.

Beispiel: # ensure myresource

Dadurch bleibt die Ressource auf dem Server, wird aber nicht mehr automatisch gestartet.

Das ist praktisch zum Testen, wenn du prüfen möchtest, ob eine Ressource Probleme verursacht.

Ordnernamen sauber halten

Verwende möglichst einfache Ordnernamen.

Empfohlen:

• nur Buchstaben

• Zahlen

• Bindestriche

• Unterstriche

Vermeide:

• Leerzeichen

• Umlaute

• Sonderzeichen

• sehr lange Namen

• doppelte Ordnerstrukturen

Gutes Beispiel: my_resource

Schlechtes Beispiel: Mein Script Neu !!!

Ressourcen mit Klammerordnern

FiveM unterstützt Sortierordner mit eckigen Klammern.

Beispiel: [standalone]

Darin können mehrere Ressourcen liegen.

Beispielstruktur:

Pfad	Bedeutung
resources/[standalone]/myresource	Ressource liegt in einer Kategorie
resources/[cars]/sportscar	Fahrzeug-Ressource
resources/[maps]/mymap	Map-Ressource

In der server.cfg wird trotzdem nur der eigentliche Ressourcenname verwendet.

Beispiel: ensure myresource

Nicht: ensure [standalone]/myresource

Häufige Fehler

Ressource wird nicht gefunden

Typische Fehlermeldung:

Couldn't find resource myresource

Mögliche Ursachen:

• Ordnername stimmt nicht mit dem ensure-Eintrag überein

• Ressource wurde in den falschen Ordner hochgeladen

• Archiv wurde nicht entpackt

• Ordner liegt eine Ebene zu tief

• fxmanifest.lua fehlt

• Schreibfehler in der server.cfg

Prüfe zuerst den genauen Ordnernamen.

Ressource startet, funktioniert aber nicht

Mögliche Ursachen:

• Abhängigkeit fehlt

• Datenbank wurde nicht importiert

• Config wurde nicht angepasst

• falsches Framework

• falsche Version

• Ressource ist nicht mit deinem Server kompatibel

• Fehler in der Konsole

Prüfe die Dokumentation der Ressource und die Serverlogs.

No such export

Diese Fehlermeldung bedeutet meistens, dass eine Ressource eine Funktion aus einer anderen Ressource verwenden möchte, diese aber nicht verfügbar ist.

Mögliche Ursachen:

• Abhängigkeit fehlt

• Abhängigkeit startet zu spät

• falsche Version der Abhängigkeit

• Ressource wurde nicht gestartet

• falsche Reihenfolge in der server.cfg

SCRIPT ERROR

SCRIPT ERROR bedeutet, dass ein Script während der Ausführung einen Fehler verursacht hat.

Die Ursache steht meistens direkt in der Konsole oder im Log darüber oder darunter.

Prüfe:

• Name der betroffenen Ressource

• Datei und Zeile des Fehlers

• fehlende Abhängigkeiten

• falsche Konfiguration

• Datenbankfehler

• Framework-Kompatibilität

Datenbankfehler

Typische Ursachen:

• falscher Datenbankname

• falscher Benutzername

• falsches Passwort

• falscher Host

• fehlende Tabellen

• SQL-Datei nicht importiert

• falscher Connection String

• Datenbank-Ressource startet zu spät

Prüfe zuerst deine Datenbankverbindung und ob oxmysql oder die genutzte Datenbank-Ressource korrekt gestartet wird.

Server startet nach Installation nicht mehr

Wenn der Server nach einer neuen Ressource nicht mehr startet, gehe so vor:

1. Öffne die Konsole oder Logs.

2. Suche nach der ersten Fehlermeldung.

3. Entferne oder deaktiviere die zuletzt installierte Ressource.

4. Prüfe die server.cfg.

5. Starte den Server erneut.

6. Installiere die Ressource erst wieder, wenn die Ursache gefunden wurde.

Gute Vorgehensweise beim Installieren

Installiere Ressourcen nicht alle auf einmal.

Besser ist:

1. Eine Ressource hochladen.

2. server.cfg anpassen.

3. Server starten.

4. Konsole prüfen.

5. Ressource im Spiel testen.

6. Erst danach die nächste Ressource installieren.

So erkennst du schneller, welche Ressource ein Problem verursacht.