SFTP (SSH File Transfer Protocol) est un protocole réseau chiffré qui permet de transférer des fichiers via une connexion SSH. Il te permet d’échanger des fichiers en toute sécurité entre ton PC et ton serveur de jeu. Avec SFTP, tu peux accéder aux fichiers de ton serveur et les gérer, que tu veuilles télécharger des fichiers vers le serveur, les récupérer ou les modifier directement.
Les serveurs de jeu ZapX sont accessibles exclusivement via SFTP. Le FTP classique non chiffré n’est pas pris en charge.
Pour accéder à ton serveur via SFTP, tu as besoin d’un client SFTP adapté. Il en existe un grand nombre, mais deux des plus connus et établis sont FileZilla et WinSCP.
| Client SFTP | Téléchargement |
|---|---|
| FileZilla | Site officiel |
| WinSCP | Site officiel |
Avec FiveM, tu utilises surtout le SFTP pour tes ressources, le server.cfg et les données de txAdmin. La connexion et les identifiants fonctionnent exactement comme décrit plus haut. Même si l’on parle souvent de « FiveM FTP » : chez ZapX, tu te connectes toujours via SFTP.
Une fois connecté, les fichiers FiveM se trouvent dans le dossier fivem, puis dans le dossier de ta variante, par exemple fivem/standard. Tu y trouves :
| Dossier / fichier | Contenu |
|---|---|
<Nom>_<Code>.base (p. ex. Qbox_E99E54.base) | Le dossier du serveur que txAdmin crée lors de la configuration avec une recette (recipe). Il contient le server.cfg et le dossier resources. |
default | Le profil txAdmin avec les paramètres (config.json), les données et les logs |
admins.json | Les comptes administrateur de txAdmin |
server-data | Un autre dossier de serveur avec son propre server.cfg et son propre dossier resources |
artifacts | Les fichiers serveur de FiveM (FXServer). Tu n’as rien à modifier ici. |
Chez ZapX, il n’y a pas de dossier txData séparé. Les données de txAdmin se trouvent directement dans ce dossier de variante.
Pour savoir quel dossier de serveur est actif, ouvre txAdmin et va dans Settings → FXServer, champ Server Data Folder. Les modifications d’un server.cfg situé dans un autre dossier n’ont aucun effet.
- Décompresse la ressource téléchargée sur ton PC. Le fichier
fxmanifest.lua(__resource.luapour les anciennes ressources) doit se trouver directement dans le dossier de la ressource. - Arrête ton serveur.
- Envoie le dossier via SFTP dans le dossier
resourcesde ton dossier de serveur actif. - Ajoute la ressource au
server.cfgavecstart <nomdudossier>et démarre le serveur.
Tu trouveras plus de détails dans le guide FiveM : installation de ressources.
- Arrête le serveur avant de modifier le
server.cfg, des fichiers du dossierdefaultou leadmins.json. Le serveur et txAdmin écrivent dans ces fichiers, des modifications faites serveur en marche peuvent donc être écrasées. - Télécharge d’abord une copie du fichier pour pouvoir revenir en arrière en cas d’erreur.
- Tu peux aussi faire les petites modifications du
server.cfgdirectement dans le CFG Editor de txAdmin.
Avec FiveM, c’est surtout le dossier cache du dossier serveur (<Nom>_<Code>.base/cache) qui grossit. Tu peux le supprimer serveur arrêté, FiveM le recrée au prochain démarrage. Tu peux aussi supprimer les anciens fichiers de log dans default/logs. Ne touche pas au dossier artifacts ni aux autres fichiers de txAdmin.
Vérifie que le nom du dossier correspond exactement au nom utilisé dans la commande start (attention aux majuscules et minuscules) et que le fxmanifest.lua se trouve directement dans le dossier et non dans un sous-dossier. Tu trouveras d’autres problèmes dans FiveM : problèmes fréquents.
