Les fichiers : File Manager et SFTP

Plugins, mods, cartes, fichiers de configuration, mondes : tout ce qui fait ton serveur est un fichier. Tu as deux façons d'y toucher. Le File Manager, dans le panel, pour lire, modifier ou déposer quelques fichiers. Le SFTP, avec un logiciel sur ton PC, pour en envoyer beaucoup d'un coup. Les deux montrent exactement le même dossier.

1. Ce que tu vois à la racine #

Ouvre File Manager. À la racine de ton instance, tu trouves deux sortes de choses.

Les dossiers et fichiers du jeu. Leur nom dépend du jeu : un dossier garrysmod/ pour Garry's Mod, server-data/ pour FiveM, un dossier au numéro Steam du jeu pour beaucoup d'autres (1948160/ pour Euro Truck Simulator 2). C'est là que tu travailleras.

Trois dossiers d'AMP, présents sur toutes les instances :

Tu verras parfois aussi des fichiers de l'outil de téléchargement de Steam (steamcmd.sh, linux32/, linux64/, package/…). Ils servent au bouton Update : n'y touche pas.

✅ À retenir Tu travailles dans le dossier du jeu. Les dossiers d'AMP et les fichiers de Steam, tu les laisses tranquilles.

2. Lire et modifier un fichier #

Dans le File Manager, clique sur un fichier texte (.cfg, .txt, .json, .yml, .properties, .ini, .lua…) : il s'ouvre dans l'éditeur intégré. Modifie, enregistre, et c'est écrit sur le serveur.

Trois précautions, toujours les mêmes :

1. Arrête le serveur avant de modifier un fichier que le jeu réécrit lui-même en s'arrêtant. Beaucoup de jeux enregistrent leurs réglages à l'arrêt : si tu modifies pendant qu'il tourne, il écrasera ta modification en s'éteignant.
2. Restart après la modification : un serveur lit sa configuration au démarrage, presque jamais en cours de route.
3. Garde une copie avant une grosse modification : télécharge le fichier, ou duplique-le avec un nom comme server.cfg.avant. Revenir en arrière prend alors dix secondes.

Rappel du chapitre 02 : si un réglage existe dans la page Configuration, c'est là qu'il faut le changer. AMP réécrit la ligne correspondante du fichier à chaque démarrage.

✅ À retenir Stop, modifier, enregistrer, Start. Et une copie avant les grosses modifications.

3. Déposer des fichiers depuis le panel #

Le File Manager sait aussi envoyer des fichiers depuis ton PC : place-toi dans le bon dossier, puis utilise l'envoi de fichiers du File Manager. Il sait également, sur un fichier ou un dossier, renommer, copier, supprimer, extraire une archive .zip et télécharger un fichier depuis une adresse web.

L'extraction est la bonne méthode pour un mod ou un plugin livré en .zip : envoie l'archive dans le bon dossier, extrais-la sur place, puis supprime le .zip.

Le piège classique, sur tous les jeux : le dossier dans le dossier. Beaucoup d'archives contiennent un dossier du même nom que l'archive. Après extraction, tu te retrouves avec plugins/MonPlugin/MonPlugin/… au lieu de plugins/MonPlugin/…, et le jeu ne trouve rien. Après chaque extraction, ouvre le dossier et vérifie que les fichiers du mod sont directement dedans.

✅ À retenir Un .zip s'envoie, s'extrait sur place, puis se supprime. Et on vérifie qu'il n'y a pas de dossier en trop.

4. Le SFTP, pour les gros envois #

Pour un dossier entier, des dizaines de fichiers ou plusieurs centaines de mégaoctets, le SFTP est plus fiable que le navigateur. Il reprend où il s'était arrêté si ta connexion coupe, et il envoie plusieurs fichiers à la fois.

1. Installe FileZilla ou WinSCP, gratuits tous les deux.
2. Récupère l'adresse et le port SFTP de ton instance sur Status → Connection Info. Le File Manager a aussi un bouton Connect to SFTP qui te les rappelle. Chaque instance a son propre port.
3. Crée une connexion avec :

Protocole     : SFTP  (pas FTP, pas FTPS)
Hôte          : l'adresse de Connection Info
Port          : le port SFTP de TON instance
Utilisateur   : ton identifiant AMP
Mot de passe  : ton mot de passe AMP

4. Connecte-toi. Tu arrives à la racine de ton instance, la même que dans le File Manager.

À la première connexion, ton logiciel te demande d'accepter la « clé » du serveur. C'est normal, accepte-la une fois.

✅ À retenir SFTP = l'adresse de Connection Info, le port SFTP de ton instance, et ton compte AMP.

5. La corbeille et l'espace disque #

Un fichier supprimé depuis le File Manager ne disparaît pas tout de suite : il part dans Trashed Files/. Pratique pour réparer une erreur, mais la corbeille reste sur ton disque.

Ton serveur a un espace disque limité (chapitre 07), et la corbeille compte dedans, tout comme les sauvegardes de LocalBackups/ et les .zip oubliés après extraction. Fais le ménage de temps en temps :

• vide Trashed Files/ une fois que tu es sûr de toi ;
• supprime les archives déjà extraites ;
• garde seulement les sauvegardes utiles (chapitre 05).

Un fichier supprimé par SFTP, lui, ne passe pas par la corbeille : il est effacé tout de suite.

✅ À retenir La corbeille, les sauvegardes et les .zip prennent de la place. Le SFTP, lui, supprime sans corbeille.

✅ Checklist du chapitre #

• Je sais distinguer le dossier du jeu des dossiers d'AMP
• J'ai ouvert et enregistré un fichier dans l'éditeur, serveur arrêté
• J'ai extrait une archive et vérifié qu'il n'y avait pas de dossier en trop
• Je me suis connecté en SFTP avec FileZilla ou WinSCP
• Je sais que la corbeille et les sauvegardes prennent de la place

❓ Si ça ne marche pas #

Ma modification disparaît après un redémarrage. Soit le jeu réécrit ce fichier à l'arrêt (modifie-le serveur arrêté), soit AMP le réécrit au démarrage (passe par la page Configuration).

Le mod que j'ai déposé n'est pas chargé. Vérifie le dossier dans le dossier (section 3), puis le bon emplacement pour ton jeu, puis la console : un mod qui ne charge pas le dit presque toujours.

FileZilla refuse la connexion. Vérifie le protocole (SFTP, pas FTP), le port (celui de ton instance, pas 21 ni 22) et l'identifiant (celui de la fenêtre 🔑 AMP).

L'envoi par le navigateur s'arrête en route. Le fichier est trop gros ou ta connexion a coupé. Passe par le SFTP.

J'ai supprimé un fichier par erreur. S'il a été supprimé depuis le File Manager, il est dans Trashed Files/. Sinon, restaure une sauvegarde (chapitre 05).