Utiliser un chat personnalisé sur FiveM

L'image officielle de FiveM embarque sa ressource chat directement dans le chemin du binaire serveur (/opt/cfx-server/citizen/system_resources/chat). Ce dossier fait partie de l'image en lecture seule, pas du volume de données de ton serveur. Tu ne peux donc pas le modifier depuis le gestionnaire de fichiers ni par SFTP, et retirer ensure chat de server.cfg ne suffit pas non plus : FiveM charge automatiquement les ressources système.

Pour te redonner la main, Zaroz Cloud expose deux options :

1. Désactiver le chat intégré, pour que la ressource embarquée soit supprimée au démarrage, avant que FiveM ne la charge.
2. Remplacer le chat intégré par ton propre dossier, en le déposant à un emplacement spécial dans les fichiers de ton serveur.

Les deux options vivent dans le volume de données de ton serveur, donc elles survivent aux redémarrages et aux reconstructions du conteneur.

Option 1 : désactiver le chat par défaut

L'assistant de configuration FiveM affiche un interrupteur intitulé Chat / Activer le chat FiveM par défaut dans la section Ressources système. Désactive-le puis confirme.

Quand l'option est désactivée, le conteneur supprime /opt/cfx-server/citizen/system_resources/chat à chaque démarrage, avant que FiveM n'ait l'occasion de la charger. L'image étant reconstruite à neuf à chaque boot, l'opération est sûre et réversible.

Quand utiliser cette option ?

Choisis cette option si tu veux un serveur entièrement sans chat, ou si tu livres ta propre ressource de chat comme un addon normal sous resources/ et que tu la démarres depuis server.cfg comme n'importe quelle autre ressource.

Tu peux modifier ce réglage à tout moment depuis la page de configuration de ta commande. Le changement s'applique au prochain redémarrage du serveur.

Option 2 : déposer ton propre dossier de chat

Si tu veux que ton chat personnalisé prenne la place de celui par défaut (même nom, même ordre de chargement, même priorité en tant que ressource système), tu peux le placer dans un dossier spécial que nous repérons au démarrage. Comme tu ne peux pas accéder directement à /opt/cfx-server/citizen/system_resources/chat, nous exposons à la place un point de montage modifiable à l'intérieur des fichiers de ton serveur.

Depuis le gestionnaire de fichiers du tableau de bord

1. Ouvre le Gestionnaire de fichiers de ton serveur depuis le tableau de bord.
2. Va dans /.config/.
3. À l'intérieur, crée un dossier nommé .zaroz (attention au point initial).
4. À l'intérieur de .zaroz, crée un dossier nommé chat.
5. Envoie ta ressource de chat personnalisée dans /.config/.zaroz/chat/.

Par SFTP

Si tu préfères travailler en SFTP, le même dossier se trouve à /server/config/.zaroz/chat/ sur ton serveur. Les informations de connexion sont dans l'onglet Volume de données de la page de ton serveur :

Copie directement la Connection URL dans ton client SFTP, ou utilise les champs hôte, port, nom d'utilisateur et mot de passe affichés juste en dessous. Une URL complète pointant vers le dossier de remplacement ressemble à ceci :

sftp://zaroz@<hôte>:<port>/server/config/.zaroz/chat/

Arborescence finale

Quel que soit le mode d'envoi, la ressource doit aboutir à ceci :

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

Au prochain démarrage, le conteneur remplace /opt/cfx-server/citizen/system_resources/chat par un lien symbolique pointant vers ton dossier .zaroz/chat/. FiveM charge alors ta ressource comme s'il s'agissait de la ressource système d'origine, sans avoir à modifier server.cfg.

Garde le nom de la ressource chat

Le dossier à l'intérieur de .zaroz/ doit s'appeler exactement chat. C'est le nom de ressource que FiveM attend quand ensure chat est appelé dans server.cfg. Si tu le renommes, la substitution ne fonctionnera pas.

Revenir au chat par défaut

Pour restaurer la ressource d'origine, il suffit de supprimer (ou de renommer) le dossier .zaroz/chat puis de redémarrer le serveur. Le conteneur réutilisera alors le chat fourni.

Questions fréquentes

Puis-je utiliser les deux options en même temps ?

Oui. Si tu désactives le chat par défaut et que tu fournis aussi .zaroz/chat/, ta ressource personnalisée l'emporte : le chat par défaut est supprimé en premier, puis ton dossier est lié à la place.

Mon chat personnalisé survit-il à un changement de plan ou à une reconstruction ?

Oui. Tout ce qui se trouve dans les fichiers de ton serveur (y compris .zaroz/) est stocké sur un volume persistant. Modifier le CPU ou la RAM, ou reconstruire le conteneur, ne le supprime pas.

Le même dossier .zaroz/ fonctionne-t-il pour d'autres ressources ?

Pour l'instant, .zaroz/chat est le seul emplacement de substitution. Si tu souhaites remplacer d'autres ressources intégrées de la même manière, dis-le nous sur Discord.