Installer des mods Workshop et cartes custom sur un serveur Unturned
Sur Unturned, tous les mods passent par le Steam Workshop : cartes, véhicules, armes, vêtements… Bonne nouvelle, l’installation côté serveur tient en un seul fichier : WorkshopDownloadConfig.json. Le serveur télécharge les mods au démarrage, et les joueurs les récupèrent automatiquement en se connectant.
Méthode vérifiée sur la documentation officielle Unturned.
Serveur moddé avec gros packs Workshop ? L’offre Unturned Pro HebergTonServ (9,90 €/mois, 8 Go RAM, 25 Go NVMe) est dimensionnée pour 24 joueurs avec mods et plugins RP.
Où se trouve WorkshopDownloadConfig.json ?
Dans le dossier de votre serveur :
U3DS/
└── Servers/
└── <ServerID>/
├── Config.txt
├── WorkshopDownloadConfig.json ← ici
└── Server/
└── Commands.datLe fichier est généré au premier lancement du serveur. Chez HebergTonServ, il est accessible depuis le gestionnaire de fichiers du panel.
Étape 1 — Récupérer le File ID d’un mod
- Ouvrez la page du mod sur le Workshop Unturned
- Copiez le nombre après
?id=dans l’URL
Exemple avec la carte Hawaii :
URL : https://steamcommunity.com/sharedfiles/filedetails/?id=1753134636
File ID : 1753134636Étape 2 — Ajouter les IDs dans File_IDs
Serveur arrêté, éditez WorkshopDownloadConfig.json et ajoutez vos IDs dans la liste File_IDs, séparés par des virgules :
"File_IDs":
[
1753134636,
1702240229
],⚠️ Pas de virgule après le dernier ID de la liste, sinon le JSON est invalide.
Les dépendances d’un mod (objets requis) sont installées automatiquement. Pour empêcher le téléchargement des dépendances d’un mod précis, le fichier propose aussi une liste Ignore_Children_File_IDs.
Étape 3 — Redémarrer le serveur
Au démarrage, le serveur télécharge et met à jour tous les mods listés (et leurs dépendances). Les joueurs téléchargent ensuite automatiquement les mods en se connectant — aucune manipulation côté client.
Installer une carte Workshop
Une carte custom demande deux actions :
- Ajouter son File ID dans
WorkshopDownloadConfig.json - Indiquer son nom avec la commande
MapdansServers/<ServerID>/Server/Commands.dat:
Map HawaiiIDs des cartes curatées officielles
Certaines cartes « curatées » (et quelques arènes officielles) ne sont disponibles que via le Workshop. Voici les File IDs publiés par Smartly Dressed Games :
| Carte | File ID |
|---|---|
| A6 Polaris | 2898548949 |
| Arid | 2683620106 |
| Belgium | 1727125581 |
| Buak | 3000549606 |
| California | 1905768396 |
| Carpat | 1497352180 |
| Cyprus Survival | 1647986053 |
| Dango | 1850228333 |
| Easter Island | 1983200271 |
| Elver | 2136497468 |
| Escalation | 3251926587 |
| France | 1975500516 |
| Greece | 1702240229 |
| Hawaii | 1753134636 |
| Ireland | 1411633953 |
| Kuwait | 2483365750 |
| Rio de Janeiro | 3416057692 |
Arènes : Athens Arena 1454125991, Bunker Arena 1257784170, Canyon Arena 1850209768, Cyprus Arena 1647991167, PEI Arena 2396897717, Washington Arena 2404652624.
Les cartes de base (PEI, Washington, Yukon, Russia, Germany) sont incluses et ne nécessitent aucun ID.
Pour la carte France : ajoutez
1975500516dansFile_IDspuisMap FrancedansCommands.dat.
Mises à jour des mods
Par défaut, le serveur surveille les mises à jour de la carte hébergée : quand une nouvelle version est publiée, il prévient les joueurs dans le chat puis s’arrête après un minuteur, pour que la version serveur reste compatible avec celle des clients (source : doc SDG, Dedicated Workshop Update Monitor). Pensez donc à avoir un redémarrage automatique : les serveurs HebergTonServ redémarrent via le panel.
Erreurs fréquentes
| Problème | Solution |
|---|---|
| Le serveur ne démarre plus après modification | JSON invalide : vérifiez les virgules (pas de virgule finale) |
| La carte Workshop ne se charge pas | Le nom dans Map doit correspondre au nom de la carte, et son ID doit être dans File_IDs |
| Joueurs bloqués au téléchargement | Mod très lourd : patienter, ou alléger la liste |
| Mod non mis à jour | Redémarrer le serveur (les mises à jour se font au démarrage) |
FAQ
Les joueurs doivent-ils s’abonner aux mods ?
Non. Les mods listés dans WorkshopDownloadConfig.json sont téléchargés automatiquement par les joueurs lors de la connexion.
Combien de mods peut-on mettre ?
Il n’y a pas de limite pratique dans le fichier, mais chaque mod augmente la RAM consommée et le temps de connexion des joueurs. Au-delà de quelques gros packs, prévoyez 8 Go de RAM.
Mods Workshop et plugins, quelle différence ?
Les mods Workshop ajoutent du contenu (cartes, objets, véhicules) et sont téléchargés par les joueurs. Les plugins (RocketMod / OpenMod) ajoutent des fonctionnalités côté serveur uniquement (kits, économie, permissions). Voir Installer RocketMod et OpenMod.
