Mods: meilleurs mods et installation Guide

Les mods sont des paquets créés par les utilisateurs qui modifient ou étendent shapez 2 — allant d’utilitaires simples améliorant la qualité de vie à de nouvelles machines, fonctionnalités de jeu, traductions ou scénarios personnalisés. Le jeu prend en charge les mods nativement et utilise une structure de dossiers définie pour faciliter l’installation, le développement et le partage des mods.

Emplacement des mods et des données persistantes

• Le jeu stocke les données persistantes (y compris les mods, les scénarios personnalisés, les presets et les données de base exportées) dans le dossier Game Data Folder (a.k.a. Game Data ou dossier de sauvegarde/jeu).
• Chemins :
  • Windows: %USERPROFILE%\AppData\LocalLow\tobspr Games\shapez 2\
  • MacOS: ~/Library/Application Support/tobspr Games/shapez 2/
  • Linux: ~/.config/unity3d/tobspr Games\shapez 2/
• Ouvrir le dossier depuis le jeu :
  • Menu principal → Play → Show Folder, puis remonter d’un niveau.
  • En jeu → Blueprint Library → Open Folder, puis remonter d’un niveau.
  • Commandes du Debug Console : logs.open-folder ou savegames.open-folder (remarque : MacOS utilise Player.log pour certains journaux).

Structure du dossier mods et installation

• Le dossier mods situé dans le Game Data Folder est l’endroit où placer les mods pour que le jeu les charge localement.
• Chaque mod est un sous-dossier à l’intérieur du dossier mods. Le jeu chargera chaque sous-dossier comme un mod séparé.
• Les mods du Steam Workshop sont pris en charge et seront téléchargés automatiquement lorsque vous vous y êtes abonné via le Workshop.

Ressources et outils pour le modding

• Ressources officielles et communautaires :
  • Documentation officielle du modding et directives d’art/ressources fournie par le développeur.
  • Des mods d’exemple et le dépôt Shapez Shifter (modding API) sont disponibles sur GitHub.
  • Une documentation communautaire non officielle existe pour compléter les docs officielles.
  • Documentation d’outils tiers utiles : MonoMod RuntimeDetour et HarmonyX pour le détournement et le patching à l’exécution.
• Le jeu utilise Unity (version Unity spécifique indiquée dans la doc) et une modding API (ShapezShifter) pour simplifier l’intégration ; aucun chargeur de mods externe n’est requis.
• Des références d’assemblage et de classes sont disponibles pour un développement et un débogage plus poussés.

Exportation des données du jeu à réutiliser dans un mod

• Le jeu peut exporter ses données internes (contenu de base comme entités, scénarios, presets) pour réutilisation ou référence :
  • En jeu, ouvrez le debug console (F1) et exécutez debug.export-game-data.
  • Cela crée un dossier nommé basedata- dans le Game Data Folder. Utilisez les fichiers qui s’y trouvent comme modèles pour du contenu JSON personnalisé.

Scénarios personnalisés, presets et difficultés

• Scénarios personnalisés :
  • Placez les fichiers JSON de scénarios dans le dossier custom-scenarios du Game Data Folder pour que le jeu les charge.
  • Les fichiers de scénarios exportés depuis le jeu apparaissent dans le dossier scenarios d’un dossier basedata exporté.
• Presets de scénarios personnalisés :
  • Mettez les fichiers JSON de presets de paramètres de scénario dans custom-scenario-parameter-presets dans le Game Data Folder.
  • Les presets de scénarios en jeu se trouvent dans scenario-parameter-presets des dossiers basedata exportés.
  • Lors de la sélection d’un Scenario, le premier Scenario Preset dans la liste interne qui pointe vers ce Scenario est sélectionné par défaut.
• Presets de difficulté personnalisés :
  • Le jeu ne supporte pas actuellement le chargement direct de presets de difficulté personnalisés en tant que fichiers JSON. Vous pouvez toutefois consulter les presets de difficulté en jeu dans le dossier difficulty-presets d’un dossier basedata exporté.

Traductions personnalisées

• Pour charger des traductions personnalisées, créez un fichier translations-override.json avec le même format que translations-en-US.json et placez-le à l’emplacement attendu par le jeu.
• Lancez le jeu avec l’argument en ligne de commande --custom-translations pour qu’il charge le fichier d’override.
• Le LanguageTitle à l’intérieur du fichier est ignoré ; la langue apparaîtra comme « Custom » dans les paramètres de langue. Les clés manquantes retomberont sur l’anglais.

Flux de travail de développement et débogage

• Flux de travail typique :
  • Exportez les données de base du jeu pour utiliser les JSON existants comme modèles.
  • Créez un sous-dossier de mod avec vos assets, votre code et vos définitions JSON en suivant la documentation et les directives d’art.
  • Utilisez la modding API (ShapezShifter) ou des bibliothèques de patching à l’exécution si vous devez modifier le comportement du code.
  • Testez localement en plaçant le dossier du mod dans le répertoire mods et en lançant le jeu.
• Le Debug Console est disponible en jeu pour les commandes et la résolution des problèmes.
• Les docs sur le débogage et le patching à l’exécution ainsi que des exemples communautaires (mods d’exemple) sont des références recommandées.

Publication et partage des mods

• Steam Workshop :
  • Les mods peuvent être publiés sur le Steam Workshop pour une distribution automatique.
• Partage communautaire :
  • Le partage de blueprints et de contenu se fait également via le site Community Vortex et le Discord officiel (#🛠blueprints).
• Respectez les directives de publication et d’utilisation des assets du jeu lorsque vous publiez afin d’éviter conflits ou ressources corrompues.

Sujets et considérations avancées

• Sujets pertinents du modding couverts dans la documentation :
  • Modding Overview, Development Environment, Mod Loading, Debugging, Mod Publishing, Command Line Arguments, Game Files, Custom Game Modes, Debug Console.
• Utilisez les mods d’exemple fournis et les références API pour apprendre les modèles et bonnes pratiques.
• Lorsque vous modifiez ou ajoutez du contenu au format JSON (scénarios, presets, traductions), assurez-vous que les noms de fichiers et leur emplacement correspondent aux dossiers attendus décrits ci‑dessus afin que le jeu les reconnaisse.

Liste de vérification rapide pour commencer

• Exporter les données de base : ouvrir debug console → debug.export-game-data.
• Créer un dossier de mod dans Game Data Folder/mods/ et y ajouter votre contenu.
• Pour les scénarios ou presets personnalisés, placer les JSON dans custom-scenarios ou custom-scenario-parameter-presets respectivement.
• Pour les traductions, créer translations-override.json et lancer le jeu avec --custom-translations.
• S’abonner/publier sur le Steam Workshop pour partager ou recevoir des mods.
• Consulter la documentation officielle du modding, les mods d’exemple et ShapezShifter pour des exemples de code et l’utilisation de l’API.