Pourquoi Apprendre à Modder Ostranauts Change Tout
Ostranauts repose sur une promesse inhabituelle : chaque donnée du jeu est exposée en texte brut, ce qui signifie que modder Ostranauts est quelque chose que n'importe quel joueur peut apprendre sans compiler un seul script. Le jeu est sorti sur Steam avec une version 1.0 publique le 3 août 2026, et le développeur Blue Bottle Games a documenté la structure sous-jacente en .json et .txt afin que la communauté puisse rééquilibrer les prix, repenser les intérieurs et ajouter de toutes nouvelles pièces de vaisseau sans jamais toucher au moteur.
Modder Ostranauts est important parce que le jeu de base est livré dans un univers néo-noir néon délibérément austère où chaque marchand, chaque plaque de coque et chaque tasse de café est piloté par les données. Lorsque vous apprenez le flux de travail, vous pouvez ajuster les besoins de l'équipage, augmenter les salaires des métiers impopulaires, ou rééquilibrer le prêt K-Leg pour qu'une nouvelle partie ne ressemble plus à un servage pour dettes. Selon les données communautaires sur le wiki officiel, la même approche s'adapte aussi bien à un patch d'équilibrage de cinq minutes qu'à des refontes totales qui remplacent l'intégralité de l'économie.
Un point que les vétérans soulignent est que modder Ostranauts est plus important que n'importe quelle interface de jeu ne le suggère, car il n'y a aucun navigateur intégré, aucun Steam Workshop, et aucun menu de mods dans l'écran de pause. Tout ce que vous faites se passe dans le système de fichiers, ce qui paraît intimidant mais rend en réalité le flux de travail plus facile à déboguer une fois que vous le comprenez. Un patch .json mal placé peut être édité dans n'importe quel outil de texte brut, déposé dans le dossier Steam, et testé au prochain rechargement sans jamais redémarrer le client du jeu.
Cette accessibilité explique pourquoi l'écosystème du modding Ostranauts a grandi régulièrement tout au long de l'Accès Anticipé, avec des patches communautaires allant d'un simple ajustement du prix du café à des refontes complètes de l'IA de l'équipage qui changent la façon dont les PNJ se disputent, dorment et demandent des augmentations. Parce que le développeur a déclaré publiquement que le support des mods restera une priorité post-1.0, le flux de travail couvert ici ne devrait pas changer radicalement après le lancement — une base stable qui fait que le temps que vous investissez à l'apprendre sera rentable à travers les futures mises à jour.
Préparer les Fichiers de Votre Jeu pour le Modding
Avant de toucher à un dossier, vous avez besoin d'une base propre. Une installation fraîche du jeu se trouve dans le répertoire common de Steam, et vos fichiers de sauvegarde vivent dans un chemin UserData séparé — confondre les deux risque d'effacer une carrière de 200 heures après un seul mauvais clic.
| Dossier ou Fichier | Emplacement par Défaut (Windows) | Rôle |
|---|---|---|
| Installation du jeu | Steam\steamapps\common\Ostranauts\ | Binaires, dossiers d'assets, données de base |
| UserData (sauvegardes) | %USERPROFILE%\AppData\LocalLow\Blue Bottle Games\Ostranauts\ | Sauvegardes de carrière, paramètres, captures d'écran |
| Dossier des mods | <install>\Ostranauts_Data\StreamingAssets\Mods\ | Surcharges .json créées par le joueur |
| Journal de plantage | <install>\Ostranauts_Data\output_log.txt | Premier réflexe pour tout dépannage de mods |
Sauvegarder les Sauvegardes et les Fichiers
Copiez l'intégralité du dossier de sauvegarde Ostranauts sur un disque de sauvegarde daté avant d'ajouter un mod. Les tests de la communauté montrent qu'une sauvegarde corrompue n'apparaît souvent qu'après la prochaine sauvegarde automatique, moment où votre dernière version propre est celle que vous avez faite manuellement. Une seconde copie de l'intégralité de l'installation common\Ostranauts est une bonne assurance si vous prévoyez d'éditer les fichiers de données de base en place.
Vérifier l'Intégrité du Jeu
Après la sauvegarde, faites un clic droit sur le jeu dans Steam, choisissez Propriétés → Fichiers installés → Vérifier l'intégrité des fichiers du jeu. Cela remplace tout fichier de base que Steam estime cassé et vous donne un point de comparaison fiable. Sauter cette étape est la raison la plus courante pour laquelle les joueurs blâment un mod pour des plantages causés en réalité par un téléchargement partiel ou une mise à jour interrompue.
Installer le Chargeur de Mods et la Structure de Dossiers
Ostranauts n'est pas livré avec un chargeur de mods tiers comme le font les titres Bethesda ou Paradox. Le « chargeur » est simplement le dossier Mods sous StreamingAssets, et tout .json ou .txt compatible placé à l'intérieur est appliqué automatiquement au prochain lancement.
Étape 1 — Localiser le Dossier du Jeu
Ouvrez Steam, faites un clic droit sur Ostranauts, cliquez sur Gérer → Parcourir les fichiers locaux. La fenêtre qui s'ouvre est votre dossier racine d'installation ; à l'intérieur vous verrez Ostranauts.exe, un répertoire _Data, et un UnityCrashHandler64.exe. Le dossier des mods se trouve dans cette structure et est créé automatiquement au premier lancement du jeu en version 1.0.0.7 ou ultérieure, bien que plusieurs builds pré-1.0 aient déjà créé le répertoire à la première sauvegarde.
Étape 2 — Créer ou Confirmer le Répertoire des Mods
Naviguez vers Ostranauts_Data\StreamingAssets\Mods. Si le dossier est manquant, créez-le manuellement avec exactement la casse indiquée — Windows autorise les variantes en minuscules mais le jeu a été observé les ignorant sur certaines installations Linux/Proton. À l'intérieur de ce dossier, chaque mod vit dans son propre sous-répertoire pour que l'ordre de chargement et l'isolation puissent être contrôlés proprement.
| Disposition du Dossier de Mods | Chemin Exemple | Notes |
|---|---|---|
| Fichier unique | Mods\MyMod\my_mod.json | Patch le plus simple — une seule surcharge déposée |
| Pack multi-fichiers | Mods\MyMod\data\items.json | Réplique la structure du dossier de base pour les mods partiels |
| Surcharge en vrac | Mods\balance\*.json | Pratique pour des tests d'équilibrage rapides |
| Désactivé (renommé) | Mods\-MyMod\ | Le jeu ignore les dossiers commençant par - |
Pour un guide plus avancé sur les packs multi-fichiers et les balises de fusion, le guide de création d'un mod personnalisé explique comment l'analyseur rapproche les entrées qui se chevauchent, tandis que notre primer d'installation de mods couvre le même processus depuis la perspective de la bibliothèque Steam pour les joueurs qui préfèrent garder leur dossier de jeu intact.
Localiser les Fichiers de Données du Jeu que Vous Allez Éditer
Chaque nombre que vous pouvez ajuster se trouve dans un fichier .json sous le répertoire StreamingAssets de base. L'astuce est de savoir quel fichier possède quel système pour que vous ne puissiez écraser que le champ que vous avez l'intention de modifier.
| Fichier de Données | Fragment de Chemin Approx. | Contient |
|---|---|---|
items.json | StreamingAssets\Data\ | Biens commerciaux, armes, pièces, nourriture, boisson |
rooms.json | StreamingAssets\Data\ | Tuiles de coque, objets d'intérieur, points de montage |
crewData.json | StreamingAssets\Data\ | Noms des PNJ, décroissance des besoins, stats de base |
econ.json | StreamingAssets\Data\ | Cash de départ, conditions de prêt, taux de salaire |
jobs.json | StreamingAssets\Data\ | Paiements de contrats, pondérations de planning |
Un flux de travail utile consiste à copier le fichier que vous voulez éditer dans votre dossier de mod, puis à supprimer toutes les clés sauf celles que vous voulez modifier. Le jeu effectue un remplacement complet du fichier, donc une surcharge allégée avec seulement deux ou trois champs fusionnés dans les données de base est plus stable qu'une copie avec 5 000 lignes intactes, où une virgule égarée peut casser l'intégralité de l'analyseur JSON et briquer votre jeu au lancement. Les joueurs qui sont encore à l'aise avec la boucle de base peuvent revisiter l'économie vanilla dans notre guide débutant et la comparer à leurs valeurs moddées une fois que les modifications commencent à prendre effet.
Comprendre l'Ordre de Chargement et la Résolution des Conflits
Une fois qu'un mod se trouve dans le bon dossier, le chargement est automatique — il n'y a aucune case de gestionnaire de mods en jeu dans la version 1.0.0.7. Le jeu lit le répertoire Mods par ordre alphabétique au démarrage, donc un dossier nommé zzzz_last gagne toujours sur un dossier nommé aaa_first pour tout champ qu'ils définissent tous les deux.
| Règle d'Ordre de Chargement | Effet | Cas d'Usage |
|---|---|---|
| Priorité alphabétique | A_mod perd contre Z_mod sur les clés partagées | Comportement par défaut |
| Préfixe numérique | 00_core, 01_balance, 99_override | Contrôle manuel par le nommage |
| La dernière écriture gagne | L'horodatage le plus récent de la fiche écrase | Patches expérimentaux rapides |
Si vous voulez une désactivation temporaire sans supprimer le dossier, préfixez le nom du répertoire avec un trait d'union, par exemple -MyMod. Le jeu ignore tout dossier dont le nom commence par un trait d'union parce que le préfixe marque l'arborescence entière comme un stub désactivé. Cette astuce est la façon la plus propre de faire des tests A/B des changements d'équilibrage par rapport à la base vanilla pendant les longues carrières, ce qui explique aussi pourquoi la plupart des joueurs vétérans s'en remettent à elle plutôt que de déplacer des fichiers dans et hors du répertoire à répétition.
Les tests de la communauté suggèrent que l'ordre des fichiers à l'intérieur d'un seul dossier de mod n'a pas d'importance — seul le nom du dossier détermine sa position de chargement par rapport aux autres mods. Cela rend les structures de dossiers profondes sûres pour l'organisation, mais mauvaises pour contrôler quel patch « gagne » dans un conflit.
Créer et Tester Votre Premier Mod .json
Commencez petit : choisissez un nombre qui vous dérange, copiez l'entrée concernée dans votre dossier de mod, changez la valeur, enregistrez, et relancez. Un mod de test fonctionnel prend moins de cinq minutes et prouve que chaque maillon de la chaîne est fonctionnel avant que vous n'investissiez dans un projet plus important.
Éditer un Fichier .json
Ouvrez n'importe quel .json dans un éditeur de code comme VS Code ou Notepad++ — n'utilisez jamais Word ou des éditeurs de texte enrichi, parce qu'ils insèrent silencieusement des guillemets typographiques que l'analyseur JSON rejettera. Ne modifiez que les champs que vous comprenez entièrement ; une ligne de items.json pour Coffee contient le prix, la masse, la restauration de soif, et une référence de sprite, donc ne modifier que price laisse le reste intact. Selon les commentaires du développeur sur le wiki officiel, les mêmes règles d'analyse s'appliquent que vous éditiez une seule ligne ou un pack de 10 000 lignes.
Sauvegarder le Mod de Test
Enregistrez le fichier édité en .json UTF-8 brut et placez-le dans Mods\TestMod\data\items.json. Lancez le jeu, chargez une sauvegarde, et vérifiez si la valeur que vous avez modifiée se comporte comme prévu sur le marché K-Leg. Si le jeu ne démarre pas, le coupable le plus probable est une erreur de syntaxe dans votre JSON ; passer le fichier dans un validateur en ligne gratuit attrape 90% des fautes de frappe en quelques secondes.
Dépanner les Problèmes Courants de Modding
Même avec une installation propre, les mods peuvent casser le jeu de façon subtile qui ressemble à des bugs vanilla. Avant de blâmer un mod unique, reproduisez toujours le problème avec le dossier Mods temporairement renommé en -Mods.
| Symptôme | Cause Probable | Correctif |
|---|---|---|
| Le jeu ne se lance pas | JSON invalide dans un fichier de mod | Validez chaque .json ; isolez en renommant le dossier |
| Les modifications n'apparaissent pas | Mauvais chemin de fichier dans le dossier du mod | Répliquez exactement la structure StreamingAssets\Data de base |
| Chevauchement partiel (certains items fonctionnent) | Conflit d'ordre de chargement entre deux mods | Renommez le dossier gagnant avec un préfixe 99_ |
| Plantage à l'amarrage en station | Données de pièce ou de navigation écrasées | Vérifiez les surcharges de rooms.json ; revenez au vanilla et réessayez |
| Sauvegarde chargée mais économie cassée | Surcharge partielle d'econ.json avec champ manquant | Fusionnez les champs manquants depuis vanilla au lieu de remplacer le fichier entier |
Si un seul mod brique votre installation, vous pouvez généralement récupérer en supprimant le dossier fautif, puis en renommant -Mods en Mods. Pour des stratégies de récupération plus approfondies quand une sauvegarde de carrière est déjà au bord du gouffre, le guide comment récupérer des vaisseaux couvre les options de récupération en jeu qui vous permettent de reconstruire après un crash économique induit par un mod.
Si vous êtes encore en train d'apprendre ce que le jeu de base est censé ressentir, notre guide de jeu Ostranauts comment jouer donne une vue côte à côte du comportement vanilla pour que vous puissiez repérer les régressions plus vite que par essais et erreurs.
Questions Fréquentes
Ai-je besoin d'un gestionnaire de mods séparé pour modder Ostranauts ?
Non. À partir de la version 1.0 du 3 août 2026, le jeu lit un simple dossier Mods à l'intérieur du répertoire d'installation. Tout .json ou .txt compatible placé là se charge automatiquement au prochain lancement — aucun lanceur tiers requis.
Où se trouve le dossier des mods d'Ostranauts ?
Il se trouve à <install>\Ostranauts_Data\StreamingAssets\Mods\, où <install> est votre racine Steam common\Ostranauts. Si le dossier n'existe pas, créez-le avec l'orthographe exacte indiquée, parce que les installations Proton et Linux ont été signalées comme ignorant les variantes en minuscules.
Les mods peuvent-ils corrompre mes sauvegardes ?
Oui, si vous écrasez econ.json ou crewData.json en cours de carrière avec des valeurs que la sauvegarde ne peut plus réconcilier. Sauvegardez toujours le dossier %USERPROFILE%\AppData\LocalLow\Blue Bottle Games\Ostranauts\ avant d'appliquer des modifications qui affectent les besoins de l'équipage, les salaires, ou les conditions de prêt.
Comment désactiver un mod sans le supprimer ?
Préfixez son nom de dossier avec un trait d'union, par ex. -MyMod. Le jeu ignore tout dossier commençant par -, ce qui rend les tests A/B des patches d'équilibrage bien plus rapides que de déplacer des fichiers dans et hors du répertoire.
Quel est le premier mod le plus sûr à essayer quand on apprend à modder Ostranauts ?
Une édition de prix sur une seule ligne dans items.json est le point de départ le plus sûr parce que son effet apparaît dès la toute prochaine visite du marché K-Leg. Une fois que votre édition fait l'aller-retour proprement, vous pouvez passer à des packs multi-fichiers et à des projets de conversion totale en toute confiance.