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

Manuell per SFTP installieren

Vorbereitung

Die Installation der Resources erfolgt per SFTP. Du brauchst also einen SFTP-Client wie FileZilla oder WinSCP, um Dateien auf deinen Gameserver hochzuladen. Wie du die Verbindung einrichtest, erklärt unsere Anleitung SFTP-Zugang.

Heruntergeladene Resources werden meist in komprimierter Form angeboten. Das heißt, du musst die gepackten Dateien mit einem Entpack-Programm wie 7Zip, Winrar oder WinZip entpacken. Der entpackte Resource-Ordner sollte mindestens folgende Dateien enthalten: __resource.lua oder fxmanifest.lua sowie die zugehörigen Script-Dateien.

Info

Falls diese Dateien nicht direkt sichtbar sind, könnten sie sich in einem Unterordner innerhalb der Resource befinden.

Dateien hochladen

Jetzt musst du die zuvor entpackten Dateien als einzelnen Ordner (falls noch nicht geschehen) hochladen. Dein Ordner muss in das resources Verzeichnis deines aktiven Server-Ordners hochgeladen werden. Nach dem SFTP-Login liegt es unter fivem/<Variante>/<Name>_<Code>.base/resources, zum Beispiel fivem/standard/Qbox_E99E54.base/resources. Welcher Server-Ordner aktiv ist, siehst du in txAdmin unter Settings → FXServer im Feld Server Data Folder. Den kompletten Ordneraufbau erklärt der Abschnitt FiveM: Server-Dateien per SFTP verwalten in der SFTP-Anleitung.

Manche Resources arbeiten mit einer Datenbank zusammen und enthalten daher oft schon SQL-Dateien, die in die Datenbank importiert werden müssen. Das geht am einfachsten über den SQL-Import im Resource Installer oder wie in unserer Anleitung SQL-Datei Import beschrieben.

Aktivierung

Damit die installierte Resource beim Serverstart geladen wird, musst du sie zuerst in der server.cfg Datei deines Servers aktivieren. Die Aktivierung erfolgt über den Befehl ensure [Beispiel Resource].

Wenn du zum Beispiel die Resource im Ordner eup-ui hochgeladen hast, muss der Befehl in der Config so aussehen:

Code
ensure eup-ui

Auf deine server.cfg Datei kannst du über den CFG Editor im txAdmin Interface zugreifen.

Info

Achte darauf, dass der Name des zuvor erstellten Ordners exakt mit dem im ensure-Befehl übereinstimmt – Groß- und Kleinschreibung sind hier wichtig.

Beliebte Resources

Du suchst noch nach den perfekten Resources für deinen Server? Stöbere durch unsere sorgfältig zusammengestellte Liste der beliebtesten und am meisten empfohlenen Resources, um dein Gameplay zu verbessern und deinem Server den letzten Schliff zu geben. Lass dich inspirieren und finde genau die Addons, die zu deinem Projekt passen.

  • ESX Framework – Eines der ältesten und am weitesten verbreiteten Roleplay-Frameworks mit der größten Script-/Community-Basis.
  • QBCore Framework – Modernes, sauber strukturiertes RP-Framework mit eigenem Ressourcen-Ökosystem und aktiver Community.
  • Qbox – Neuerer, stärker qualitätsgesicherter Fork von QBCore mit TypeScript-Unterstützung.
  • ox_lib – Gemeinsame Utility-Bibliothek (Overextended), die viele andere Ressourcen als Abhängigkeit nutzen.
  • ox_inventory – Framework-übergreifendes Inventarsystem (ESX/QBCore/Qbox), gilt als heutiger Quasi-Standard.
  • ox_target – Standalone „Third-Eye“-Targeting-Ressource für Interaktionen mit Objekten, Zonen und Spielern.
  • ps-dispatch – Verbreitetes Dispatch-/Notruf-System (Project Sloth) für Polizei-/Rettungsdienst-Rollenspiel.

Abschluss

Zum Schluss startest du deinen Server neu. Die installierte Resource wird beim nächsten vollständigen Start geladen. Du hast erfolgreich eine Resource in deinen FiveM Gameserver installiert. Eigene kleine Resources kannst du dir übrigens mit dem ZapX Resource Maker erstellen lassen. Bei weiteren Fragen oder wenn du Hilfe brauchst, steht dir unser Support-Team täglich zur Verfügung! 🙂

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.

Zappy kennt diese Anleitung und antwortet dir direkt im Chat.