Intrdouction à ModTheSpire

ModTheSpire est un chargeur de mods externe pour le jeu Slay the Spire, permettant de personnaliser l'expérience sans altérer les fichiers originaux du jeu. Cet outil open-source facilite l'intégration de mods tels que de nouveaux personnages, cartes, ou améliorations d'interface, offrant une flexibilité étendue pour les joueurs et les développeurs.

Prérequis et Installation

Avant de commencer, assurez-vous que votre système répond aux exigences suivantes :

• Environnement Java 8 (JDK 1.8) installé.
• Version à jour de Slay the Spire.
• Au moins 500 Mo d'espace disque disponible.
• Permissions de lecture/écriture sur le répertoire du jeu.

Obtenez ModTheSpire via l'une des méthodes ci-dessous :

Téléchargement direct

git clone --depth 1 https://gitcode.com/gh_mirrors/mo/ModTheSpire

Compilation depuis le code source

cd ModTheSpire
./mvnw package -DskipTests

Le fichier JAR généré se trouvera dans le répertoire target/.

Déploiement des fichiers

Copiez les fichiers nécessaires dans le répertoire d'installation de Slay the Spire. La structure doit ressembelr à ceci :

Répertoire_Jeu_SlayTheSpire/
├── ModTheSpire.jar
├── lancement.cmd
├── lancement.sh
├── desktop-1.0.jar
└── mods/  # Créez ce dossier manuellement

Le dossier mods/ est essentiel pour stocker tous les fichiers de mods.

Configuration du lancement

Adaptez les scripts de lancement selon votre système d'exploitation :

Pour Windows

Modifiez lancement.cmd comme suit :

@echo off
start javaw -Xmx2048m -jar ModTheSpire.jar --fullscreen

Pour Linux/macOS

Éditez lancement.sh avec les permissions d'exécution :

#!/bin/bash
java -Xmx2048m -jar ModTheSpire.jar --splash=false

Optimisez la mémoire en fonction de votre configuration système :

Gestion des mods

Pour une organisation efficace, classez vos mods dans des sous-dossiers thématiques :

mods/
├── noyaux/           # Framework comme BaseMod
├── personnages/      # Extensions de personnages
├── cartes/           # Nouvelles cartes
├── reliques/         # Systèmes de reliques
├── interface/        # Améliorations visuelles
└── experimental/     # Mods en test

L'ordre de chargement est crucial pour éviter les conflits :

1. Chargez d'abord les frameworks (ex. BaseMod).
2. Ensuite, les bibliothèques utilitaires.
3. Puis, les mods de contenu (personnages, cartes).
4. Enfin, les mods d'interface.

Dépannage et diagnostics

En cas de problèmes, consultez les fichiers journaux emplacements suivants :

• Windows : %APPDATA%/ModTheSpire/logs/
• Linux/macOS : ~/.config/ModTheSpire/logs/

Exemples de messages clés dans les logs :

[INFO] Chargement du mod : BaseMod.jar
[ERREUR] Dépendance manquante : StSLib
[AVERTISSEMENT] Conflit de patch détecté

Pour résoudre les conflits de mods, procédez par isolation : activez un seul mod à la fois, vérifiez les versions et les dépendances, puis réorganisez l'ordre de chargement.

Configuration avancée

Utilisez des paramètres de lancement spécialisés pour différents scénarios :

Mode rapide (sans interface)

java -Xmx2048m -Dmts.skip-ui=true -jar ModTheSpire.jar

Mode debug

java -Xmx2048m -Dmts.debug=true -Dmts.log-level=DEBUG -jar ModTheSpire.jar

Optimisation des performances

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

Maintenance et sauvegardes

Automatisez la sauvegarde de vos configurations de mods avec un script :

#!/bin/bash
# Script de sauvegarde des mods
DESTINATION="~/sauvegardes_mts/$(date +%Y%m%d_%H%M%S)"
mkdir -p $DESTINATION
cp -r ~/.config/ModTheSpire $DESTINATION/
echo "Sauvegarde effectuée dans $DESTINATION"

Suivez ces pratiques pour une stabilité accrue :

• Vérifiez régulièrement les mises à jour des mods.
• Testez les mises à jour de manière isolée.
• Conservez des versions antérieures stables.

En appliquant ces techniques, vous maximiserez la fiabilité et les performances de votre installation ModTheSpire pour Slay the Spire.