Ressourcen installieren

Resources installieren

Du hast eine tolle Resource gefunden und möchtest sie auf deinem FiveM-Server installieren? In dieser Anleitung erklären wir Schritt für Schritt, wie du das über das HytaleNode-Panel auf mijn.hytalenode.nl machst.

Schritt 1: Resource herunterladen

Lade zuerst die Resource herunter, die du installieren möchtest. Dies hängt davon ab, woher du die Resource hast:

• GitHub: Gehe zum Repository der Resource. Klicke auf die grüne Schaltfläche „Code" und wähle „Download ZIP". Die ZIP-Datei wird nun auf deinen Computer heruntergeladen.
• Cfx.re Forums: Folge dem Download-Link im Forum-Beitrag. Dies verweist meist auf GitHub oder einen direkten Download.
• Tebex/kostenpflichtige Resources: Nach dem Kauf erhältst du einen Download-Link. Folge den Anweisungen des Verkäufers.

Bild: hier muss ein Screenshot eines GitHub-Repositories mit der grünen „Code"-Schaltfläche und der Option „Download ZIP" eingefügt werden

Schritt 2: Datei entpacken

Die heruntergeladene Datei ist meist eine .zip-Datei. Entpacke sie auf deinem Computer:

• Windows: Klicke mit der rechten Maustaste auf die ZIP-Datei und wähle „Alles extrahieren".
• Mac: Doppelklicke auf die ZIP-Datei, um sie zu entpacken.

Nach dem Entpacken hast du einen Ordner mit den Resource-Dateien. Der Ordnername enthält oft „-main" oder „-master" (z. B. esx_policejob-main). Benenne den Ordner in den richtigen Resource-Namen um, indem du das Suffix entfernst (also esx_policejob). Dies ist wichtig, da der Ordnername der Name ist, mit dem FiveM die Resource erkennt.

Schritt 3: Resource auf deinen Server hochladen

Jetzt musst du den Resource-Ordner auf deinen FiveM-Server hochladen. Dies kann auf zwei Arten erfolgen:

Option A: Über den Tab Dateien im Panel

1. Melde dich auf mijn.hytalenode.nl an und gehe zu deinem FiveM-Server.
2. Klicke auf den Tab „Dateien" im linken Menü.
3. Navigiere zum Ordner resources/. Du siehst hier wahrscheinlich Unterordner wie [local], [standalone] oder framework-spezifische Ordner.
4. Gehe zum Unterordner, in dem du die Resource platzieren möchtest (z. B. [local] für eigene Resources).
5. Klicke auf die Schaltfläche „Hochladen" und lade die Dateien deiner Resource hoch. Achtung: Bei großen Resources mit vielen Dateien ist SFTP schneller und zuverlässiger (siehe Option B).

Bild: hier muss ein Screenshot des Tabs Dateien im HytaleNode-Panel mit geöffnetem resources-Ordner eingefügt werden

Option B: Über SFTP (empfohlen für größere Resources)

1. Lade ein SFTP-Programm wie WinSCP (Windows) oder FileZilla (Windows/Mac) herunter und installiere es.
2. Gehe im Panel zu „Einstellungen" und suche deine SFTP-Daten (Host, Port, Benutzername). Dein Passwort ist dasselbe wie dein Panel-Passwort.
3. Verbinde dich per SFTP mit deinem Server.
4. Navigiere zum Ordner resources/[local]/ (oder einem anderen Unterordner nach Wahl).
5. Ziehe den Resource-Ordner von deinem Computer in den SFTP-Client, um ihn hochzuladen.

Tipp: Es ist sinnvoll, eigene Resources in einem Unterordner wie [local] zu platzieren. So hältst du sie getrennt von Framework-Resources und findest sie leichter wieder. FiveM lädt automatisch alle Unterordner innerhalb von resources/.

Schritt 4: Resource in server.cfg aktivieren

Die Resource liegt nun auf deinem Server, aber FiveM weiß noch nicht, dass sie geladen werden soll. Das stellst du in der Datei server.cfg ein:

1. Gehe zu „Dateien" im Panel.
2. Öffne die Datei server.cfg (liegt im Hauptverzeichnis deines Servers).
3. Füge unten (oder bei den anderen ensure-Zeilen) folgende Zeile hinzu:

ensure resourcenaam

Ersetze resourcenaam durch den exakten Ordnernamen deiner Resource. Zum Beispiel:

ensure esx_policejob

Wichtig: Der Name nach ensure muss exakt mit dem Ordnernamen der Resource übereinstimmen. Achte auf Groß- und Kleinschreibung.

Schritt 5: Server neu starten

Um die neue Resource zu laden, musst du deinen Server neu starten:

1. Gehe zum Tab „Konsole" in deinem Panel.
2. Klicke auf die Schaltfläche „Neustart" oben auf der Seite.
3. Warte, bis der Server vollständig gestartet ist.

In der Konsole siehst du, ob die Resource erfolgreich geladen wurde. Wenn alles gut geht, siehst du eine Meldung, dass die Resource gestartet wurde. Bei einem Fehler siehst du eine rote Fehlermeldung – lies sie genau, denn sie sagt dir oft genau, was schiefgegangen ist.

Abhängigkeiten prüfen

Viele Resources haben Dependencies – andere Resources, die zuerst geladen werden müssen. Überprüfe immer die README oder Dokumentation der Resource, die du installierst. Häufige Dependencies sind:

• oxmysql oder mysql-async – für Datenbankverbindung
• es_extended oder qb-core – das Framework selbst
• ox_lib – eine häufig verwendete Hilfsbibliothek

Wenn eine Dependency fehlt, erhältst du eine Fehlermeldung in der Konsole. Installiere dann zuerst die fehlende Resource mit denselben Schritten wie oben, und stelle sicher, dass sie über der abhängigen Resource in deiner server.cfg steht (damit sie zuerst geladen wird).

Tipp: Installiere Resources einzeln und starte deinen Server nach jeder Installation neu. So siehst du sofort, ob eine Resource Probleme verursacht, anstatt alles gleichzeitig debuggen zu müssen.