Factorio Intermédiaire 10 min de lecture

Installer des mods sur un serveur Factorio (Mod Portal, mod-list.json, Space Age)

Comment installer des mods sur un serveur Factorio headless : dossier mods, fichiers .zip du Mod Portal, mod-list.json, mod-settings.dat, --sync-mods, activation de Space Age et synchronisation côté joueurs.

Installer des mods sur un serveur Factorio (Mod Portal, mod-list.json, Space Age)

Installer des mods sur un serveur Factorio (Mod Portal, mod-list.json, Space Age)

Krastorio 2, Pyanodon’s, Bob’s & Angel’s, Space Exploration… les mods font une grande partie de la longévité de Factorio. Sur un serveur, la règle d’or est simple : le serveur et tous les joueurs doivent utiliser exactement les mêmes mods, dans les mêmes versions. Bonne nouvelle, le jeu synchronise automatiquement les mods côté joueurs. Ce guide explique comment les installer côté serveur.

Sur un serveur Factorio HebergTonServ, vous déposez vos mods via le gestionnaire de fichiers ou SFTP et redémarrez. Offres dès 6,90 €/mois, 8 Go de RAM en Pro pour les modpacks lourds.


Comment fonctionnent les mods Factorio

ÉlémentEmplacement / rôle
ModsFichiers .zip dans le dossier mods/ (ne pas décompresser)
mods/mod-list.jsonListe des mods et leur état enabled: true/false
mods/mod-settings.datRéglages des mods (startup, runtime)
Mods officiels Space Agespace-age, quality, elevated-rails dans data/
Mod Portalmods.factorio.com

Sur une installation headless dans /opt/factorio, le dossier des mods est /opt/factorio/mods/. Sur un PC Windows, c’est %appdata%\Factorio\mods.


Méthode 1 (la plus simple) : préparer les mods en solo puis copier

C’est la méthode la plus fiable, car le jeu gère automatiquement les dépendances :

  1. Dans votre jeu, menu principal → Mods → onglet d’installation → installez les mods voulus. Les dépendances obligatoires sont téléchargées automatiquement.
  2. Lancez une partie solo pour vérifier que tout fonctionne.
  3. Ouvrez %appdata%\Factorio\mods sur votre PC.
  4. Arrêtez le serveur puis copiez tout le contenu (les .zip, mod-list.json et mod-settings.dat) dans le dossier mods/ du serveur.
  5. Redémarrez le serveur.

Copier mod-settings.dat garantit que les réglages de démarrage (startup settings) du serveur sont identiques aux vôtres.


Méthode 2 : télécharger depuis le Mod Portal

  1. Connectez-vous sur mods.factorio.com.
  2. Sur la page du mod, onglet Downloads, téléchargez la version compatible avec votre version de Factorio (2.0 pour la stable actuelle).
  3. Vérifiez les dépendances indiquées sur la page et téléchargez-les aussi.
  4. Envoyez les .zip dans mods/ via SFTP.
  5. Redémarrez le serveur : les nouveaux mods sont ajoutés et activés.

Pour désactiver un mod sans le supprimer, éditez mods/mod-list.json :

{
  "mods": [
    { "name": "base", "enabled": true },
    { "name": "elevated-rails", "enabled": true },
    { "name": "quality", "enabled": true },
    { "name": "space-age", "enabled": true },
    { "name": "Krastorio2", "enabled": false }
  ]
}

Le champ name correspond au nom interne du mod (visible dans l’URL du Mod Portal).


Méthode 3 : —sync-mods avec une sauvegarde

Factorio peut aligner automatiquement les mods sur ceux utilisés par une sauvegarde :

cd /opt/factorio
./bin/x64/factorio --sync-mods ./saves/mon-usine.zip

Si des mods doivent être téléchargés, le serveur headless a besoin de vos identifiants de service dans player-data.json (dossier d’écriture du serveur) :

{
  "service-username": "VotrePseudoFactorio",
  "service-token": "votre-token"
}

Le token se trouve sur votre profil factorio.com. Gardez-le secret.


Activer ou désactiver Space Age sur le serveur

Depuis Factorio 2.0, Space Age est livré sous forme de mods officiels déjà présents dans le dossier data/ du serveur headless. Par défaut, une nouvelle carte créée avec --create est une partie Space Age.

Vous voulez…Réglage dans mods/mod-list.json
Partie Space Age complètespace-age, quality, elevated-rails à true
Partie vanilla 2.0les trois à false
Vanilla + rails surélevéselevated-rails à true, les deux autres à false

Important : chaque joueur qui rejoint une partie Space Age doit posséder l’extension. Si un ami ne l’a pas, créez une partie vanilla.

Sur la branche expérimentale 2.1, un mod supplémentaire recycler fait partie de l’extension : gérez-le de la même manière.

Les dépendances entre mods officiels s’appliquent : Space Age nécessite notamment elevated-rails.


Côté joueurs : la synchronisation automatique

Quand un joueur tente de rejoindre un serveur moddé, Factorio lui propose de synchroniser ses mods : il télécharge et active exactement les mêmes versions que le serveur, réglages de démarrage compris. Il n’a rien à installer manuellement.

Si la synchronisation échoue, c’est en général parce qu’un mod n’est pas disponible sur le Mod Portal (mod privé ou issu du forum). Dans ce cas, envoyez le .zip aux joueurs pour qu’ils le placent dans %appdata%\Factorio\mods.


Mods et performances

Les gros modpacks multiplient les entités et les recettes : l’UPS dépend alors fortement du CPU et la RAM grimpe.

Type de partieRAM conseillée
Quelques mods QoL4 Go
Space Age + mods de contenu4 à 8 Go
Overhaul (Pyanodon’s, Krastorio 2, Bob’s & Angel’s)8 Go

Pour ces profils, l’offre Factorio Pro (8 Go, 11,90 €/mois) de HebergTonServ est dimensionnée pour garder de la marge.


Dépannage

SymptômeCause probableSolution
Le mod n’apparaît pasLe .zip a été décompresséRemettez le fichier .zip tel quel
« Missing dependency » au démarrageDépendance absenteTéléchargez la dépendance indiquée dans le log
Joueur refusé pour « mod mismatch »Version différenteLaissez le joueur accepter la synchro de mods
Le serveur plante au chargementMod incompatible avec la version du jeuVérifiez la version Factorio supportée sur le Mod Portal
Joueur sans extension refuséSpace Age activéDésactivez les mods officiels ou demandez l’achat de l’extension

Les erreurs sont détaillées dans factorio-current.log, dans le dossier d’écriture du serveur.


FAQ

Faut-il décompresser les mods Factorio ?

Non. Les mods s’installent en copiant le fichier .zip dans le dossier mods/, sans le décompresser.

Les joueurs doivent-ils installer les mods eux-mêmes ?

Non. À la connexion, Factorio propose de synchroniser les mods avec le serveur et télécharge automatiquement les bonnes versions.

Peut-on ajouter un mod à une partie déjà commencée ?

Oui dans la plupart des cas : le jeu applique une migration au chargement. Faites toujours une copie de la sauvegarde avant. Retirer un mod qui ajoute des entités supprime ces entités de la carte.

Les mods désactivent-ils les succès Steam ?

Les mods ont leurs propres règles de succès, mais l’utilisation de commandes Lua (/c) désactive définitivement les succès de la partie. Voir commandes admin Factorio.


Conclusion

Installer des mods sur un serveur Factorio se résume à déposer les .zip dans mods/, régler mod-list.json et redémarrer. La synchronisation automatique fait le reste côté joueurs.

Commandez votre serveur Factorio moddé chez HebergTonServ →

Pour aller plus loin

Sources : wiki Factorio — Modding, wiki Factorio — Command line parameters, wiki Factorio — Space Age, forum officiel — Space Age sur serveur headless.