Remplacer une ressource intégrée de FiveM

L'image officielle de FiveM embarque plusieurs ressources système directement dans le chemin du binaire serveur (/opt/cfx-server/citizen/system_resources/). Ces dossiers font partie de l'image en lecture seule, pas du volume de données de ton serveur. Tu ne peux donc pas les modifier depuis le gestionnaire de fichiers ni par SFTP, et FiveM les charge automatiquement à chaque démarrage.

Zaroz Cloud te permet de remplacer chacune de ces quatre ressources système par ta propre version :

• chat — la boîte de chat en jeu
• monitor — le panneau de gestion txAdmin
• webpack — regroupe le JavaScript des ressources pendant l'étape de build
• yarn — installe les dépendances des ressources pendant l'étape de build

Pour cela, tu déposes un dossier de remplacement à un emplacement spécial dans les fichiers de ton serveur. Tout ce que tu y places vit dans le volume de données de ton serveur, donc cela survit aux redémarrages et aux reconstructions du conteneur.

La plupart des serveurs n'ont besoin que de chat

Remplacer chat est de loin le cas le plus courant. monitor, webpack et yarn sont réservés aux configurations avancées — laisse-les tranquilles à moins de savoir précisément que tu en as besoin.

Pour la ressource chat, il existe aussi une option pour la désactiver entièrement au lieu de la remplacer. Voir Désactiver le chat par défaut plus bas.

Remplacer une ressource par ton propre dossier

Si tu veux que ta version d'une ressource prenne la place de celle par défaut (même nom, même ordre de chargement, même priorité en tant que ressource système), tu peux la 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/, nous exposons à la place un emplacement 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 portant le nom de la ressource à remplacer — chat, monitor, webpack ou yarn.
5. Envoie ta ressource de remplacement dedans, par exemple dans /config/.zaroz/chat/.

Par SFTP

Si tu préfères travailler en SFTP, le même dossier se trouve à /server/config/.zaroz/ 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, ici pour la ressource de chat, ressemble à ceci :

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

Arborescence finale

Chaque remplacement va dans son propre dossier sous .zaroz/, nommé exactement comme la ressource. Tu peux remplacer une seule ressource ou plusieurs à la fois :

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

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

Le nom du dossier doit correspondre à celui de la ressource

Le dossier à l'intérieur de .zaroz/ doit s'appeler exactement chat, monitor, webpack ou yarn. Ce sont les noms que FiveM attend pour ses ressources système. Un dossier portant un autre nom est ignoré.

Remplacer monitor remplace txAdmin

La ressource monitor est le panneau de gestion txAdmin. Ne la remplace que si tu comptes livrer un txAdmin modifié — un dossier monitor vide ou cassé te laissera sans panneau d'administration.

Revenir à la ressource par défaut

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

Désactiver le chat par défaut

La ressource chat dispose d'une option supplémentaire que les autres n'ont pas : tu peux la supprimer entièrement au lieu de la remplacer.

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.

Questions fréquentes

Quelles ressources puis-je remplacer ?

Quatre ressources système : chat, monitor, webpack et yarn. Chacune se remplace indépendamment avec son propre dossier sous .zaroz/.

Puis-je remplacer plusieurs ressources à la fois ?

Oui. Ajoute un dossier par ressource sous .zaroz/. Chacun est lié indépendamment au démarrage, et les ressources pour lesquelles tu ne fournis pas de dossier conservent leur version fournie.

Puis-je désactiver le chat par défaut et fournir le mien 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.

Mes remplacements survivent-ils à 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.