Un guide sur comment télécharger et installer des mods dans Valheim sur PC, couvrant les mod managers et l'installation manuelle sur Windows, Linux et macOS.
Valheim tourne sur Unity et ses mods sont des plugins BepInEx. La communauté maintient sa propre build de BepInEx plutôt que d'utiliser celle d'origine, et c'est la première chose à bien comprendre.
Notre exemple est EpicLoot, un overhaul de longue date sur le loot et les objets magiques. C'est un bon cas de démonstration car il embarque de vraies dépendances et parce qu'il doit être installé sur le serveur autant que sur le client.
Prérequis
- Un PC tournant sous Windows 10 ou plus récent, Linux, ou macOS. Valheim dispose de builds natifs pour les trois.
- Valheim, idéalement la version Steam. Voir la section suivante pour comprendre pourquoi.
- Quelques centaines de Mo d'espace libre. Les gros overhauls comme EpicLoot demandent plus.
- 7-Zip ou tout autre outil d'archivage si vous installez à la main.
- Une sauvegarde de vos mondes et personnages avant de commencer. Ils se trouvent dans
%userprofile%\AppData\LocalLow\IronGate\Valheimsur Windows.
ATTENTION - Prenez cette sauvegarde au sérieux. Les mods qui ajoutent des objets et de la progression, EpicLoot y compris, écrivent des données dans votre sauvegarde. Retirer un tel mod plus tard peut vous laisser avec un personnage possédant des objets que le jeu ne reconnaît plus.
La version de Valheim que vous possédez a de l'importance
Valheim est vendu sur Steam, sur le Microsoft Store, et sur consoles Xbox.
- Steam est la version que ce guide suppose partout, et celle que vise l'ensemble de la scène du modding.
- Les installations Microsoft Store et Game Pass se trouvent sous
C:\XboxGames\Valheim\Contentet sont bien plus difficiles à modder. BepInEx doit écrire des fichiers dans le dossier du jeu, et ces installations sont protégées d'une manière qui gêne généralement ce processus. Il n'existe aucune méthode prise en charge ici et vous ne devriez pas attendre des gestionnaires de mods qu'ils fonctionnent. - Les consoles Xbox ne peuvent absolument pas être moddées. Le crossplay permet à un joueur Xbox de rejoindre un serveur PC, mais le client Xbox reste vanilla et ne peut rien charger.
BepInExPack Valheim
BepInExPack Valheim est le loader, et ce n'est pas du BepInEx classique. C'est une build spécifique à Valheim maintenue par Azumatt, Vapok et Margmas, avec un BepInEx.cfg préconfiguré, des scripts de lancement pour Linux et le serveur dédié, des modifications du preloader dont dépendent plusieurs mods, et une prise en charge du versionnage sémantique que BepInEx 5 upstream a abandonnée.
Installez ce pack, pas BepInEx générique.
NOTE - Comme il s'agit d'un fork communautaire, le Discord officiel de BepInEx ne peut pas vous aider avec des problèmes liés à Valheim, et ils vous le diront eux-mêmes. Adressez plutôt vos problèmes Valheim à la communauté de modding Valheim.
En plus de BepInEx, EpicLoot dépend de deux bibliothèques partagées :
- Jötunn, la bibliothèque de modding Valheim sur laquelle s'appuient la plupart des mods conséquents.
- JsonDotNET, une copie packagée de Newtonsoft.Json.
Les gestionnaires de mods installent les deux automatiquement.
Installer avec un mod manager Thunderstore
C'est le chemin le plus emprunté et celui vers lequel pointent les pages de mods.
Trois gestionnaires fonctionnent avec Valheim et tous trois lisent le même format de profil :
| Manager | Plateformes |
|---|---|
| Gale | Windows, Linux |
| Thunderstore Mod Manager | Windows |
| r2modman | Windows, Linux, macOS |
Les étapes sont les mêmes quel que soit votre choix :
- Installez le gestionnaire et sélectionnez Valheim.
- Créez un profil.
- Parcourez ou recherchez EpicLoot.
- Cliquez sur Install ou Download with dependencies. BepInExPack Valheim, Jötunn et JsonDotNET sont installés avec.
- Lancez le jeu depuis le gestionnaire avec Start modded ou Launch game (modded).
Lancer Valheim directement depuis Steam le fait tourner en vanilla, puisque le gestionnaire attache BepInEx au moment du lancement.
Installer avec Vortex
Vortex prend en charge Valheim et récupère les mods depuis Nexus Mods plutôt que Thunderstore. Le catalogue Valheim de Nexus est bien plus restreint et la plupart des auteurs publient d'abord sur Thunderstore, donc utilisez cette option si Vortex est déjà votre outil de prédilection et que vous y avez trouvé ce que vous cherchiez.
- Installez Vortex et connectez-vous.
- Sous Games, cherchez Valheim, survolez la vignette et cliquez sur Manage.
- Installez vous-même BepInExPack Valheim en suivant les étapes manuelles ci-dessous. Vortex ne configurera pas le loader pour vous.
- Téléchargez des mods depuis Nexus avec Mod Manager Download, puis Install et Enable.
- Lancez depuis Steam normalement. Vortex écrit les fichiers dans le dossier du jeu de façon permanente, aucun lancement spécial n'est donc nécessaire une fois BepInEx en place.
AVERTISSEMENT - Ne faites pas tourner Vortex et un gestionnaire Thunderstore sur la même installation. Les deux veulent contrôler BepInEx/plugins et annuleront le travail l'un de l'autre.
Installer manuellement
Commencez par trouver votre dossier de jeu. Faites un clic droit sur Valheim dans Steam, puis Gérer et Parcourir les fichiers locaux :
C:\Program Files (x86)\Steam\steamapps\common\Valheim
Téléchargez BepInExPack Valheim avec Manual Download, extrayez-le ailleurs que dans le dossier du jeu, puis déplacez le contenu du dossier BepInExPack_Valheim dans votre dossier Valheim. Si tout est bien fait, vous verrez BepInEx, winhttp.dll et doorstop_config.ini juste à côté de valheim.exe.
Téléchargez ensuite EpicLoot, Jötunn et JsonDotNET, extrayez chacun, et copiez leurs fichiers .dll dans Valheim\BepInEx\plugins.
La suite dépend de votre plateforme.
Windows
Rien d'autre à faire. Lancez le jeu et une fenêtre de console BepInEx devrait apparaître à ses côtés.
Linux
- Rendez le script de lancement exécutable :
chmod u+x start_game_bepinex.sh
- Dans Steam, ouvrez les Propriétés de Valheim et réglez les options de lancement sur :
./start_game_bepinex.sh %command%
- Lancez via Steam.
Vous pouvez aussi indiquer le chemin complet du script plutôt qu'un chemin relatif, ce qui vous permet de garder le pack en dehors du dossier du jeu.
macOS
Valheim dispose d'une build macOS native, mais BepInEx 5 ne fonctionne pas nativement sur Apple Silicon, car il dépend de MonoMod, et MonoMod n'a pas encore de support arm64. La solution de contournement consiste à forcer le jeu à passer par Rosetta.
- Rendez le script exécutable :
chmod u+x start_game_bepinex.sh
- Réglez les options de lancement Steam de Valheim sur :
/usr/bin/arch -x86_64 /bin/bash ./start_game_bepinex.sh %command%
- Lancez via Steam.
Omettez la partie arch -x86_64 sur un Mac série M et le jeu démarre quand même, mais sans BepInEx et sans charger aucun de vos mods. Les Mac Intel n'en ont pas besoin.
Installer avec l'app TMC
Valheim fait partie des jeux que l'app TMC prend déjà en charge, donc contrairement à la plupart de nos guides, ceci est une véritable option et non une promesse. L'app est notre propre mod manager et navigateur de serveurs, et elle déploie les mods Valheim dans BepInEx/plugins comme tout le reste dans ce guide.
L'installer :
- Linux : une seule ligne, sans root et sans gestionnaire de paquets.
curl -fsSL https://raw.githubusercontent.com/modcommunity/tmc-app/main/scripts/install.sh | sh
- Windows : le
setup.exeousetup.msidepuis la page des releases. Il existe aussi une build portable, bien qu'elle n'enregistre ni l'entrée du launcher ni le gestionnaire de lienstmc://. - macOS : le
.dmgdepuis la même page des releases.
Une fois installée :
- Ouvrez l'application et ajoutez Valheim, en pointant vers votre dossier d'installation Steam.
- Créez un sandbox. Les sandboxes sont des profils de mods nommés avec leur propre ordre de chargement et leur propre méthode de déploiement, et passer de l'un à l'autre ne retélécharge rien.
- Installez les mods souhaités dans ce sandbox.
- Lancez le jeu.
ATTENTION - Merci de lire cette partie avant de vous y fier. L'app en est à un stade de développement très précoce et nous préférons vous le dire plutôt que vous le découvriez en pleine partie. Son propre README indique que chaque jeu pris en charge est non testé, Valheim y compris, donc considérez-la comme quelque chose à tester en parallèle de Gale ou r2modman plutôt que comme un remplacement. Gardez la sauvegarde mentionnée dans les prérequis.
Cela dit, c'est précisément à ce stade que l'essayer est le plus utile. Si ça fonctionne, nous aimerions le savoir. Si ça déploie dans le mauvais dossier ou saccage votre ordre de chargement, nous aimerions vraiment le savoir, et ce genre de retour vaut plus pour le projet en ce moment que presque tout le reste.
L'app est open source sous licence GPL-3.0 sur github.com/modcommunity/tmc-app. Les rapports de bugs et demandes de fonctionnalités se font sur le tracker d'issues, les pull requests sont les bienvenues, et le dépôt documente le fonctionnement des règles par jeu si vous souhaitez améliorer vous-même la partie Valheim.
Mods côté serveur et multijoueur
C'est la partie qui piège souvent les joueurs de Valheim, car elle fonctionne différemment de la plupart des jeux coopératifs.
Les mods Valheim se répartissent grossièrement en trois catégories :
- Client uniquement. Ajustements d'interface, changements de caméra, mods visuels. Installez-les sur votre machine, rien d'autre ne s'en soucie.
- Client et serveur. Tout ce qui ajoute des objets, des recettes, des créatures ou de la progression. EpicLoot rentre pleinement dans cette catégorie, et il doit être installé sur le serveur dédié comme sur le client de chaque joueur.
- Serveur uniquement. Outils d'administration, sauvegardes, gestion du monde.
Se tromper sur ce point se traduit généralement par une exclusion à la connexion pour incompatibilité de version, ou par des objets qui disparaissent parce que le serveur ne les reconnaît pas.
Pour un serveur dédié, BepInExPack Valheim fournit un script start_server_bepinex.sh conçu exactement pour cela. Rendez-le exécutable avec chmod u+x start_server_bepinex.sh, modifiez ses paramètres de lancement comme vous le feriez pour le script serveur natif de Valheim, et exécutez-le à la place de start_server.sh.
Si vous configurez un serveur depuis zéro, notre guide de serveur Valheim séparé couvre cet aspect.
ASTUCE - Plusieurs hébergeurs Valheim gérés installeront BepInEx pour vous d'un simple clic. Si vous préférez ne pas toucher à un shell, c'est un raccourci tout à fait légitime.
Configurer les mods
Les mods écrivent leurs fichiers de configuration ici au premier lancement :
Valheim\BepInEx\config
Ce sont des fichiers texte .cfg classiques. EpicLoot y place une grande partie de ses réglages, ainsi que des fichiers JSON pour les tables de butin et les effets magiques, et cela vaut vraiment le coup d'y jeter un œil si vous voulez ajuster les choses plutôt que d'accepter les valeurs par défaut.
BepInEx Configuration Manager ajoute une fenêtre de réglages en jeu qui modifie les mêmes valeurs sans avoir à faire d'alt-tab. Gale et r2modman incluent également tous deux des éditeurs de configuration.
Vérifier que tout a bien chargé
Sur Windows, BepInEx ouvre une fenêtre de console à côté du jeu. Elle apparaît dans la barre des tâches et vous pouvez y observer la séquence de démarrage.
Ce que vous voulez voir, c'est du texte gris et blanc, qui correspond aux informations. Les couleurs signalent un problème :
| Couleur | Signification |
|---|---|
| Rouge | Erreur fatale |
| Rouge foncé | Erreur |
| Jaune | Avertissement |
| Gris foncé | Sortie de débogage |
Le pack affiche aussi sa propre version Thunderstore dans la console, qui est distincte de la version BepInEx sous-jacente.
Pour EpicLoot en particulier, chargez un monde et vérifiez votre inventaire pour les onglets d'objets magiques et les recettes de la station d'augmentation.
Mettre à jour et désinstaller
Les mod managers signalent les mods obsolètes et les mettent à jour en un clic. Effectuez vos mises à jour entre deux sessions de jeu plutôt qu'en pleine partie, car un mod qui écrit dans votre sauvegarde peut mal se comporter quand les versions changent sous lui.
Pour retirer un mod, désinstallez-le dans votre gestionnaire ou supprimez son .dll de BepInEx/plugins. Pour revenir au jeu vanilla, supprimez BepInEx, winhttp.dll, doorstop_config.ini et les scripts de lancement du dossier du jeu. La vérification des fichiers de Steam ne les supprimera pas, puisque ce n'est pas Steam qui les a installés.
AVERTISSEMENT - Avant de retirer un mod qui a ajouté des objets à votre monde, réfléchissez à si vous voulez encore garder ce personnage et ce monde ensuite. C'est justement à cela que sert la sauvegarde.
Dépannage
Pas de console BepInEx et aucun mod. Sur Windows, vérifiez que winhttp.dll se trouve directement à côté de valheim.exe. Sur Linux, vérifiez que vos options de lancement incluent ./start_game_bepinex.sh %command%. Sur macOS, vérifiez que le préfixe arch -x86_64 est bien présent.
Exclu d'un serveur pour incompatibilité de version. Vos mods et ceux du serveur ne correspondent pas. Installez les mêmes versions que celles utilisées par le serveur, ou demandez à l'hébergeur d'exporter sa liste.
Les mods ont cessé de fonctionner après une mise à jour de Valheim. C'est normal. Les correctifs d'Iron Gate cassent les mods BepInEx et les auteurs ont besoin de temps. Consultez les pages Thunderstore de vos mods pour voir si des versions mises à jour sont disponibles.
Le jeu plante au démarrage. Retirez tout du dossier BepInEx/plugins, vérifiez que le démarrage est propre, puis réajoutez les mods par moitié pour trouver le coupable.
Les mods fonctionnent en solo mais pas sur mon propre serveur. Les mods côté serveur doivent aussi être installés sur le serveur, pas uniquement dans le client qui l'héberge. Utilisez start_server_bepinex.sh.
La version Microsoft Store ne se laisse pas modder. C'est globalement le cas, et il n'existe aucune méthode prise en charge pour contourner ça. La version Steam est celle à utiliser.
Rien ne se charge sur un Mac M-series. Il vous manque le préfixe Rosetta dans vos options de lancement.
Conclusion
La version courte pour la plupart des gens : installez Gale ou r2modman, choisissez Valheim, installez EpicLoot avec ses dépendances, et lancez en mode modded. BepInExPack Valheim suit automatiquement et vous n'avez jamais à y penser.
Les deux points spécifiques à Valheim à retenir sont que le pack BepInEx est un fork communautaire avec ses propres particularités et ses propres canaux de support, et que tout ce qui touche aux objets ou à la progression doit être installé sur le serveur en plus du client.
Valheim est l'un des rares jeux déjà pris en charge par notre propre TMC App. Elle est open source et très tôt dans son développement, donc elle mérite d'être testée plutôt que d'être considérée comme fiable, et tout retour à son sujet serait vraiment apprécié.
Voir Aussi
- Valheim sur Thunderstore
- Valheim sur Nexus Mods
- Discord de modding Valheim
- Wiki de modding Valheim
- FAQ officielle sur le modding Valheim - les notes d'Iron Gate sur le système d'asset bundle avec lequel les mods doivent composer.
- Documentation de Jötunn
- TMC App
Nous maintenons ce guide aussi à jour que possible, mais Valheim, BepInEx et les bibliothèques de mods évoluent chacun de leur côté. Si une instruction ici ne correspond plus à ce que vous observez, merci de le signaler ou d'ouvrir une pull request sur le dépôt GitHub de ce guide.
Rejoignez notre serveur Discord si vous avez des questions ou besoin d'aide sur tout ce qui touche au modding !