> For the complete documentation index, see [llms.txt](https://docs.instantroot.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.instantroot.de/gameserver/fivem/ressourcen-installieren-und-verwalten.md).

# 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.