Installer et dépanner les mods de Vintage Story

Avant de télécharger un mod

La Mod DB officielle de Vintage Story est le principal site de découverte et de distribution recommandé par le wiki géré par la communauté et hébergé sur l’infrastructure officielle de Vintage Story. La popularité d’un mod ne garantit pas qu’il convient à votre configuration actuelle. Lisez sa description et vérifiez ses dépendances, son côté d’exécution, les versions du jeu prises en charge, l’historique des fichiers et les problèmes signalés récemment.

Vérification	Ce qu’il faut confirmer pour la version 1.22.5
Compatibilité avec le jeu	Le fichier choisi indique une prise en charge de la 1.22.5 ou d’une plage 1.22.x que l’auteur déclare compatible
Dépendances	Toutes les bibliothèques et tous les mods complémentaires requis sont installés dans une version compatible
Côté client ou serveur	Le mod est installé à l’endroit où sa page Mod DB indique qu’il doit s’exécuter
Chevauchement existant	Aucun autre mod actif ne remplace les mêmes mécaniques, ressources ou enregistrements
Effet sur le monde	Vous savez si le retrait ultérieur du mod pourrait supprimer des blocs, des objets, des entités ou des données du monde
Sauvegarde	Une copie de la sauvegarde concernée existe en dehors du dossier de sauvegarde actif

Ne supposez pas que le fichier le plus récent est nécessairement le bon. Le guide officiel de dépannage prévient expressément qu’une nouvelle version d’un mod peut cibler une autre version du jeu. L’onglet des fichiers est la référence pour faire correspondre une version de mod à la version de Vintage Story que vous utilisez réellement.

Installer un mod en mode solo

Téléchargez le fichier choisi depuis la page officielle du mod sur la Mod DB.
Conservez le mod sous forme de fichier .zip, sauf si son auteur donne explicitement d’autres instructions. L’installation standard ne demande pas d’extraire l’archive.
Lancez Vintage Story et ouvrez le gestionnaire de mods depuis le menu principal.
Sélectionnez Ouvrir le dossier des mods. Vous éviterez ainsi de chercher quel dossier de données utilisateur votre installation emploie actuellement.
Copiez ou déplacez le fichier .zip du mod dans ce dossier.
Revenez au gestionnaire et choisissez Recharger les mods, ou fermez puis relancez le jeu.
Vérifiez que le mod apparaît et qu’il est activé. Laissez actifs les éléments intégrés Essentials, Survival et Creative Mode : ensemble, ils constituent le jeu standard.
Testez le changement dans un nouveau monde ou une copie sans valeur avant de l’appliquer à un monde important joué depuis longtemps.

Sous Windows, le chemin utilisateur par défaut est %appdata%\VintagestoryData\Mods. Sous Linux, le guide officiel indique ~/.config/VintagestoryData/Mods. Le bouton du gestionnaire de mods reste la méthode la plus sûre si vous avez personnalisé le chemin des données ou déplacé une installation.

Sauvegardes et mises à jour

Le guide officiel des mods recommande de sauvegarder vos parties avant d’ajouter ou de retirer un mod, ainsi qu’avant de mettre Vintage Story à jour. Adoptez la même précaution pour les mises à jour majeures des mods. Une sauvegarde doit être une copie distincte, et non un simple fichier supplémentaire dans le même dossier de sauvegarde actif.

Pour mettre un mod à jour :

Arrêtez de jouer et fermez le jeu ou le serveur.
Lisez le journal des modifications du mod afin de repérer les consignes de migration ou les ruptures de compatibilité.
Sauvegardez le monde et les fichiers de configuration concernés.
Supprimez l’ancienne archive en double si le nouveau fichier porte un nom différent.
Installez le fichier de remplacement compatible et confirmez qu’il ne reste qu’une seule copie active.
Chargez d’abord une copie de test et contrôlez les blocs, les inventaires, les entités et les recettes propres au mod.

Liste de contrôle pour le dépannage

Symptôme	Premières vérifications	Prochaine action sans risque
Le mod n’apparaît pas	Mauvais chemin vers Mods, archive non valide, ancien réglage personnalisé de `modPaths`	Ouvrez le dossier depuis le gestionnaire de mods ; si le nom d’utilisateur du système a changé, vérifiez les chemins dans `clientsettings.json` et `serverconfig.json` lorsque le jeu est fermé
Le jeu ne fonctionne plus après une mise à jour	Le mod ne prend pas en charge la 1.22.5	Désactivez les mods qui ne font pas partie du jeu de base et installez des versions explicitement compatibles avec la version actuelle
Blocs manquants ou exceptions au démarrage	Plusieurs versions du même mod utilisant du code	Parcourez tous les chemins de mods configurés et ne conservez que la copie voulue
Le plantage survient uniquement avec plusieurs mods	Conflit entre deux mods	Reproduisez le problème dans un monde de test et désactivez la moitié de l’ensemble à chaque essai jusqu’à isoler le responsable
Le monde fonctionne sans mods, mais pas avec eux	Mauvaise dépendance, mauvaise version ou mauvais côté d’exécution	Vérifiez l’onglet des fichiers de la Mod DB, les dépendances et les exigences côté client ou serveur
Un serveur modifié conserve un ancien fichier	Un mod propre au serveur et mis en cache porte le même nom de fichier	Quittez le serveur, supprimez son dossier sous `ModsByServer`, puis reconnectez-vous pour télécharger de nouveau l’ensemble du serveur

Effectuez les tests de conflit dans un nouveau monde ou une copie. Activer et désactiver à plusieurs reprises des mods de contenu dans l’unique copie d’un monde précieux peut supprimer ou réaffecter des données, et rendre le problème initial plus difficile à diagnostiquer.

Mods en multijoueur

Les clients récents de Vintage Story créent un dossier propre à chaque serveur sous ModsByServer lorsqu’ils rejoignent un serveur modifié. Les mods côté serveur ou universels proposés par celui-ci peuvent être téléchargés pour ce serveur sans se mélanger au dossier Mods habituel du mode solo. Les mods exclusivement côté client peuvent encore nécessiter une installation manuelle, selon le mod et les règles du serveur.

Les propriétaires de serveurs doivent conserver des versions compatibles entre le serveur, ses mods et les clients qui s’y connectent. Modifiez les mods lorsque le serveur est arrêté, sauvegardez d’abord le monde et testez l’ensemble localement avant de rouvrir un serveur public. Consultez le guide du multijoueur pour les chemins de données, les ports et les précautions de mise à jour.

Questions fréquentes

Faut-il extraire un mod de Vintage Story ?

En général, non. Le guide d’installation officiel indique que la plupart des mods sont téléchargés sous forme de fichiers .zip et doivent être placés directement dans le dossier Mods.

Un mod prévu pour une ancienne version peut-il fonctionner avec la 1.22.5 ?

C’est possible, mais ne le présumez pas. Consultez les informations de compatibilité dans l’onglet des fichiers du mod et les instructions de son auteur.

Pourquoi Essentials, Survival et Creative Mode figurent-ils parmi les mods ?

Vintage Story construit son jeu standard au moyen de son propre système de mods. Ces trois éléments constituent le jeu de base et doivent normalement rester activés.

Comment trouver le mod qui provoque un plantage ?

Créez un test reproductible dans un nouveau monde ou une copie de la sauvegarde. Désactivez la moitié des mods qui ne font pas partie du jeu de base, puis continuez à diviser par deux le groupe suspect. Cette recherche par dichotomie est bien plus rapide que de tester une longue liste au hasard.

Comment installer des mods dans Vintage Story

Sauvegardez, gardez le paquet, isolez le conflit

Sauvegarder le monde

Garder le .zip

Isoler