Resources kannst du nutzen, um deinen FiveM Gameserver mit zusätzlichen Features zu erweitern. Das ist besonders spannend, wenn du größere Projekte wie einen Roleplay-Server oder Ähnliches planst. So etwas geht kaum ohne solche zusätzlichen Resources.
FiveM und seine Community bieten eine riesige Auswahl an Resources. Eine Übersicht der beliebtesten Resources findest du im Cfx.re Forum: https://forum.cfx.re/c/development/releases/7
Am schnellsten installierst du eine Resource mit dem FiveM Resource Installer direkt im Dashboard. Du lädst das ZIP-Archiv hoch, der Installer legt die Resource im richtigen Ordner ab, trägt sie in die server.cfg ein und importiert mitgelieferte SQL-Dateien auf Wunsch in deine Datenbank. Den klassischen Weg per SFTP findest du weiter unten.
Der Resource Installer steht für FiveM-Server zur Verfügung. Für FiveM Enhanced und RedM nutzt du den Weg per SFTP.
Öffne das Dashboard deines FiveM-Servers, wechsle in den Tab Tools und wähle FiveM Resource Installer. Deinen Server musst du dafür nicht stoppen.
Voraussetzung ist, dass in txAdmin bereits eine Server-Vorlage (Recipe) eingerichtet ist. Erst dann gibt es eine server.cfg und einen resources-Ordner, in die der Installer schreiben kann.
Lade die Resource als ZIP-Archiv hoch. Ein Download von GitHub über Code → Download ZIP oder ein Release-ZIP funktioniert direkt.
- Erlaubt sind ZIP-Dateien bis 100 MB (entpackt höchstens 400 MB und 5.000 Dateien).
- RAR- und 7z-Archive packst du vorher als ZIP neu.
- Überflüssige Zwischenordner (z. B.
meine-resource-main) entfernt der Installer selbst, Versions- und-main-Anhänge streicht er aus dem Namen. - Enthält ein Archiv mehrere Resources, listet der Installer sie einzeln auf und sortiert sie nach ihren Abhängigkeiten.
- Ausführbare Dateien wie
.exe,.batoder.shwerden nie auf deinen Server geschrieben.
Bevor etwas installiert wird, zeigt dir der Installer, was im Archiv steckt:
- Name und Zielordner: Der Name darf Buchstaben, Ziffern sowie
_,.und-enthalten (höchstens 64 Zeichen). Unter Ordner in resources/ wählst du den Kategorie-Ordner, zum Beispiel[standalone]. Bringt das Archiv keinen mit, ist[local]vorausgewählt. Mit Direkt in resources/ (ohne Ordner) landet die Resource ohne Kategorie-Ordner. - Abhängigkeiten: Für jede Abhängigkeit (z. B. ESX, QBCore, Qbox, ox_lib, oxmysql) siehst du, ob sie im Archiv, auf dem Server vorhanden ist oder auf dem Server fehlt. Abhängigkeiten, die nur im Code auftauchen und nicht in der
fxmanifest.luastehen, sind als vermutet markiert. - Sicherheits-Scan: Der Installer prüft alle
.lua- und.js-Dateien auf bekannte Schadcode-Muster. Bei einem Treffer bekommst du eine Warnung. Du kannst trotzdem installieren, der Sicherheits-Scan deaktiviert die Resource aber beim nächsten Serverstart. Hältst du es für einen Fehlalarm, melde dich bei unserem Support. - SQL-Dateien: Mitgelieferte
.sql-Dateien werden aufgelistet, mit dem Hinweis, welche Tabellen sie anlegen, ändern oder befüllen.
Gibt es die Resource schon auf deinem Server, bricht der Installer standardmäßig ab. Willst du sie ersetzen (z. B. für ein Update), setze den Haken bei Vorhandene Resource überschreiben. Dabei wird der ganze Ordner ersetzt, auch deine Einstellungen wie config.lua. Der alte Ordner wird vorher als Archiv unter backups/resource-installer/ gesichert.
Lass den Haken bei In die server.cfg eintragen, damit sie automatisch startet gesetzt. Der Installer trägt dann ensure <Name> hinter den Abhängigkeiten der Resource in die server.cfg deines aktiven Server-Ordners ein und sichert die alte server.cfg vorher als server.cfg.bak-….
Klicke auf Auf den Server installieren. Du siehst den Fortschritt (Backup, Entpacken, Ablegen, server.cfg ergänzen, Ergebnis prüfen). Die Installation läuft auch weiter, wenn du die Seite schließt.
Im Ergebnis steht, wie die Resource startet:
- ensure-Zeile in der server.cfg ergänzt: alles erledigt.
- stand schon in der server.cfg: die Zeile gab es bereits.
- startet über den Kategorie-Ordner: in deiner
server.cfgsteht schonensure [Kategorie], darüber wird die Resource mitgestartet. - ensure-Zeile fehlt noch: trage
ensure <Name>selbst in dieserver.cfgein (siehe Aktivierung).
Damit FiveM die neue Resource lädt, starte den Server über Server neu starten neu. Alternativ gibst du in der Live-Konsole refresh und danach ensure <Name> ein.
Braucht die Resource eine Datenbank, importierst du ihre SQL-Datei direkt aus dem Installer. Das passiert nicht automatisch, sondern nur, wenn du bei der jeweiligen Datei auf In Datenbank importieren klickst.
- Wähle die Datenbank deines Servers aus. Die Hauptdatenbank ist vorausgewählt. Hat dein Server noch keine Datenbank, legst du sie über Datenbank anlegen im Tab Datenbanken an.
- Gibt es Tabellen aus der Datei schon, zeigt der Dialog das an. Lass dann Vorhandene Tabellen überspringen (empfohlen) gewählt. So bleiben bestehende Tabellen und ihre Daten unangetastet.
- Mit aktivem ZapX Pass wird vor dem Import automatisch ein Backup der Datenbank angelegt. Ohne Pass bestätigst du Ich importiere ohne Backup.
- Klicke auf Jetzt importieren.
Pro Datei sind bis zu 2 MB und 5.000 SQL-Anweisungen möglich. Größere Dateien importierst du wie in FiveM: SQL-Datei importieren beschrieben über phpMyAdmin.
Der Import läuft immer in der ausgewählten Datenbank. Zeilen wie CREATE DATABASE … oder USE … sind deshalb nicht erlaubt. Steht so eine Zeile in der Datei, wird sie nicht importiert. Entferne die Zeilen, packe das ZIP neu und lade es noch einmal hoch.
| Meldung oder Problem | Lösung |
|---|---|
| RAR- und 7z-Archive werden nicht unterstützt | Entpacke das Archiv und packe den Ordner als ZIP neu. |
| Dieses Archiv lässt sich nicht installieren | Prüfe Name und Zielordner. Gibt es eine Resource mit gleichem Namen in einem anderen Ordner, benenne die neue um oder entferne die alte. Enthält das Archiv keine fxmanifest.lua (bzw. __resource.lua), ist es keine Resource, sondern z. B. nur eine Map- oder Fahrzeugdatei. |
| Abhängigkeit fehlt auf dem Server | Installiere die fehlende Resource (z. B. ox_lib) zuerst, ebenfalls mit dem Installer. Ohne sie startet die Resource meist nicht. |
| Hinweis auf fehlendes Recipe bzw. fehlende Server-Vorlage | Richte in txAdmin zuerst eine Server-Vorlage ein, danach öffnest du den Installer erneut. |
| Auf diesem Server läuft bereits eine Installation | Warte, bis die laufende Installation fertig ist. Sie wird auf der Seite weiter angezeigt. |
| Installation wurde unterbrochen oder ist fehlgeschlagen | Prüfe den Server und starte die Installation erneut. Wurde eine vorhandene Resource überschrieben, stellt der Installer den alten Ordner bei einem Fehler wieder her. |
| SQL: USE ist nicht erlaubt bzw. Datenbanken anlegen, ändern oder löschen ist nicht erlaubt | Entferne die USE- und CREATE DATABASE-Zeilen aus der SQL-Datei und lade das ZIP neu hoch. |
| SQL: Gescheitert in Zeile … | Die Anweisungen bis zu dieser Zeile wurden bereits ausgeführt. Korrigiere die Datei und starte den Import erneut, mit Vorhandene Tabellen überspringen. |
| Resource startet nach dem Neustart nicht | Prüfe in der Live-Konsole die Fehlermeldung, ob alle Abhängigkeiten laufen und ob die ensure-Zeile nach ihren Abhängigkeiten steht. Hilfe bei häufigen Fehlern: FiveM: Häufige Probleme. |
Du willst ein Archiv erst prüfen, ohne es zu installieren? Unser kostenloses Tool FiveM Resource Installer analysiert es direkt im Browser, ohne dass etwas hochgeladen wird.
