Eine eingebaute FiveM-Ressource ersetzen¶

Das offizielle FiveM-Image bringt mehrere System-Ressourcen fest verankert im Server-Binärpfad mit (/opt/cfx-server/citizen/system_resources/). Diese Ordner gehören zum schreibgeschützten Image, nicht zum Daten-Volume deines Servers. Du kannst sie also weder über den Dateimanager noch per SFTP bearbeiten, und FiveM lädt sie bei jedem Boot automatisch.

Mit Zaroz Cloud kannst du jede dieser vier System-Ressourcen durch deine eigene Version ersetzen:

chat — die Chatbox im Spiel
monitor — das txAdmin-Verwaltungspanel
webpack — bündelt das JavaScript von Ressourcen im Build-Schritt
yarn — installiert die Abhängigkeiten von Ressourcen im Build-Schritt

Dafür legst du einen Ersatzordner an einer speziellen Stelle in deinen Serverdateien ab. Alles, was du dort ablegst, liegt im Daten-Volume deines Servers und überlebt somit Neustarts und Container-Rebuilds.

Die meisten Server brauchen nur chat

chat zu ersetzen ist mit Abstand der häufigste Fall. monitor, webpack und yarn sind für fortgeschrittene Setups — lass sie in Ruhe, sofern du nicht genau weißt, dass du sie brauchst.

Für die Ressource chat gibt es zusätzlich die Möglichkeit, sie ganz zu deaktivieren, statt sie zu ersetzen. Siehe weiter unten Den Standard-Chat deaktivieren.

Eine Ressource durch deinen eigenen Ordner ersetzen¶

Wenn deine eigene Version einer Ressource an die Stelle des Standards treten soll (gleicher Name, gleiche Ladereihenfolge, gleiche Priorität als System-Ressource), kannst du sie in einen speziellen Ordner legen, den wir beim Start prüfen. Da du /opt/cfx-server/citizen/system_resources/ nicht direkt erreichen kannst, stellen wir dafür einen beschreibbaren Ablageort innerhalb deiner Serverdateien bereit.

Über den Dateimanager im Dashboard¶

Öffne im Dashboard den Dateimanager deines Servers.
Wechsle in /config/.
Erstelle dort einen Ordner namens .zaroz (achte auf den führenden Punkt).
Erstelle innerhalb von .zaroz einen Ordner mit dem Namen der Ressource, die du ersetzen möchtest — chat, monitor, webpack oder yarn.
Lade deine Ersatzressource dort hinein, zum Beispiel nach /config/.zaroz/chat/.

Per SFTP¶

Wenn du lieber per SFTP arbeitest, liegt derselbe Ordner unter /server/config/.zaroz/ auf deinem Server. Die Verbindungsdaten findest du im Tab Data Volume auf der Seite deines Servers:

SFTP-Bereich im Tab Data Volume

Übernimm die Connection URL direkt in deinen SFTP-Client oder nutze die einzelnen Felder Host, Port, Benutzername und Passwort darunter. Eine vollständige URL, die direkt auf den Override-Ordner zeigt — hier für die Chat-Ressource — sieht so aus:

sftp://zaroz@<host>:<port>/server/config/.zaroz/chat/

Endgültige Struktur¶

Jeder Ersatz kommt in seinen eigenen Ordner unter .zaroz/, exakt nach der Ressource benannt. Du kannst eine Ressource oder mehrere gleichzeitig ersetzen:

.zaroz/
├── chat/
│   ├── fxmanifest.lua
│   ├── client/
│   ├── server/
│   └── ...
└── webpack/
    └── ...

Beim nächsten Start ersetzt der Container den passenden Ordner unter /opt/cfx-server/citizen/system_resources/ durch einen Symlink, der auf deinen Ordner .zaroz/<ressource>/ zeigt. FiveM lädt dann deine Ressource so, als wäre sie die ursprüngliche System-Ressource, ohne dass du dafür server.cfg anpassen musst.

Der Ordnername muss dem Ressourcennamen entsprechen

Der Ordner innerhalb von .zaroz/ muss exakt chat, monitor, webpack oder yarn heißen. Das sind die Namen, die FiveM für seine System-Ressourcen erwartet. Ein Ordner mit einem anderen Namen wird ignoriert.

monitor zu ersetzen ersetzt txAdmin

Die Ressource monitor ist das txAdmin-Verwaltungspanel. Ersetze sie nur, wenn du ein angepasstes txAdmin ausliefern willst — ein leerer oder fehlerhafter monitor-Ordner lässt dich ohne Admin-Panel zurück.

Zurück zur Standardressource¶

Um eine Originalressource wiederherzustellen, lösche oder benenne ihren Ordner unter .zaroz/ einfach um und starte den Server neu. Der Container fällt dann wieder auf die mitgelieferte Version zurück.

Den Standard-Chat deaktivieren¶

Die Ressource chat hat eine zusätzliche Option, die die anderen nicht haben: Du kannst sie ganz entfernen, statt sie zu ersetzen.

Der FiveM-Einrichtungsassistent zeigt unter Systemressourcen einen Schalter namens Chat / Standard-FiveM-Chat aktivieren. Schalte ihn aus und bestätige.

FiveM-Systemressourcen-Dialog mit dem Schalter für den Standard-Chat

Wenn die Option deaktiviert ist, löscht der Container bei jedem Start /opt/cfx-server/citizen/system_resources/chat, bevor FiveM die Ressource überhaupt laden kann. Da das Image bei jedem Boot frisch aufgebaut wird, ist das sicher und reversibel.

Wann diese Option nutzen?

Wähle diese Option, wenn du einen Server ganz ohne Chat möchtest oder wenn du deine eigene Chat-Ressource als normales Addon unter resources/ ablegst und sie wie jede andere Ressource über server.cfg startest.

Du kannst diese Einstellung jederzeit auf der Konfigurationsseite deiner Bestellung umschalten. Die Änderung greift beim nächsten Serverstart.

Häufige Fragen¶

Welche Ressourcen kann ich ersetzen?

Vier System-Ressourcen: chat, monitor, webpack und yarn. Jede wird unabhängig mit einem eigenen Ordner unter .zaroz/ ersetzt.

Kann ich mehrere Ressourcen gleichzeitig ersetzen?

Ja. Lege pro Ressource einen Ordner unter .zaroz/ an. Jeder wird beim Start unabhängig verlinkt, und Ressourcen, für die du keinen Ordner bereitstellst, behalten ihre mitgelieferte Version.

Kann ich den Standard-Chat deaktivieren und gleichzeitig einen eigenen bereitstellen?

Ja. Wenn du den Standard-Chat deaktivierst und zusätzlich .zaroz/chat/ bereitstellst, gewinnt deine eigene Ressource: zuerst wird der Standard entfernt, anschließend wird dein Ordner verlinkt.

Überleben meine Overrides einen Plan-Wechsel oder einen Rebuild?

Ja. Alles innerhalb deiner Serverdateien (einschließlich .zaroz/) liegt auf einem persistenten Volume. CPU- oder RAM-Änderungen sowie ein Container-Rebuild löschen es nicht.