Mods

Comment installer des mods

Guide d'installation

Mis à jour pour la migration de sauvegardes v0.108.0 bêta et Steam Workshop (juillet 2026)

Prérequis

Slay the Spire 2 sur Steam

Le jeu est actuellement exclusif à Steam (Windows, macOS, Linux). Pas de support des mods sur Epic ou ailleurs.

Dernière build Early Access

Gardez votre client à jour. v0.107.1 a ajouté le support officiel de Steam Workshop, et v0.108.0 bêta copie automatiquement les sauvegardes vanilla vers les sauvegardes moddées au premier lancement.

Gestion de fichiers de base

Vous devez savoir naviguer dans les fichiers locaux Steam et, pour l'installation manuelle, extraire des archives et déplacer des dossiers.

Méthode A — Steam Workshop (recommandé)

Depuis v0.107.1, Steam Workshop est l'entrée officielle des mods. Lorsqu'une version Workshop existe, c'est la voie la plus sûre : versioning, mises à jour automatiques et chargement par le launcher officiel.

  1. 1

    Ouvrez votre bibliothèque Steam, sélectionnez Slay the Spire 2 et passez à l'onglet Workshop.

  2. 2

    Parcourez les mods et cliquez sur le bouton vert « S'abonner » pour chacun.

  3. 3

    De retour dans la bibliothèque, cliquez sur « Jouer » puis choisissez « Play with Mods ». Un lancement direct contourne le mod loader.

  4. 4

    Acceptez l'avertissement « Untrusted code » au premier lancement, puis redémarrez complètement le jeu pour que les loaders s'initialisent correctement.

  5. 5

    Ouvrez le menu Mods depuis l'écran principal, activez chaque mod et redémarrez une fois de plus.

Les abonnements se synchronisent via Steam Cloud — Steam Deck et autres machines récupèrent automatiquement votre configuration.

Méthode B — Installation manuelle

Pour les mods absents du Workshop (certaines versions Nexus Mods, builds de développement), placez-les dans le dossier mods du jeu.

Windows / Linux

Clic droit sur le jeu dans Steam → Gérer → Parcourir les fichiers locaux. Créez un dossier « mods » s'il n'existe pas :

…\steamapps\common\Slay the Spire 2\mods\

macOS

Clic droit sur SlayTheSpire2.app → Afficher le contenu du paquet, puis créez un dossier « mods » dans MacOS/ :

…/Slay the Spire 2/SlayTheSpire2.app/Contents/MacOS/mods/
La plupart des mods manuels dépendent de Baselib et ModConfig. Installez-les d'abord — les versions Workshop cohabitent sans souci avec les mods manuels.
Not sure what to install? Browse our curated mod list →

Vérifier l'installation

Lancez via « Play with Mods », ouvrez le menu Mods et vérifiez que chaque mod est listé et activé. S'il manque, son manifest.json est probablement mal formé et le chargement a échoué silencieusement.

À savoir

Les sauvegardes sont séparées

Les parties moddées et vanilla utilisent des dossiers différents. En v0.108.0 bêta ou plus récent, le premier lancement moddé devrait copier les sauvegardes automatiquement ; les anciens builds peuvent nécessiter une copie manuelle.

Les succès sont désactivés

Activer le moindre mod Workshop coupe le suivi des succès Steam. Jouez en vanilla pour les compléter.

Le co-op exige des mods identiques

Les quatre joueurs doivent charger les mêmes mods dans le même ordre, sinon le lobby se désynchronise immédiatement. BetterSpire2 Lite fait partie des rares options compatibles MP.

Particularités macOS

Lancez le jeu depuis le Finder avec Rosetta activé. Démarrer via Steam contourne le réglage Rosetta et fait crasher le jeu sur Mac quand des mods sont actifs.

Désinstaller un mod

  1. 1

    Fermez complètement le jeu.

  2. 2

    Workshop : désabonnez-vous depuis la page du mod. Manuel : supprimez le dossier du mod dans mods/.

  3. 3

    Supprimez les config.json restants pour éviter qu'une ancienne configuration ne se recharge.

  4. 4

    Relancez le jeu.

Notes importantes

Les mods sont faits par des tiers — utilisez-les à vos risques. Sauvegardez avant de tester des mods expérimentaux, et signalez les bugs à l'auteur du mod, pas à Mega Crit.