Qu'est-ce que ModTheSpire et pourquoi l'utiliser ?

ModTheSpire est un chargeur de mods externe pour Slay the Spire. Il agit comme une couche d'abstraction entre le jeu de base et les modules tiers, permettant d'ajouter cartes, personnages, mécaniques et bien plus encore. Ce projet open source offre un cadre sécurisé et stable pour la gestion des mods.

Fonctionnalités clés

• Isolation des modules : chaque mod s'exécute dans son propre espace mémoire, évitant les interférences.
• Gestion des dépendances : résolution automatique des dépendances entre mods.
• Vérification de compatibilité : contrôle de version entre le mod et le jeu.
• Ordre de chargement : possiiblité de définir la priorité de chaque mod.

Prérequis système

Avant de commencer, vérifiez que votre environnement respecte ces conditions :

• Système : Windows 7/8/10/11 ou Linux (distribution récente).
• Java : JDK 8 ou version ultérieure.
• Jeu : version officielle de Slay the Spire (mise à jour comprise).
• Espace disque : au moins 2 Go libres.

Pour valider l'installation Java, exécutez dans un terminal :

java -version

Si vous obtenez un message comme java version "1.8.0_xxx" ou supérieur, l'environnement est prêt.

Construction de l'environnement de développement

1. Récupération et compilation des sources

Clonez le dépôt et compilez avec Maven :

git clone https://gitcode.com/gh_mirrors/mo/ModTheSpire
cd ModTheSpire
./mvnw clean compile package

Vérifiez la présence du fichier ModTheSpire-XXX.jar dans le dossier target (XXX est le numéro de version).

2. Déploiement dans le dossier du jeu

Copiez le fichier JAR dans le répertoire du jeu :

1. Créez un dossier mods à la racine du jeu.
2. Copiez le JAR depuis target vers ce dossier.
3. Copiez le script de lancemetn (MTS.cmd sous Windows, MTS.sh sous Linux) présent à la racine du projet vers le dossier du jeu.

Lancez le script : si l'interface de gestion des mods apparaît, la configuration est réussie.

Installation et gestion des mods

Installer un premier mod

1. Téléchargez le fichier JAR du mod depuis une source fiable.
2. Placez-le dans jeu/mods/.
3. Lancez ModTheSpire, cochez le mod dans la liste.
4. Ordonnez les mods par glisser-déposer (le mod dépendant doit être chargé après son dépendant).

Vérifiez que le nouveau contenu apparaît dans le menu principal du jeu.

Résoudre les conflits entre mods

Utilisez la méthode de dichotomie :

1. Désactivez tous les mods et vérifiez la stabilité du jeu.
2. Activez la moitié des mods et testez.
3. Répétez jusqu'à identifier le mod problématique.
4. Réorganisez l'ordre de chargement ou remplacez le mod par une version compatible.

Si le jeu démarre sans erreur et que les fonctionnalités sont présentes, le conflit est résolu.

Erreurs fréquentes à éviter

• Version Java inappropriée : utilisez JDK 8, version la plus stable pour ModTheSpire.
• Mauvais emplacement des mods : les JAR doivent être dans mods/, pas à la racine du jeu.
• Dépendances manquantes : lisez la documentation du mod pour installer tous ses prérequis.
• Trop de mods actifs : limitez-vous à 10 mods simultanés pour éviter les ralentissements et les conflits.
• Inadéquation de version : vérifiez que le mod est compatible avec votre version du jeu avant de l'installer.

Astuces avancées pour optimiser l'expérience

Personnaliser les paramètres JVM

Modifiez le script de lancement pour ajouter des options :

java -Xmx3g -Xms2g -XX:+UseG1GC -XX:MaxGCPauseMillis=200 -jar ModTheSpire.jar

Explication :

• -Xmx3g : mémoire maximale allouée à la JVM (3 Go).
• -Xms2g : mémoire initiale (2 Go).
• -XX:+UseG1GC : active le ramasse-miettes G1 pour une meilleure gestion mémoire.
• -XX:MaxGCPauseMillis=200 : limite les pauses à 200 ms.

Surveillez l'utilisation mémoire via le gestionnaire de tâches pour constater les améliorations.

Sauvegarder la configuration des mods

Copiez régulièrement le fichier de configuration :

cp mods/mods.json mods/mods_$(date +%Y%m%d).json.bak

Pour restaurer, renommez le fichier de sauvegarde en mods.json.

Ressources et communauté

Consultez le Wiki du projet pour l'API et les guides de développement. Rejoignez les forums d'entraide et les plateformes de partage de mods pour découvrir de nouvelles extensions et échanger avec d'autres créateurs.