Qu'est-ce que FastDL (téléchargement rapide) sur GMod et comment l'installer ?
FastDL (Fast Download, téléchargement rapide) est la méthode qui permet aux joueurs de télécharger en HTTP, depuis un serveur web distinct, les fichiers de modèles, de textures (matériaux), de sons et de maps propres à votre serveur Garry's Mod (GMod). Lorsqu'un joueur se connecte au serveur, il récupère les fichiers manquants non pas depuis le serveur de jeu, mais depuis l'adresse que vous indiquez avec sv_downloadurl. Ce guide s'adresse aux administrateurs de serveur qui doivent distribuer une partie de leur contenu en dehors du Workshop (Atelier) ; les autres sujets se trouvent sur la page Guides Garry's Mod.
Avant de commencer
- Un serveur GMod fonctionnel : l'installation de SteamCMD, la commande de lancement et
server.cfgdoivent être prêts. Sinon, suivez d'abord le guide Installer un serveur Garry's Mod de zéro. Les chemins ci-dessous reprennent les dossiers de ce guide :C:\GModServersous Windows,/home/steam/gmodsous Linux. - Un serveur web : il peut tourner sur le même VDS que le serveur de jeu. Ce guide utilise nginx sous Linux (Ubuntu) et IIS (Internet Information Services) sous Windows Server. Pour une autre option comme Apache, consultez le guide Installer et gérer les serveurs web Nginx et Apache sur un VDS.
- Accès administrateur : SSH avec un compte disposant des droits sudo sous Linux, RDP (Bureau à distance) avec le compte Administrator sous Windows. Si la connexion échoue, la console VNC de l'Espace client affiche l'écran du serveur dans votre navigateur.
- Droit de distribution : vous devez détenir le droit de distribuer les modèles, textures et sons que vous envoyez aux joueurs.
Avant de commencer l'installation, déterminez quelle méthode vous convient. La page Serving Content de Facepunch décrit trois façons d'envoyer du contenu :
| Méthode | Origine des fichiers | Point fort | Point faible |
|---|---|---|---|
Workshop (resource.AddWorkshop) | Steam Workshop | La voie la plus rapide selon Facepunch ; l'addon se télécharge en un seul paquet (.gma) | Le contenu doit être publié sur le Workshop |
FastDL (sv_downloadurl) | Votre serveur web, fichier par fichier | Distribue aussi les fichiers non publiés sur le Workshop | Le contenu des fichiers n'est pas vérifié ; un fichier mis à jour sous le même nom n'est pas retéléchargé |
Téléchargement depuis le serveur (sv_allowdownload 1) | Le serveur de jeu lui-même | Aucun serveur web nécessaire | Environ 64 kb/s ; Facepunch le considère comme obsolète et exploitable |
Si votre contenu est sur le Workshop, FastDL n'est pas nécessaire ; utilisez la méthode décrite dans le guide Addons Workshop pour GMod, à savoir resource.AddWorkshop. FastDL sert aux fichiers que vous ne pouvez pas ou ne voulez pas publier sur le Workshop (logo du serveur, sons personnalisés, modèles d'un addon de type dossier, etc.).
1. Rassembler le contenu et déterminer le chemin virtuel
L'erreur la plus fréquente avec FastDL concerne la structure des dossiers. Le joueur demande un fichier par son chemin virtuel (virtual path), relatif au dossier garrysmod ; la structure des dossiers sur le serveur web doit correspondre exactement à ce chemin. D'après la page resource.AddFile de Facepunch, les dossiers addons/<addon>/ et gamemodes/<gamemode>/content/ sont montés à la racine (mount) ; ces préfixes ne font pas partie du chemin virtuel :
| Fichier sur le serveur de jeu | Chemin virtuel | Fichier sur le serveur web |
|---|---|---|
garrysmod/maps/gm_examplemap.bsp | maps/gm_examplemap.bsp | fastdl/maps/gm_examplemap.bsp.bz2 |
garrysmod/addons/server_content/materials/myserver/logo.vmt | materials/myserver/logo.vmt | fastdl/materials/myserver/logo.vmt.bz2 |
garrysmod/gamemodes/examplemode/content/sound/myserver/intro.wav | sound/myserver/intro.wav | fastdl/sound/myserver/intro.wav.bz2 |
Regroupez le contenu propre au serveur dans un seul addon de type dossier, par exemple dans garrysmod/addons/server_content/, avec les dossiers materials, models et sound. Respectez trois règles :
- Le dossier des sons s'appelle
sound, et nonsounds. - Écrivez les noms de fichiers et de dossiers en minuscules. Sous Linux, les chemins de fichiers sont sensibles à la casse ; d'après la documentation FastDL de Valve, un fichier dont la casse du nom ne correspond pas n'est pas téléchargé en HTTP.
- Ne placez pas les fichiers Lua sur le serveur web. D'après Facepunch, les fichiers Lua ne sont pas considérés comme du contenu et sont envoyés aux joueurs par une autre voie, sans réglage supplémentaire. Exposer sur le web les dossiers
cfg,dataouluarend accessibles à tous des informations secrètes comme, dansserver.cfg, la valeurrcon_passwordou le mot de passe de la base de données dans le code Lua côté serveur.
2. Installer le serveur web et créer le dossier FastDL
Linux (Ubuntu, nginx) :
sudo apt update
sudo apt install nginx
sudo mkdir -p /var/www/html/fastdl
sudo ufw allow 80/tcp
Sous Ubuntu, le site par défaut de nginx sert le dossier /var/www/html ; votre adresse FastDL est donc http://SERVER_IP/fastdl/. Ne placez pas le dossier sous /home/steam : nginx s'exécute avec un utilisateur distinct et peut ne pas pouvoir lire le dossier personnel des autres utilisateurs, ce qui provoque une erreur 403 Forbidden. Ne faites pas non plus pointer le dossier racine du site (root) vers le dossier du serveur de jeu ; sinon, les fichiers cfg et lua seraient eux aussi publiés. Si vous n'utilisez pas ufw, ouvrez le port 80/TCP dans votre propre pare-feu.
Windows Server (IIS) : exécutez ces commandes dans PowerShell ouvert en tant qu'administrateur :
Install-WindowsFeature -Name Web-Server -IncludeManagementTools
New-Item -ItemType Directory -Path C:\inetpub\wwwroot\fastdl
New-NetFirewallRule -DisplayName "FastDL HTTP 80" -Direction Inbound -Protocol TCP -LocalPort 80 -Action Allow
Le site par défaut d'IIS (« Default Web Site ») sert le dossier C:\inetpub\wwwroot. Si une règle d'autorisation existe déjà pour le port 80 dans le pare-feu, la dernière ligne est inutile. Le pare-feu fait partie du système d'exploitation et relève de votre gestion ; pour les ports de jeu, consultez le guide Ouverture des ports et pare-feu pour GMod.
3. Copier les fichiers dans le dossier web
Ne copiez que les dossiers de contenu dans le dossier web ; le nom du dossier de l'addon ne fait pas partie du chemin côté web.
Linux :
K=/home/steam/gmod/garrysmod/addons/server_content
sudo cp -r "$K/materials" "$K/models" "$K/sound" /var/www/html/fastdl/
sudo mkdir -p /var/www/html/fastdl/maps
sudo cp /home/steam/gmod/garrysmod/maps/gm_examplemap.bsp /var/www/html/fastdl/maps/
Retirez de la commande les dossiers qui n'existent pas dans votre addon ; un dossier inexistant provoque une erreur.
Windows (« Command Prompt » ou PowerShell) :
robocopy C:\GModServer\garrysmod\addons\server_content\materials C:\inetpub\wwwroot\fastdl\materials /S
robocopy C:\GModServer\garrysmod\addons\server_content\models C:\inetpub\wwwroot\fastdl\models /S
robocopy C:\GModServer\garrysmod\addons\server_content\sound C:\inetpub\wwwroot\fastdl\sound /S
robocopy C:\GModServer\garrysmod\maps C:\inetpub\wwwroot\fastdl\maps gm_examplemap.bsp
/S copie aussi les sous-dossiers non vides. La dernière ligne ne copie que le fichier de map indiqué.
4. Compresser les fichiers avec bzip2
D'après Facepunch, le joueur demande d'abord la version de chaque fichier compressée en .bz2, et s'il ne la trouve pas, il essaie le fichier non compressé. Valve recommande aussi la compression bzip2 pour accélérer les téléchargements et gagner de la place sur le serveur web. Le nom du fichier compressé s'obtient en ajoutant .bz2 à la fin du nom d'origine : le fichier logo.vmt devient logo.vmt.bz2. Effectuez la compression sur les copies du dossier web ; ne touchez pas aux fichiers d'origine du serveur de jeu.
Linux :
sudo find /var/www/html/fastdl -type f ! -name '*.bz2' -exec bzip2 -f {} +
sudo chmod -R a+rX /var/www/html/fastdl
La première commande compresse chaque fichier dont le nom ne se termine pas par .bz2 et remplace l'original par sa version compressée ; -f écrase un éventuel ancien fichier .bz2, et si vous ajoutez -k, le fichier d'origine est conservé. La seconde commande donne aux fichiers le droit de lecture et aux dossiers le droit de traversée, pour que le serveur web puisse les lire.
Windows : Windows ne fournit pas d'outil bzip2 ; installez 7-Zip, gratuit et open source. Pour un seul fichier, faites un clic droit dessus dans le « File Explorer » (Explorateur de fichiers) et, dans la fenêtre d'ajout à l'archive du menu 7-Zip, choisissez bzip2 comme format d'archive. Pour tout le dossier, dans PowerShell :
$7z = "C:\Program Files\7-Zip\7z.exe"
Get-ChildItem C:\inetpub\wwwroot\fastdl -Recurse -File |
Where-Object { $_.Extension -ne ".bz2" -and $_.Name -ne "web.config" } |
ForEach-Object { & $7z a -tbzip2 "$($_.FullName).bz2" $_.FullName -sdel }
-tbzip2 définit le type d'archive sur bzip2 ; ce format n'accepte qu'un fichier par archive. -sdel supprime le fichier d'origine une fois la compression terminée avec succès. Si vous avez installé 7-Zip dans un autre dossier, corrigez le chemin de la première ligne. Si vous mettez à jour un fichier et le recompressez, supprimez d'abord l'ancien fichier .bz2.
5. Vérifier que le serveur web sert les fichiers
Le serveur web associe à chaque fichier un type MIME (MIME type, déclaration du type de fichier). Il n'est pas documenté si le jeu tient compte de ce type, mais certains serveurs web ne servent pas du tout les extensions qu'ils ne connaissent pas.
IIS : d'après la documentation de Microsoft, IIS ne sert pas les types de fichiers pour lesquels aucun mappage MIME n'est défini ; le joueur reçoit une erreur 404 et le journal d'IIS indique 404.3. Créez le fichier C:\inetpub\wwwroot\fastdl\web.config et écrivez-y ce qui suit :
<?xml version="1.0" encoding="UTF-8"?>
<configuration>
<system.webServer>
<staticContent>
<remove fileExtension=".bz2" />
<mimeMap fileExtension=".bz2" mimeType="application/octet-stream" />
</staticContent>
</system.webServer>
</configuration>
La ligne remove évite le conflit (500.19) qui se produirait si un mappage existait déjà pour la même extension à un niveau supérieur. Si vous laissez aussi des fichiers non compressés (.bsp, .vmt, .vtf, .mdl, .vvd, .vtx, .phy, etc.), ajoutez les deux mêmes lignes pour chaque extension. Dans le « Notepad » (Bloc-notes), choisissez comme type d'enregistrement All Files (Tous les fichiers) ; sinon, le fichier sera enregistré sous le nom web.config.txt.
nginx : dans la configuration par défaut de nginx, la ligne default_type application/octet-stream; sert avec ce type les extensions qu'il ne reconnaît pas (.bz2, .vmt, .mdl, etc.) ; aucun réglage supplémentaire n'est nécessaire. Vous pouvez vérifier que la ligne est bien présente avec grep default_type /etc/nginx/nginx.conf. La liste des répertoires est désactivée par défaut dans nginx (autoindex) et dans IIS (« Directory Browsing ») ; ne l'activez pas, sinon la liste de tous les fichiers du dossier sera visible par tous.
Ouvrez ensuite dans le navigateur de votre propre ordinateur une adresse comme http://SERVER_IP/fastdl/materials/myserver/logo.vmt.bz2 ; le fichier doit se télécharger. Sous Linux, vous pouvez aussi tester depuis le serveur lui-même :
curl -I http://127.0.0.1/fastdl/materials/myserver/logo.vmt.bz2
La première ligne de la réponse doit afficher 200 OK. 404 indique une erreur de chemin ou de casse, 403 un problème de droits.
6. Déclarer les fichiers avec resource.AddFile
Le serveur de jeu doit indiquer aux joueurs quels fichiers télécharger. Vous le faites avec un fichier Lua exécuté côté serveur : C:\GModServer\garrysmod\lua\autorun\server\fastdl.lua sous Windows, /home/steam/gmod/garrysmod/lua/autorun/server/fastdl.lua sous Linux. Créez le dossier s'il n'existe pas ; sous Linux, créez le fichier avec l'utilisateur steam.
-- Fichiers envoyés aux joueurs via FastDL (chemins relatifs au dossier garrysmod/)
resource.AddFile("materials/myserver/logo.vmt") -- le logo.vtf du même nom est aussi ajouté
resource.AddFile("models/myserver/sign.mdl") -- les fichiers .vvd, .phy et .vtx sont aussi ajoutés
resource.AddFile("materials/models/myserver/sign.vmt") -- la texture du modèle est ajoutée séparément
resource.AddSingleFile("sound/myserver/intro.wav")
D'après Facepunch, la différence entre les deux fonctions est la suivante :
resource.AddFileajoute le fichier avec ses fichiers associés : pour un.vmt, le.vtfdu même nom ; pour un.mdl, les fichiers.vvd,.ani,.dx80.vtx,.dx90.vtxet.phydu même nom. Elle écrit une erreur distincte pour chaque fichier associé introuvable. Cette liste ne comprend pas les textures du modèle ; ajoutez-les séparément.resource.AddSingleFilen'ajoute que le fichier indiqué. Si certains fichiers associés manquent à votre modèle, ajoutez un par un ceux qui existent avec cette fonction.
Les chemins ne comportent ni l'extension .bz2 ni le préfixe addons/<addon>/. Si le fichier n'existe pas sur le serveur de jeu, il n'est pas envoyé aux joueurs. Toutes les fonctions resource.Add* partagent une limite de 8192 fichiers téléchargeables. Au lieu d'écrire un par un tous les sons d'un dossier, vous pouvez faire une boucle avec file.Find :
local folder = "sound/myserver/"
local files = file.Find(folder .. "*", "GAME")
for _, name in ipairs(files or {}) do
resource.AddSingleFile(folder .. name)
end
Le chemin de recherche "GAME" parcourt tout le contenu monté, addons compris, selon la structure de garrysmod/. Facepunch indique que les chemins contenant des majuscules peuvent ne pas fonctionner comme prévu sous Linux ; écrivez les noms de dossiers en minuscules. N'ajoutez pas les fichiers Lua à cette liste. Sous Windows, le « Notepad » peut enregistrer le fichier sous le nom fastdl.lua.txt ; là encore, choisissez comme type d'enregistrement All Files.
7. Configurer sv_downloadurl et sv_allowdownload
Ajoutez ces lignes au fichier garrysmod/cfg/server.cfg. Valve recommande également le fichier server.cfg pour ces variables :
// Adresse FastDL : entre guillemets, terminée par /
sv_downloadurl "http://203.0.113.10/fastdl/"
// Désactiver le téléchargement direct (lent) depuis le serveur de jeu
sv_allowdownload 0
203.0.113.10 est une adresse d'exemple ; remplacez-la par l'adresse IP de votre serveur ou par votre nom de domaine. La documentation FastDL de Valve demande d'écrire l'adresse entre guillemets et avec le / final ; l'adresse peut compter au maximum 127 caractères. L'exemple de Facepunch n'a pas de / final, mais suivez le format de Valve. Écrivez l'adresse sous la forme finale que vous avez testée dans le navigateur ; il n'est pas documenté si le client du jeu suit les redirections (redirect).
Les sources divergent au sujet de sv_allowdownload. La page générale sv_downloadurl que Valve a rédigée pour tous les jeux Source indique de régler cette valeur sur 1 ; dans GMod, la valeur par défaut est également 1. La documentation de Facepunch propre à Garry's Mod, en revanche, ne demande pour FastDL que sv_downloadurl et resource.Add* ; elle rattache le réglage sv_allowdownload 1 à l'ancienne méthode ServerDL, jugée obsolète, et le considère comme exploitable, car des clients modifiés peuvent ralentir le serveur en demandant des fichiers en rafale. Facepunch ne dit pas explicitement « réglez-le sur 0 » ; la recommandation de 0 est déduite de ces deux informations. D'après Valve, pour un fichier absent de FastDL ou dont la casse du nom ne correspond pas, le joueur bascule vers le téléchargement lent depuis le serveur de jeu ; avec 0, cette voie est fermée et les fichiers manquants apparaissent immédiatement lors du test. Si le test de l'étape 8 réussit avec ce réglage, FastDL fonctionne à lui seul. Redémarrez le serveur et vérifiez la valeur en tapant sv_downloadurl dans la console.
8. Tester depuis le jeu
Les fichiers que vous testez ne doivent pas se trouver sur votre propre ordinateur. Les fichiers téléchargés sont écrits sur l'ordinateur du joueur dans le dossier garrysmod/download/ ; si vous les avez déjà téléchargés, supprimez-les de cet endroit. Ouvrez la console du jeu et connectez-vous avec les commandes de débogage recommandées par Valve :
developer 1
download_debug 1
connect 203.0.113.10:27015
Dans la console, les lignes en rouge commençant par Error Downloading indiquent les fichiers qui n'ont pas pu être téléchargés ; corrigez le chemin et la casse d'après ces lignes. Après le test, rétablissez les réglages avec developer 0 et download_debug 0. Dans leurs paramètres de téléchargement (cl_downloadfilter : all, none, nosounds, mapsonly, noworkshop), les joueurs peuvent choisir les fichiers qu'ils reçoivent ; un joueur qui choisit none, nosounds ou mapsonly ne télécharge pas tout ou partie des fichiers FastDL.
Exemple de configuration
| Réglage / fichier | Emplacement | Rôle | Exemple |
|---|---|---|---|
sv_downloadurl | cfg/server.cfg | Adresse FastDL ; entre guillemets, terminée par /, 127 caractères au maximum | sv_downloadurl "http://203.0.113.10/fastdl/" |
sv_allowdownload | cfg/server.cfg | Téléchargement direct depuis le serveur de jeu ; à garder désactivé dans GMod | sv_allowdownload 0 |
resource.AddFile | lua/autorun/server/fastdl.lua | Ajoute le fichier et ses fichiers associés à la liste de téléchargement | resource.AddFile("materials/myserver/logo.vmt") |
resource.AddSingleFile | lua/autorun/server/fastdl.lua | N'ajoute que le fichier indiqué | resource.AddSingleFile("sound/myserver/intro.wav") |
| Dossier FastDL | nginx / IIS | Fichiers compressés, selon la structure du chemin virtuel | /var/www/html/fastdl, C:\inetpub\wwwroot\fastdl |
web.config | Dossier FastDL d'IIS | Mappage MIME pour .bz2 | <mimeMap fileExtension=".bz2" mimeType="application/octet-stream" /> |
download_debug | Console du joueur | Affiche les erreurs de téléchargement | download_debug 1 |
Erreurs fréquentes
- Le téléchargement est toujours lent ou FastDL n'est pas utilisé du tout :
sv_downloadurln'a pas été défini, a été écrit dans un autre fichier, ou le serveur n'a pas été redémarré. Tapezsv_downloadurldans la console du serveur et vérifiez la valeur. - Dans la console,
Error Downloading, erreur 404 dans le navigateur : le chemin côté web ne correspond pas au chemin virtuel. En général, le préfixeaddons/<addon>/a été copié, le dossier a été nommésoundsou la casse diffère. Corrigez le chemin d'après le tableau de l'étape 1. - Erreur 404 (404.3 dans le journal) ou 500.19 sur IIS : 404.3 indique que l'extension n'a pas de mappage MIME ; placez le fichier
web.configde l'étape 5 dans le dossier FastDL. 500.19 indique queweb.configcontient une faute de frappe ou une extension définie deux fois ; vérifiez les balises et les lignesremove. - 403 Forbidden sous nginx : le serveur web ne parvient pas à lire le fichier. Exécutez la commande
sudo chmod -R a+rX /var/www/html/fastdl; si vous avez placé le dossier sous/home, déplacez-le sous/var/www/html. - Les fichiers se téléchargent, mais les joueurs voient un modèle ERROR ou une texture violette et noire : les textures du modèle (
.vmtet.vtf) n'ont pas été ajoutées à la liste, ou le réglagecl_downloadfilterdu joueur bloque le téléchargement. Ajoutez les textures avecresource.AddFileet demandez au joueur de vérifier son réglage. - Le fichier mis à jour ne parvient pas aux joueurs : FastDL ne vérifie pas le contenu des fichiers ; d'après Valve, le fichier du même nom déjà présent chez le joueur n'est pas écrasé. Donnez un nouveau nom au fichier (par ex.
logo_v2.vmt), mettez à jour les endroits qui y font référence et ajoutez le nouveau fichier à la liste et au dossier web. - Erreurs
resource.AddFiledans la console du serveur : le fichier n'existe pas à ce chemin virtuel sur le serveur de jeu, ou un fichier associé (par ex..dx80.vtx) est manquant. Corrigez le chemin ou ajoutez un par un les fichiers existants avecresource.AddSingleFile. - L'adresse web n'est pas accessible depuis l'extérieur : le port 80/TCP est fermé dans le pare-feu ou le serveur web ne fonctionne pas. Ajoutez la règle ; sous Linux, redémarrez le service avec
sudo systemctl restart nginx. Si le réglage du pare-feu coupe aussi votre connexion SSH ou RDP, connectez-vous via la console VNC de l'Espace client pour le corriger.
Questions fréquentes
Dois-je utiliser FastDL ou le Workshop ?
Si le contenu est sur le Workshop ou si vous pouvez l'y publier, choisissez le Workshop ; Facepunch le présente comme la méthode la plus rapide, et la page resource.AddFile recommande, pour un grand nombre de fichiers, resource.AddWorkshop. Les deux fonctionnent aussi ensemble : les gros paquets se téléchargent depuis le Workshop, et les quelques fichiers spécifiques que vous ne pouvez pas y publier, depuis FastDL.
Le serveur web doit-il être sur le même VDS que le serveur de jeu ?
Ce n'est pas nécessaire ; sv_downloadurl peut pointer vers n'importe quelle adresse HTTP. Sur le même VDS, le trafic de téléchargement partage la même ligne réseau et le même processeur que le trafic de jeu ; surveillez l'utilisation du réseau et du CPU dans les graphiques d'utilisation en direct de l'Espace client. Si les ressources ne suffisent pas, vous pouvez consulter les offres de la page Location de serveur Garry's Mod.
Puis-je utiliser une adresse HTTPS ?
Oui ; l'exemple de Facepunch utilise une adresse commençant par https://. Il vous faut pour cela un nom de domaine pointant vers votre serveur et un certificat valide ; consultez le guide Installer un certificat SSL. D'après Valve, dans certains environnements d'hébergement web, seul l'un des deux fonctionne correctement ; si l'un pose problème, essayez l'autre.
Comment distribuer des maps avec FastDL ?
Placez le fichier .bsp de la map dans le dossier maps/ du dossier web et compressez-le, comme aux étapes 3 et 4 ; d'après l'exemple de Valve, un joueur qui ne possède pas la map la télécharge depuis cet emplacement lors de sa connexion. Ajoutez avec resource.AddFile les textures et modèles qui ne sont pas intégrés à la map. Pour installer la map sur le serveur et pour les maps du Workshop, consultez le guide Installer une map personnalisée sur GMod.
Guides associés
- Comment installer un serveur Garry's Mod ? Guide SteamCMD et srcds
- Comment ajouter des addons Workshop (Atelier) à un serveur GMod ?
- Installer une map personnalisée (custom map) sur un serveur GMod
- Serveur GMod : ouvrir les ports et configurer le pare-feu
- Installer et gérer les serveurs web Nginx et Apache sur un VDS
Commentaires0
Pas encore de commentaire
Soyez le premier à partager votre avis.
Veuillez vous connecter ou vous inscrire pour laisser un commentaire.