Zum Inhalt springen

FiveM: Resources installieren – per Klick oder per SFTP

Installiere FiveM-Resources per Klick mit dem Resource Installer im Dashboard: ZIP hochladen, ensure-Zeile automatisch eintragen, SQL-Datei direkt importieren. Alternativ manuell per SFTP.

10. November 20267 Min. Lesezeit0 Aufrufe0 hilfreich

Einführung

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.

Resources mit dem Resource Installer installieren

Info

Der Resource Installer steht für FiveM-Server zur Verfügung. Für FiveM Enhanced und RedM nutzt du den Weg per SFTP.

Schritt 1: Installer öffnen

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

Schritt 2: ZIP-Archiv hochladen

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, .bat oder .sh werden nie auf deinen Server geschrieben.

Schritt 3: Analyse prüfen

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.lua stehen, 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.

Schritt 4: Installieren und automatisch starten

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.cfg steht schon ensure [Kategorie], darüber wird die Resource mitgestartet.
  • ensure-Zeile fehlt noch: trage ensure <Name> selbst in die server.cfg ein (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.

Schritt 5: SQL-Datei importieren (optional)

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.

  1. 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.
  2. 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.
  3. Mit aktivem ZapX Pass wird vor dem Import automatisch ein Backup der Datenbank angelegt. Ohne Pass bestätigst du Ich importiere ohne Backup.
  4. 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.

Info

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.

Typische Fehler und Lösungen

Meldung oder ProblemLösung
RAR- und 7z-Archive werden nicht unterstütztEntpacke das Archiv und packe den Ordner als ZIP neu.
Dieses Archiv lässt sich nicht installierenPrü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 ServerInstalliere 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-VorlageRichte in txAdmin zuerst eine Server-Vorlage ein, danach öffnest du den Installer erneut.
Auf diesem Server läuft bereits eine InstallationWarte, bis die laufende Installation fertig ist. Sie wird auf der Seite weiter angezeigt.
Installation wurde unterbrochen oder ist fehlgeschlagenPrü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 erlaubtEntferne 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 nichtPrü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.
Info

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.

FAQ

Häufig gestellte Fragen

Mit dem FiveM Resource Installer im Tab Tools deines Server-Dashboards: ZIP hochladen, Analyse prüfen, installieren. Der Installer legt die Resource im richtigen Ordner ab und trägt sie in die server.cfg ein.
ZIP-Archive bis 100 MB. RAR- und 7z-Dateien packst du vorher als ZIP neu.
Nein. Der Installer zeigt mitgelieferte SQL-Dateien an, importiert sie aber erst, wenn du auf „In Datenbank importieren“ klickst. Möglich sind Dateien bis 2 MB.

Feedback

War dieser Artikel hilfreich?

Deine Rückmeldung hilft uns, Inhalte besser zu priorisieren und zu überarbeiten.

0 von 0 Rückmeldungen fanden diesen Artikel hilfreich.

Persönliche Hilfe

Die Anleitung reicht nicht?

Unser ZAP-Support kennt dein Produkt — beschreib kurz dein Anliegen und wir helfen dir persönlich weiter.