Schnellfinder

Was suchst du?

⌘/Ctrl + K öffnet den Finder · Esc schließt ihn
Gameserver

FiveM Resources installieren: fxmanifest.lua, ensure, Abhängigkeiten und sichere Updates

FiveM Resources richtig installieren: resources-Verzeichnis, fxmanifest.lua, ensure, Abhängigkeiten, Marketplace-Risiken, Updates und Rollback.

Inhalt dieses Guides
Kurz erklärt

FiveM Resources richtig installieren: resources-Verzeichnis, fxmanifest.lua, ensure, Abhängigkeiten, Marketplace-Risiken, Updates und Rollback.

Interaktiv

Server-Arbeitsmodus

Arbeite den Guide kontrolliert ab und ändere immer nur eine Variable. Dein Fortschritt bleibt nur in diesem Browser gespeichert.

0/5erledigt
Bei aktiviertem JavaScript werden Fortschritt und Auswahl nur lokal in diesem Browser gespeichert.

Der größte Teil eines individuellen FiveM-Servers entsteht durch Resources. Eine Resource kann Scripts, Streaming-Assets und Konfiguration enthalten und unabhängig gestartet oder gestoppt werden. Diese Flexibilität ist praktisch, erhöht aber auch das Risiko für Abhängigkeitsfehler, schlechte Updates oder unsichere Fremdsoftware.

Ordnerstruktur

Resources liegen unter resources/. Ordner in eckigen Klammern dienen als Kategorien. Ein Resource-Ordner benötigt grundsätzlich ein Manifest wie fxmanifest.lua. Fehlt es unbeabsichtigt, meldet FXServer einen entsprechenden Hinweis.

Installation in kleinen Schritten

  1. Quelle und Lizenzbedingungen prüfen.
  2. Resource in einen klar benannten Unterordner legen.
  3. Manifest und dokumentierte Abhängigkeiten lesen.
  4. Abhängigkeiten zuerst installieren.
  5. ensure resourceName in einer Testumgebung ausführen.
  6. Logs prüfen und echten Client-Usecase testen.
  7. Erst danach Produktion aktualisieren.

Abhängigkeiten ernst nehmen

Cfx weist ausdrücklich darauf hin, dass Community-Ressourcen voneinander abhängen können. Zusätzlich kann ein fxmanifest.lua Mindest-Serverbuild, OneSync, Game-Build oder bestimmte Policy-Funktionen verlangen. Ein Resource-Fehler ist daher nicht automatisch ein FXServer-Problem.

Bezugsquelle und Supply Chain

Community-Ressourcen sind fremder Code. Nutze etablierte Quellen, dokumentiere Downloadversion und Hash/Release, und prüfe bei kostenpflichtigen Ressourcen, ob der Vertrieb über die vorgesehenen Cfx-/Tebex-Kanäle erfolgt. Installiere keine „Leaks“ oder dubiose Reuploads.

Updates mit Rollback

Sichere alte Resource-Version und zugehörige Konfiguration. Bei Datenbankmigrationen reicht ein Ordnerbackup nicht: Prüfe, ob das Update Schemaänderungen ausführt und ob ein Downgrade unterstützt wird. Plane einen Snapshot oder Dump vor der Migration.

Startreihenfolge dokumentieren

Framework, Datenbankbibliothek, Inventar, Voice und Gameplay-Resources können Reihenfolgeanforderungen haben. Gruppiere ensure-Zeilen logisch und kommentiere Sonderfälle. So lässt sich ein kaputtes Update durch binäre Suche schneller isolieren.

Für die Grundkonfiguration siehe server.cfg erklärt, für Betriebsupdates Backup & Update.

Resource-Inventar pflegen

Führe eine kleine Liste mit Resource-Name, Quelle, installierter Version, Lizenz, Abhängigkeiten und letztem Update. Bei 30 oder 50 Resources ist es sonst kaum noch möglich, eine fehlerhafte Kombination gezielt zurückzurollen. Das Inventar hilft außerdem beim Hosterwechsel und bei einem Restore auf frischer Hardware.

Bei selbst entwickelten Resources sollte der Quellcode getrennt vom Produktionsverzeichnis versioniert werden. Die produktive Instanz erhält dann einen definierten Releasezustand statt zufälliger Zwischenstände direkt aus einem Arbeitsordner.

Quellen

Nächster Schritt

Passend dazu