Eigene Chat-Ressource auf FiveM verwenden

Das offizielle FiveM-Image bringt seine chat-Ressource fest verankert im Server-Binärpfad mit (/opt/cfx-server/citizen/system_resources/chat). Dieser Ordner gehört zum schreibgeschützten Image, nicht zum Daten-Volume deines Servers. Du kannst ihn also weder über den Dateimanager noch per SFTP bearbeiten, und das bloße Entfernen von ensure chat aus der server.cfg reicht ebenfalls nicht aus: FiveM lädt System-Ressourcen automatisch.

Damit du trotzdem die Kontrolle behältst, bietet Zaroz Cloud zwei Optionen:

1. Den eingebauten Chat deaktivieren, sodass die mitgelieferte Ressource beim Start entfernt wird, bevor FiveM sie laden kann.
2. Den eingebauten Chat ersetzen durch deinen eigenen Ordner, indem du ihn an einer speziellen Stelle in deinen Serverdateien ablegst.

Beide Optionen liegen im Daten-Volume deines Servers und überleben somit Neustarts und Container-Rebuilds.

Option 1: den Standard-Chat deaktivieren

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

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.

Option 2: deinen eigenen Chat-Ordner ablegen

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

Über den Dateimanager im Dashboard

1. Öffne im Dashboard den Dateimanager deines Servers.
2. Wechsle in /.config/.
3. Erstelle dort einen Ordner namens .zaroz (achte auf den führenden Punkt).
4. Erstelle innerhalb von .zaroz einen Ordner namens chat.
5. Lade deine eigene Chat-Ressource nach /.config/.zaroz/chat/ hoch.

Per SFTP

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

Ü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, sieht so aus:

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

Endgültige Struktur

Egal wie du sie hochlädst, die Ressource muss am Ende so aussehen:

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

Beim nächsten Start ersetzt der Container /opt/cfx-server/citizen/system_resources/chat durch einen Symlink, der auf deinen Ordner .zaroz/chat/ 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.

Behalte den Ressourcennamen chat bei

Der Ordner innerhalb von .zaroz/ muss exakt chat heißen. Das ist der Ressourcenname, den FiveM erwartet, wenn ensure chat in der server.cfg aufgerufen wird. Benennst du den Ordner um, greift die Ersetzung nicht.

Zurück zum Standard-Chat

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

Häufige Fragen

Kann ich beide Optionen gleichzeitig nutzen?

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.

Überlebt mein eigener Chat 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.

Funktioniert derselbe .zaroz/-Ordner auch für andere Ressourcen?

Aktuell ist .zaroz/chat der einzige Override-Slot. Wenn du andere eingebaute Ressourcen auf die gleiche Weise ersetzen möchtest, schreib uns auf Discord.