Comment installer des mods dans Risk of Rain 2 (2026)

Un guide sur la façon de télécharger et d'installer des mods dans Risk of Rain 2 sur PC, couvrant r2modman, la méthode manuelle, et la pile de dépendances qui piège la plupart des gens.

Risk of Rain 2 possède l'une des scènes de modding les plus anciennes et les mieux organisées sur Thunderstore. Elle possède aussi l'une des piles de dépendances les plus profondes, et comprendre cette pile fait vraiment la différence entre une installation qui fonctionne et une heure de confusion.

Notre exemple de travail est Starstorm 2, un gros mod de contenu qui ajoute des survivants, des objets et des ennemis. C'est un bon exemple justement parce qu'il n'est pas simple.

Prérequis

• Un PC sous Windows 10 ou plus récent, ou Linux.
• Risk of Rain 2 sur Steam ou l'Epic Games Store.
• Quelques centaines de Mo libres. Les mods de contenu de l'ampleur de Starstorm 2 prennent plus de place.
• Un outil d'archivage comme 7-Zip si vous installez à la main.

Il n'y a pas d'anti-triche dans Risk of Rain 2 et aucun risque de bannissement à le modder. Les mods désactivent toutefois les succès Steam dans certaines configurations, alors gardez cela à l'esprit si vous les chassez encore.

La pile de mods

Les mods de Risk of Rain 2 reposent sur deux couches, et un mod refusera de se charger si l'une d'elles est manquante ou obsolète. Cela vaut la peine d'être compris même si vous utilisez un gestionnaire de mods qui s'en occupe pour vous, car cela explique chaque message d'erreur que vous êtes susceptible de voir.

BepInEx

BepInExPack est le chargeur de mods. Il s'accroche au jeu au lancement et charge les plugins depuis BepInEx/plugins.

Le pack pour Risk of Rain 2 n'est pas du BepInEx classique. Il embarque plusieurs correctifs communautaires, dont RoR2BepInExPack, FixPluginTypesSerialization et BepInEx_GUI. Ceux-ci existent à cause de particularités propres à ce jeu, ce qui explique pourquoi vous voulez ce pack plutôt que le BepInEx d'origine.

R2API

R2API est une API de modding qui se place entre BepInEx et les mods. Elle offre aux créateurs de mods un moyen stable et partagé d'ajouter des survivants, des objets, des élites, des buffs, etc., sans que chaque mod ne réinvente la roue et n'entre en collision avec tous les autres.

R2API a été divisé en sous-modules il y a quelque temps, et c'est ce qui embrouille les gens. Au lieu d'un seul gros R2API.dll, il existe maintenant des paquets séparés comme R2API_Prefab, R2API_Networking et R2API_Difficulty. Un mod ne dépend que des sous-modules qu'il utilise réellement. Starstorm 2 en importe une douzaine environ.

Vous ne les installez presque jamais à la main. Laissez le gestionnaire de mods s'en charger.

Le mod lui-même

Avec ces deux couches en place, le mod est un .dll dans BepInEx/plugins comme n'importe quel autre plugin BepInEx.

NOTE - Les versions comptent ici plus que dans la plupart des jeux. Un mod compilé pour R2API 5.0.5 peut ne pas se charger avec une version plus ancienne de R2API. Les gestionnaires de mods installent les versions déclarées par un mod, ce qui explique pourquoi les installations manuelles échouent plus souvent dans ce jeu qu'ailleurs.

Installer avec r2modman

r2modman est l'outil standard pour ce jeu et a été écrit à l'origine pour lui. Thunderstore Mod Manager repose sur la même base de code et fonctionne de manière identique si vous le préférez ; Gale est une alternative plus légère qui prend également en charge ce jeu.

Configurer un profil

1. Téléchargez r2modman depuis sa page Thunderstore ou depuis GitHub.
2. Lancez-le et choisissez Risk of Rain 2.
3. Choisissez la boutique où vous possédez le jeu, Steam ou Epic. r2modman trouve le dossier d'installation à partir de là.
4. Vous arriverez sur l'écran des profils. Créez un nouveau profil plutôt que d'utiliser Default, et nommez-le selon ce que vous en faites, par exemple starstorm.

Les profils sont la fonctionnalité qu'il vaut la peine d'apprendre. Chacun conserve sa propre liste de mods, ses propres configurations et son propre état lié aux sauvegardes, et passer de l'un à l'autre est instantané et ne retélécharge rien. Garder un profil par partie ou par groupe d'amis est bien moins pénible que d'activer et désactiver les mods à la main.

Installer Starstorm 2

1. Avec votre profil sélectionné, cliquez sur Online dans la barre latérale gauche.
2. Recherchez Starstorm2 et ouvrez le résultat de TeamMoonstorm.
3. Cliquez sur Download, puis sur Download with dependencies lorsque demandé.
4. Laissez faire. Cela va récupérer BepInExPack, MoonstormSharedUtils et les sous-modules R2API dont Starstorm 2 a besoin, ce qui fait une longue liste.
5. Passez sur Installed et vérifiez que tout apparaît sans icône d'avertissement.

Lancer en mode modé

Cliquez sur Start modded en haut de la fenêtre r2modman.

Ne lancez pas le jeu depuis Steam ou Epic. Cela le démarre en version vanilla. r2modman fonctionne en injectant BepInEx au lancement via le profil, donc le lancement doit passer par r2modman pour que tout cela s'applique.

ASTUCE - Si vous voulez un raccourci Steam qui lance le jeu modé, r2modman peut générer les arguments de lancement pour vous sous Settings, puis Browse profile folder. La plupart des gens trouvent plus simple de simplement garder r2modman ouvert.

Installer manuellement

Faisable, et bon à savoir, mais vraiment plus fastidieux dans ce jeu que dans la plupart des autres à cause de la situation des sous-modules R2API.

Trouvez d'abord votre dossier de jeu. Sur Steam, clic droit sur Risk of Rain 2, puis Manage et Browse local files :

C:\Program Files (x86)\Steam\steamapps\common\Risk of Rain 2

Ensuite :

1. Téléchargez BepInExPack avec Manual Download, extrayez-le, puis copiez le contenu du dossier BepInExPack dans le dossier du jeu. Vous devriez vous retrouver avec BepInEx, doorstop_config.ini et winhttp.dll à côté de Risk of Rain 2.exe.
2. Lancez le jeu une fois pour que BepInEx construise ses dossiers, puis quittez.
3. Téléchargez R2API et chaque sous-module listé par le mod, extrayez-les, puis copiez leurs fichiers .dll dans BepInEx/plugins.
4. Téléchargez Starstorm 2 et copiez son contenu dans BepInEx/plugins également.

L'étape 3 est le piège. Pour bien faire, il faut lire la liste Dependencies du mod sur Thunderstore, récupérer chaque entrée à la version exacte indiquée, et répéter l'opération pour tout ce dont ces dépendances dépendent elles-mêmes. Pour Starstorm 2, cela représente plus d'une douzaine de téléchargements.

ATTENTION - Si vous installez manuellement, ne mélangez pas les versions. Récupérer les derniers sous-modules R2API alors que le mod demande des versions plus anciennes est la cause la plus fréquente d'un mod qui échoue silencieusement à se charger.

Installer avec l'application TMC

Il y a un gestionnaire supplémentaire qui mérite d'être mentionné, le nôtre. The TMC App permet des installations de mods en un clic, des sandboxes (des profils nommés par jeu, chacun avec son propre ordre de chargement et sa méthode de déploiement, interchangeables sans rien retélécharger), un navigateur de serveurs avec des graphiques de latence en direct, et le RCON.

Risk of Rain 2 ne figure pas encore dans sa liste de jeux pris en charge. Nous aimerions que ce soit le cas, et ajouter un jeu se résume à quatre fichiers JSON plutôt qu'à du code.

Avant de vous lancer, sachez toutefois que l'application est encore en développement très précoce et le dit elle-même. La majeure partie n'est que partiellement testée. Pour un jeu avec un graphe de dépendances aussi profond que celui-ci, r2modman reste l'outil de confiance, et l'application TMC est plutôt à essayer en parallèle qu'à utiliser à sa place. Quiconque veut bien l'essayer et faire un retour nous rend un vrai service.

Elle est open source sous licence GPL-3.0 sur github.com/modcommunity/tmc-app. Les problèmes et demandes de fonctionnalités se déposent sur le tracker, les pull requests sont les bienvenues, et le dépôt explique le format par jeu si vous souhaitez ajouter vous-même le support de Risk of Rain 2.

Pour l'installer :

• Linux : une seule ligne, sans root ni gestionnaire de paquets.

curl -fsSL https://raw.githubusercontent.com/modcommunity/tmc-app/main/scripts/install.sh | sh

• Windows : le setup.exe ou setup.msi depuis la page des releases. Il existe aussi une version portable, même si elle n'enregistre ni l'entrée du lanceur ni le gestionnaire de liens tmc://.
• macOS : le .dmg depuis la même page des releases.

Multijoueur et synchronisation des mods

Le multijoueur de Risk of Rain 2 exige que tous les joueurs utilisent des mods compatibles. Les mods de contenu qui ajoutent des objets ou des survivants doivent correspondre pour tout le lobby, et un décalage se traduit généralement par une exclusion à la connexion ou par des objets désynchronisés en cours de partie.

La solution pratique est le partage de profil. Dans r2modman, ouvrez votre profil, cliquez sur Export, puis choisissez soit Export as file soit Export as code. Vos amis utilisent Import avec le fichier ou le code et se retrouvent avec une liste de mods identique au bit près.

NOTE - Les mods purement visuels et certains mods de confort sont côté client et n'ont pas besoin de correspondre. La page Thunderstore du mod le précise généralement. Quand ce n'est pas précisé, partez du principe qu'il doit correspondre.

Consoles

Risk of Rain 2 est aussi disponible sur PlayStation, Xbox et Nintendo Switch, et aucune de ces versions ne prend en charge les mods. Tout ce qui figure dans ce guide est réservé au PC. Il n'existe aucune solution de contournement, et tout ce qui prétend modder les versions console est à éviter absolument.

Gérer vos mods

r2modman affiche une icône de mise à jour à côté de tout mod installé ayant une nouvelle version sur Thunderstore, et Update all s'occupe de tout en une fois. Comme les sous-modules R2API sont versionnés indépendamment, mettre à jour un mod peut parfois entraîner des sous-modules plus récents, ce qui peut casser un autre mod qui voulait les anciens. C'est exactement pour ce genre de situation que les profils existent : clonez le profil, mettez à jour le clone, et gardez celui qui fonctionne jusqu'à être sûr.

Désactiver un mod se fait via un interrupteur dans la liste Installed et laisse les fichiers en place. La désinstallation les supprime.

Pour repasser totalement en vanilla, supprimez BepInEx, doorstop_config.ini et winhttp.dll du dossier du jeu. Vérifier les fichiers via Steam ne les supprimera pas, car Steam ne suit pas les fichiers qu'il n'a pas installés lui-même.

Dépannage

Le jeu se lance en mode moddé, mais sans mods. Vous avez lancé le jeu depuis Steam ou Epic au lieu de r2modman.

Un mod est installé mais ne se charge jamais. Vérifiez la console BepInEx pour une ligne le mentionnant. Si la console signale un type ou une méthode manquante, il s'agit d'une incompatibilité de version avec R2API. Réinstallez le mod avec ses dépendances depuis le gestionnaire.

Le jeu reste bloqué sur l'écran de démarrage. Généralement un mod conçu pour une ancienne version du jeu. Les mises à jour de Risk of Rain 2 cassent régulièrement les mods, et la solution est en général d'attendre que l'auteur le corrige.

Exclu en rejoignant un ami. Les listes de mods ne correspondent pas. Importez son profil exporté.

Les succès ne se débloquent plus. Comportement attendu avec certains mods installés. Utilisez un profil vanilla séparé si vous voulez continuer à les obtenir.

Linux et Proton. Réglez vos options de lancement Steam sur WINEDLLOVERRIDES="winhttp=n,b" %command% pour que BepInEx soit chargé. r2modman gère cela automatiquement lorsque vous lancez le jeu via lui.

Conclusion

Le modding de Risk of Rain 2 paraît intimidant de l'extérieur à cause des sous-modules R2API, mais en pratique un gestionnaire de mods réduit tout cela à une opération en deux clics. Installez r2modman, créez un profil, téléchargez avec les dépendances, et lancez en mode moddé.

Les deux choses à vraiment retenir : lancez le jeu via le gestionnaire plutôt que via Steam, et exportez votre profil pour ceux avec qui vous jouez.

Si vous avez le temps, TMC App est open source, en début de développement, et tout retour à son sujet serait vraiment apprécié.

Voir aussi

• Risk of Rain 2 sur Thunderstore
• Discord de modding Risk of Rain 2
• R2Wiki - Le wiki communautaire du modding, et la meilleure référence pour les créateurs de mods.
• R2API sur GitHub
• TMC App

Nous essayons de garder ce guide à jour, mais le jeu, BepInEx et R2API évoluent chacun à leur propre rythme. Si quelque chose ici ne correspond plus à ce que vous constatez, faites-le nous savoir ou ouvrez une pull request sur le dépôt GitHub de ce guide.

Rejoignez notre serveur Discord si vous avez des questions ou souhaitez de l'aide sur tout ce qui touche au modding !