Ressourcen verwalten

Resources verwalten

Du hast Resources auf deinem FiveM-Server installiert – aber wie verwaltest du sie? In dieser Anleitung lernst du, wie du Resources starten, stoppen, neu laden und entfernen kannst. Außerdem erklären wir, wie du Fehler erkennen und beheben kannst.

Resources starten und stoppen

Du musst nicht immer deinen gesamten Server neu starten, wenn du eine Resource starten oder stoppen möchtest. Über die Serverkonsole im Panel kannst du Resources einzeln mit Befehlen steuern.

Über die Serverkonsole

Gehe zum Tab „Konsole" in deinem Panel auf mijn.hytalenode.nl. Unten siehst du ein Eingabefeld, in dem du Befehle eingeben kannst. Verwende folgende Befehle:

ensure resourcenaam – Startet eine Resource. Wenn die Resource bereits läuft, wird sie zuerst gestoppt und neu gestartet. Dies ist der praktischste Befehl zum Merken.
stop resourcenaam – Stoppt eine laufende Resource. Die Resource wird vollständig deaktiviert, bis du sie wieder startest.
start resourcenaam – Startet eine gestoppte Resource. Verwende dies nur, wenn die Resource noch nicht läuft, sonst erhältst du eine Fehlermeldung.
restart resourcenaam – Startet eine Resource neu. Dies ist dasselbe wie stop gefolgt von start.
refresh – Scannt den resources-Ordner erneut. Verwende dies, wenn du eine neue Resource hochgeladen hast, aber deinen Server nicht neu starten möchtest. Nach refresh kannst du die neue Resource mit ensure starten.

Beispiel: Du hast ein Update von esx_policejob hochgeladen und möchtest es neu laden, ohne den gesamten Server neu zu starten. Gib dann in der Konsole ein:

ensure esx_policejob

Über txAdmin

Wenn dein Server txAdmin verwendet (dies ist standardmäßig auf HytaleNode-FiveM-Servern aktiviert), hast du eine zusätzliche Option zur Resource-Verwaltung:

Öffne txAdmin über den Link in deinem Panel oder indem du zur txAdmin-Adresse navigierst.
Gehe zur Seite „Resources" im txAdmin-Menü.
Hier siehst du eine Übersicht aller Resources auf deinem Server.
Du kannst Resources mit den Schaltflächen neben jeder Resource starten, stoppen und neu starten.

txAdmin bietet eine visuelle Übersicht und ist praktisch, wenn du schnell sehen möchtest, welche Resources laufen und welche nicht.

Ladereihenfolge (Load Order)

Die Reihenfolge, in der Resources geladen werden, ist sehr wichtig. Resources werden in der Reihenfolge geladen, in der sie in deiner server.cfg stehen. Wenn eine Resource von einer anderen Resource abhängt (eine Dependency), muss diese Dependency früher in der Liste stehen.

Eine gute Reihenfolge für deine server.cfg ist:

Datenbank-Resource – oxmysql oder mysql-async (fast alles benötigt dies)
Hilfsbibliotheken – ox_lib und andere Libraries
Framework – es_extended oder qb-core
Framework-Komponenten – Inventar, Identität, Multicharacter
Job-Resources – Polizei, Rettungsdienst, Mechaniker usw.
Weitere Resources – HUD, Chat, zusätzliche Funktionen

Tipp: Wenn eine Resource sich seltsam verhält oder nicht funktioniert, überprüfe zuerst, ob alle Dependencies darüber in der server.cfg stehen.

Fehler in der Konsole erkennen

Wenn eine Resource nicht richtig funktioniert, gibt die Konsole meist eine Fehlermeldung aus. Hier sind die häufigsten Fehler und was sie bedeuten:

„Could not find resource [name]" – Der Resource-Ordner existiert nicht oder der Ordnername stimmt nicht mit dem Namen in der server.cfg überein. Überprüfe die Schreibweise und ob der Ordner am richtigen Ort liegt.
„Failed to load script" – Es gibt einen Fehler im Script-Code. Dies kann durch eine fehlende Dependency oder einen Bug in der Resource selbst verursacht werden. Prüfe, ob alle Dependencies installiert sind.
„No such export" – Die Resource versucht, eine Funktion einer anderen Resource zu verwenden, die nicht läuft oder eine ältere Version hat. Stelle sicher, dass alle zugehörigen Resources aktuell sind.
„SCRIPT ERROR" – Ein Fehler im Lua/JavaScript-Code der Resource. Lies die Fehlermeldung genau: Meist steht ein Dateiname und eine Zeilennummer dabei. Dies hilft bei der Suche nach einer Lösung.
„Access denied" oder Datenbankfehler – Die Resource kann keine Verbindung zur Datenbank herstellen. Überprüfe, ob deine Datenbankdaten korrekt eingestellt sind und ob oxmysql oder mysql-async ordnungsgemäß läuft.

Tipp: Kopiere die exakte Fehlermeldung und suche danach bei Google oder im Cfx.re-Forum. Große Chance, dass jemand anderes dasselbe Problem schon hatte und eine Lösung geteilt hat.

Resources entfernen

Möchtest du eine Resource vollständig von deinem Server entfernen? Folge diesen Schritten:

Stoppe die Resource – Gib stop resourcenaam in der Konsole ein, oder starte deinen Server nach Schritt 2 und 3 neu.
Entferne die ensure-Zeile – Öffne server.cfg und entferne (oder setze ein # vor) die Zeile ensure resourcenaam.
Entferne die Dateien – Gehe zu „Dateien" im Panel, navigiere zum Resource-Ordner in resources/ und lösche den gesamten Ordner.
Datenbank aufräumen (optional) – Einige Resources erstellen Tabellen in deiner Datenbank. Wenn du die Resource dauerhaft entfernen möchtest, kannst du diese Tabellen auch löschen. Schaue in der Dokumentation der Resource nach, welche Tabellen erstellt wurden.

Achtung: Bevor du eine Resource entfernst, überprüfe, ob andere Resources nicht davon abhängen. Das Entfernen einer Dependency kann dazu führen, dass andere Resources abstürzen.

Resources aktualisieren

Es ist sinnvoll, deine Resources regelmäßig zu aktualisieren für Bugfixes und neue Funktionen. Um eine Resource zu aktualisieren:

Lade die neueste Version der Resource herunter.
Erstelle ein Backup deines aktuellen Resource-Ordners (kopiere ihn oder lade ihn per SFTP herunter).
Speichere deine Konfigurationsdateien separat (meist config.lua oder config.js). Du möchtest deine Einstellungen nicht verlieren.
Ersetze die alten Dateien durch die neue Version.
Setze deine Konfiguration zurück oder passe die neue Konfiguration mit deinen alten Einstellungen an.
Starte die Resource mit ensure resourcenaam neu.

Wichtig: Lies immer das Changelog oder die Release Notes eines Updates. Manchmal sind Datenbankmigrationen erforderlich oder Konfigurationsoptionen haben sich geändert.