So fügst Du Resources auf Deinem FiveM Server hinzu

Skripte, Maps, Fahrzeuge und Frameworks werden bei FiveM alle auf die gleiche Weise installiert: als Resource. Jede Resource ist ein eigener Ordner, der eine fxmanifest.lua enthält, im resources-Verzeichnis Deines Servers liegt und in der server.cfg gestartet wird.

Wo befindet sich der resources-Ordner?

Resources werden aus einem Ordner namens resources/ im Server-Datenverzeichnis geladen. Wo dieses Verzeichnis liegt, hängt davon ab, wie Du Deinen Server eingerichtet hast:

Resource hochladen

1. Server stoppen
   Stoppe Deinen Server über die Verwaltung, bevor Du Dateien änderst.

2. Archiv entpacken
   Entpacke das heruntergeladene Archiv auf Deinem PC. Der Server kann keine ZIP- oder RAR-Dateien lesen.

3. Ordnerstruktur prüfen
   Die fxmanifest.lua muss direkt im Ordner der Resource liegen. Viele Downloads sind doppelt verschachtelt (z.B. mein-skript-main/mein-skript/) – lade dann nur den inneren Ordner hoch:

   resources/
   └── mein-skript/
       ├── fxmanifest.lua
       ├── client.lua
       └── server.lua
   

4. Ordnernamen merken
   Der Ordnername ist der Name der Resource – genau diesen Namen trägst Du später in die ensure-Zeile ein.

5. Per SFTP verbinden
   Verbinde Dich per SFTP mit Deinem Server.

6. Ordner hochladen
   Lade den Ordner der Resource in Dein resources-Verzeichnis hoch.

Kategorien mit eckigen Klammern

Jeder Ordner im resources-Verzeichnis wird als Resource gelesen – außer Ordner in [eckigen Klammern]. Diese sind Kategorien und dürfen mehrere Resources enthalten:

resources/
├── [standalone]/
│   ├── skript-a/
│   └── skript-b/
└── mein-skript/

Kategorien lassen sich auch verschachteln. Kategorienamen werden nie Teil des Resource-Namens: Eine Resource unter [standalone]/mein-skript heißt weiterhin einfach mein-skript.

Resource in der server.cfg starten

1. server.cfg öffnen
   Öffne die server.cfg Deines Servers per SFTP oder über den CFG Editor in der txAdmin Web-Oberfläche.

2. ensure-Zeile eintragen
   Trage für jede neue Resource eine eigene Zeile ein:

   ensure mein-skript
   

3. Reihenfolge beachten
   Resources werden in der Reihenfolge gestartet, in der die Zeilen in der server.cfg stehen. Abhängigkeiten müssen deshalb weiter oben stehen als die Skripte, die sie benötigen – also z.B. erst Dein Framework und Deine Datenbank-Resource, dann die einzelnen Skripte.

4. Server starten
   Speichere die Datei und starte Deinen Server über die Verwaltung.

ensure, start und stop im Vergleich

ensure, start, stop und restart funktionieren alle auch mit Kategorienamen.

Konsole prüfen

Beobachte nach dem Start die Konsole in der Verwaltung – oder die Live Console in txAdmin, falls Du txAdmin nutzt. Typische Meldungen:

• Started resource <name> – die Resource wurde erfolgreich gestartet.
• Couldn't find resource <name>. – der Ordnername stimmt nicht mit der ensure-Zeile überein, oder der Ordner liegt im falschen resources-Verzeichnis.
• <name> does not have a resource manifest (fxmanifest.lua) – im Ordner fehlt die fxmanifest.lua. Das passiert typischerweise, wenn ein doppelt verschachtelter Ordner hochgeladen wurde.
• Fehler beim Start eines Skripts – meist fehlt eine Abhängigkeit oder sie steht in der server.cfg unterhalb des Skripts.

Resource entfernen

1. Server stoppen
   Stoppe Deinen Server über die Verwaltung.

2. ensure-Zeile entfernen
   Lösche die passende ensure-Zeile aus der server.cfg oder kommentiere sie mit einem # am Zeilenanfang aus.

3. Ordner löschen
   Lösche den Ordner der Resource per SFTP aus dem resources-Verzeichnis.

4. Server starten
   Starte Deinen Server und prüfe die Konsole auf Folgefehler durch andere Skripte, die die Resource benötigt haben.