Installer des mods sur son serveur Vintage Story

Les mods sont une grande force de Vintage Story : nouvelles recettes, cuisine avancée, ruines, outils de construction… Bonne nouvelle, installer des mods sur un serveur est simple, et vos joueurs n’ont presque rien à faire : le jeu leur envoie automatiquement les mods nécessaires.

Comprendre les types de mods

Avant d’installer quoi que ce soit, il faut savoir où un mod s’exécute. C’est indiqué sur sa page du ModDB officiel.

Côté	Exemple	Installation
Universel (client + serveur)	Nouveaux blocs, objets, créatures, recettes	Sur le serveur ; les joueurs le reçoivent automatiquement
Serveur uniquement	Outils d’admin, protections, règles de jeu	Sur le serveur uniquement
Client uniquement	Interface, HUD, shaders, raccourcis	Chaque joueur l’installe s’il le souhaite

Les mods se présentent généralement sous forme de fichier .zip. Ne les décompressez pas : le jeu les lit tels quels.

Méthode 1 : déposer les fichiers dans le dossier Mods

C’est la méthode la plus fiable, idéale pour installer plusieurs mods d’un coup.

Étape 1 : vérifier la version de votre serveur

La version exacte du serveur s’affiche dans la console et les logs au démarrage (par exemple 1.22.7), ainsi que dans le panel de votre hébergeur. Chaque mod indique les versions compatibles : téléchargez toujours le fichier correspondant à votre version.

Étape 2 : télécharger le mod

Sur mods.vintagestory.at, ouvrez la page du mod, onglet Files, et téléchargez la version compatible.

Étape 3 : arrêter le serveur

Arrêtez le serveur depuis le panel ou avec :

/stop

Étape 4 : envoyer le fichier

Déposez le .zip dans le dossier Mods du serveur :

Installation	Dossier
Chez HebergTonServ	Mods/ à la racine des fichiers du serveur (gestionnaire de fichiers ou SFTP)
Windows	%appdata%\VintagestoryData\Mods
Linux	~/.config/VintagestoryData/Mods ou <dataPath>/Mods

Pour un modpack de plusieurs dizaines de mods, passez par SFTP avec FileZilla ou WinSCP : c’est bien plus rapide que l’upload navigateur.

Étape 5 : redémarrer et vérifier

Démarrez le serveur et surveillez la console. Chaque mod chargé apparaît dans les logs. À la connexion, les joueurs voient le téléchargement automatique des mods nécessaires.

Méthode 2 : la commande /moddb (sans SFTP)

Vintage Story intègre un gestionnaire de mods directement dans la console serveur, relié au ModDB officiel.

/moddb search nom du mod
/moddb install modid
/moddb list
/moddb remove modid

Sous-commande	Effet
search	Cherche un mod sur le ModDB
searchcompatible	Cherche uniquement parmi les mods compatibles avec votre version
install	Télécharge et installe un mod par son identifiant
list	Liste les mods installés
remove	Désinstalle un mod

Le modid est l’identifiant technique du mod, visible sur sa page ModDB (souvent le nom en minuscules sans espaces).

Configurer un mod

Beaucoup de mods créent un fichier de réglages au premier lancement dans le dossier ModConfig :

ModConfig/
├── nomdumod.json
└── autremod.json

Comme pour serverconfig.json : arrêtez le serveur, éditez le fichier, redémarrez. Certains mods proposent aussi leurs propres commandes : consultez leur page ModDB.

Gérer les dépendances

Certains mods en nécessitent d’autres (bibliothèques communes, API). La page ModDB les liste, et le serveur les signale dans les logs s’ils manquent. Installez toutes les dépendances dans le dossier Mods, à la bonne version.

Mettre à jour ses mods sans casser son monde

1. Sauvegardez le monde avant toute mise à jour (voir sauvegarder son monde)
2. Remplacez l’ancien .zip par le nouveau (ne gardez pas les deux versions)
3. Lisez le changelog : certains mods demandent des étapes de migration
4. Redémarrez et testez avant d’annoncer la mise à jour

Quelques mods populaires pour serveur

À titre d’idées (vérifiez toujours la compatibilité avec votre version) :

• Carry On : porter coffres et paniers à deux mains, indispensable pour déménager
• Expanded Foods : cuisine beaucoup plus riche
• Primitive Survival : pièges, pêche artisanale, nouveaux blocs de survie
• Better Ruins : des ruines plus variées et intéressantes à explorer

Commencez léger : ajoutez les mods progressivement et testez à chaque étape. Un modpack de 80 mods installé d’un coup est un cauchemar à déboguer.

Dépannage

Le serveur ne démarre plus après l’ajout d’un mod Ouvrez le dernier fichier de log du serveur dans Logs/ et cherchez Exception ou le nom du mod. Retirez le dernier mod ajouté pour confirmer.

Un joueur est expulsé à la connexion à cause d’un mod Il a probablement une version client différente d’un mod universel installé manuellement. Demandez-lui de supprimer ce mod de son propre dossier Mods : le serveur lui enverra la bonne version.

Le mod n’apparaît pas en jeu

• Le fichier a été décompressé : remettez le .zip
• Il n’est pas dans le bon dossier Mods
• Il n’est pas compatible avec la version du serveur

Le serveur rame depuis l’ajout de mods Les mods de génération de monde et de créatures consomment beaucoup. Surveillez la RAM et le CPU, et consultez notre guide pour optimiser son serveur Vintage Story.

Questions fréquentes

Où mettre les mods sur un serveur Vintage Story ?

Dans le dossier Mods du dossier de données du serveur, sans les décompresser, puis redémarrer.

Les joueurs doivent-ils installer les mods du serveur ?

Non pour les mods serveur et universels : ils sont téléchargés automatiquement à la connexion. Seuls les mods client (interface, shaders) sont à installer par chaque joueur.

Comment installer un mod sans redémarrer ?

Avec /moddb install modid dans la console. Un redémarrage reste recommandé pour les mods de contenu.

Pourquoi mon serveur crash après avoir ajouté un mod ?

Mod non compatible avec la version du jeu, dépendance manquante ou conflit entre mods. Consultez les logs, retirez le dernier mod ajouté et vérifiez sa version sur le ModDB.

---

Un serveur taillé pour les modpacks ? Nos serveurs de jeux sur Ryzen 9 et NVMe encaissent les gros packs de mods. Voir les offres ou notre guide pour bien choisir son hébergeur Vintage Story.