ModdingintermediateMis à jour: 04/08/2026

Ostranauts Comment Modder : Tutoriel de Modding Étape par Étape

Apprenez à modder Ostranauts de zéro — installer le chargeur de mods, localiser les dossiers du jeu, activer les patches .json et résoudre les conflits d'ordre de chargement.

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 FichierEmplacement par Défaut (Windows)Rôle
Installation du jeuSteam\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.txtPremier 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 ModsChemin ExempleNotes
Fichier uniqueMods\MyMod\my_mod.jsonPatch le plus simple — une seule surcharge déposée
Pack multi-fichiersMods\MyMod\data\items.jsonRéplique la structure du dossier de base pour les mods partiels
Surcharge en vracMods\balance\*.jsonPratique 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éesFragment de Chemin Approx.Contient
items.jsonStreamingAssets\Data\Biens commerciaux, armes, pièces, nourriture, boisson
rooms.jsonStreamingAssets\Data\Tuiles de coque, objets d'intérieur, points de montage
crewData.jsonStreamingAssets\Data\Noms des PNJ, décroissance des besoins, stats de base
econ.jsonStreamingAssets\Data\Cash de départ, conditions de prêt, taux de salaire
jobs.jsonStreamingAssets\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 ChargementEffetCas d'Usage
Priorité alphabétiqueA_mod perd contre Z_mod sur les clés partagéesComportement par défaut
Préfixe numérique00_core, 01_balance, 99_overrideContrôle manuel par le nommage
La dernière écriture gagneL'horodatage le plus récent de la fiche écrasePatches 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ômeCause ProbableCorrectif
Le jeu ne se lance pasJSON invalide dans un fichier de modValidez chaque .json ; isolez en renommant le dossier
Les modifications n'apparaissent pasMauvais chemin de fichier dans le dossier du modRépliquez exactement la structure StreamingAssets\Data de base
Chevauchement partiel (certains items fonctionnent)Conflit d'ordre de chargement entre deux modsRenommez le dossier gagnant avec un préfixe 99_
Plantage à l'amarrage en stationDonnées de pièce ou de navigation écraséesVérifiez les surcharges de rooms.json ; revenez au vanilla et réessayez
Sauvegarde chargée mais économie casséeSurcharge partielle d'econ.json avec champ manquantFusionnez 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.