Presque chaque ajustement que vous voudrez effectuer dans Ostranauts — qu'il s'agisse de modifier les salaires de l'équipage ou de rééquilibrer les coûts des pièces de vaisseau — commence au même endroit : les fichiers de données de modding Ostranauts qui reposent tranquillement dans votre répertoire local du jeu. Parce que Blue Bottle Games distribue la grande majorité de son contenu sous forme de texte brut lisible par l'humain, vous n'avez pas besoin d'un SDK spécial, d'un compilateur personnalisé, ni même d'un éditeur hexadécimal pour commencer à personnaliser votre expérience.
Ce guide vous accompagne pour localiser ces fichiers, les lire en toute sécurité, les éditer avec confiance et éviter les pièges les plus courants qui entraînent la corruption des sauvegardes ou les conflits entre mods.
Ce que sont les fichiers de données de modding Ostranauts et pourquoi ils comptent
Ostranauts repose sur une architecture orientée données, ce qui signifie que le moteur lui-même contient très peu de contenu codé en dur. Les objets, les PNJ, les métiers, les événements, les économies, les modules de vaisseau, les dialogues et même les valeurs de réglage physique vivent dans des fichiers texte brut externes que le jeu lit à chaque démarrage. Pour les joueurs, c'est un cadeau : les mêmes fichiers que le développeur utilise pour publier le jeu sont ceux que vous modifierez en tant que moddeur.
L'avantage du texte brut pour les moddeurs
Contrairement aux jeux qui verrouillent leur contenu derrière des archives opaques ou des blobs chiffrés, les fichiers de données de modding Ostranauts peuvent être ouverts dans n'importe quel éditeur de texte. Notepad++, VS Code et Sublime Text les gèrent tous sans plugins spéciaux. Cette transparence signifie :
- Une faute de frappe dans un champ de prix est évidente au moment où vous rechargez votre sauvegarde.
- Vous pouvez utiliser
Ctrl+Fdans tout le dossier de données pour trouver un objet, une statistique ou un déclencheur spécifique. - Les outils de diff comme WinMerge ou Beyond Compare rendent les vérifications de compatibilité des mods rapides.
- Les moddeurs débutants peuvent apprendre en lisant les valeurs du développeur au lieu de deviner.
La contrepartie est qu'un seul caractère égaré peut empêcher le chargement, donc la discipline compte plus que l'outillage.
Les risques que tout moddeur doit respecter
Parce que le jeu fait totalement confiance à ces fichiers, les erreurs se propagent instantanément. Les symptômes courants d'une mauvaise édition incluent un écran noir au lancement, une icône de chargement infinie ou un fichier de sauvegarde qui refuse de se désérialiser. Sauvegardez toujours les fichiers de données de modding Ostranauts originaux avant toute modification, et traitez le dossier core comme du matériel de référence en lecture seule sauf si vous avez l'intention spécifique de le remplacer.
| Type de risque | Symptôme | Prévention |
|---|---|---|
| Erreur de syntaxe en JSON/CSV | Le jeu ne se lance pas | Utilisez un éditeur avec correspondance des crochets |
| Mauvais type de données (chaîne vs nombre) | L'objet se charge mais est invisible | Validez avec un linter JSON |
| Mauvais encodage (BOM, UTF-16) | Première clé ignorée silencieusement | Enregistrez en UTF-8 sans BOM |
| ID en doublon entre mods | Le dernier mod gagne, le contenu disparaît | Maintenez une feuille d'ordre de chargement des mods |
Structure du dossier central des fichiers de données de modding Ostranauts
Avant d'éditer quoi que ce soit, vous devez savoir où vivent réellement les fichiers. La structure est restée stable depuis le lancement en accès anticipé du jeu, et les wikis communautaires comme le wiki officiel Ostranauts sur wiki.gg tiennent une carte à jour de chaque sous-dossier.
Localiser le répertoire d'installation Steam
Sur Windows, le chemin par défaut ressemble à peu près à ceci :
C:\Program Files (x86)\Steam\steamapps\common\Ostranauts\ostranauts_Data\StreamingAssets\
Le dossier StreamingAssets est l'endroit où le moteur récupère presque tout à l'exécution. À l'intérieur, vous trouverez un mélange de feuilles de calcul de style CSV, de manifestes JSON et de quelques fragments de scripts de style Lua. Les utilisateurs Linux et macOS verront la même hiérarchie sous leurs racines de bibliothèque Steam respectives, puisque le projet est livré comme une build Unity avec des chemins de données agnostiques à la plateforme.
Sous-dossiers clés et leurs rôles
Les fichiers de données de modding Ostranauts sont organisés en compartiments thématiques. Le tableau ci-dessous résume les dossiers que la plupart des moddeurs touchent au cours de leur premier mois.
| Sous-dossier | Type de contenu | Cas d'usage du moddeur |
|---|---|---|
Blueprints/ | Coques de vaisseau et modèles de salles | Ajuster la capacité de fret, la masse de coque |
NPCs/ | Génération d'équipage, traits, historiques | Ajouter des personnages embauchables personnalisés |
Economy/ | Biens commerciaux, prix, courbes d'offre | Rééquilibrer les boucles commerciales K-Leg |
Events/ | Rencontres aléatoires et déclencheurs | Écrire de nouveaux moments d'histoire |
Items/ | Pièces, consommables, manifestes de fret | Modifier les tailles de pile, les poids |
Strings/ | Dialogues et étiquettes localisables | Traduire ou réécrire les textes d'ambiance |
Un point de confusion courant : le dossier Blueprints contient à la fois des vaisseaux destinés au joueur et des épaves réservées aux PNJ. Filtrez par les commentaires d'en-tête de fichier — le développeur laisse des marqueurs propres — pour garder la portée de vos modifications limitée.
Comment le jeu résout les remplacements
Lorsque plusieurs sources définissent le même ID d'objet, Ostranauts utilise un modèle de priorité du dernier gagnant. Les fichiers du jeu de base se chargent en premier, puis tout sous-dossier Mods/ se charge par-dessus dans l'ordre alphabétique. Pour un comportement prévisible, nommez vos dossiers de mod avec un préfixe clair (par exemple ZZ_MyMod) pour qu'ils gagnent toujours, et documentez la priorité dans un readme.txt livré avec votre version.
Éditer les fichiers de données de modding Ostranauts en toute sécurité
Savoir où vivent les fichiers est la moitié du combat. L'autre moitié consiste à les éditer sans corrompre l'écosystème de sauvegardes qui en dépend.
Outils recommandés pour l'édition en texte brut
Vous n'avez pas besoin d'un IDE payant, mais les bons outils gratuits font une énorme différence pour détecter les erreurs tôt.
| Outil | Coût | Pourquoi il est utile |
|---|---|---|
| Visual Studio Code | Gratuit | Coloration syntaxique JSON/CSV, visualiseur de diff intégré |
| Notepad++ | Gratuit | Léger, recherche-remplacement regex, édition en colonnes |
| Python 3 + pandas | Gratuit | Validation en masse et modifications massives sur des centaines de fichiers |
| WinMerge | Gratuit | Diff visuel entre dossiers de données vanilla et moddés |
| Beyond Compare | Payant (essai) | Diff à trois voies pour résoudre les conflits de fusion |
Quel que soit l'éditeur que vous choisissez, configurez-le pour enregistrer les fichiers en UTF-8 sans marque d'ordre d'octets, utilisez des fins de ligne Unix ou Windows de manière cohérente, et n'activez jamais les « guillemets intelligents » — un apostrophe curly dans un nom d'objet peut faire crasher l'analyseur sur certains champs.
Flux de travail d'édition étape par étape
Un processus reproductible empêche la plupart des erreurs de débutant qui apparaissent sur les canaux Discord communautaires. Le flux de travail suivant est celui que les moddeurs expérimentés déclarent utiliser lors de l'équilibrage de refontes plus importantes.
- Étape 1 : Copiez tout le dossier
StreamingAssetsdans un répertoire_backupadjacent avant tout changement. - Étape 2 : Lancez le jeu une fois pour confirmer que la sauvegarde correspond à un état de démarrage connu comme bon.
- Étape 3 : Effectuez une seule modification ciblée dans votre fichier cible, puis fermez et relancez Ostranauts pour vérifier que le changement se charge.
- Étape 4 : Si le jeu se lance proprement, validez la modification dans un dossier versionné (par exemple
v01,v02) pour pouvoir revenir en arrière. - Étape 5 : Répétez les étapes 3–4 pour chaque ajustement suivant, en isolant les variables une à la fois.
Ce rythme itératif détecte les fautes de frappe avant qu'elles ne se transforment en heures de débogage. Il produit également un journal des modifications propre qui aide les autres moddeurs à comprendre ce que votre version fait réellement.
Si vous débutez dans la scène de modding au sens large, le tutoriel de modding Ostranauts couvre le cycle de vie plus large, y compris le conditionnement de votre premier mod pour le Steam Workshop.
Valider les modifications sans partie complète
Vous n'avez pas besoin de réaliser un trajet commercial complet pour vérifier une modification. Le moteur journalise les erreurs d'analyse dans Player.log (Windows : %AppData%\..\LocalLow\Blue Bottle Games\Ostranauts\). Cherchez dans ce fichier les chaînes JsonException ou MissingFieldException après chaque démarrage — si l'une d'elles apparaît, votre dernière modification est le principal suspect. Pour une validation structurelle plus profonde, associez vos modifications à un fichier de schéma JSON du guide de modding Ostranauts, qui passe en revue les types de champs pris en charge.
Ajustements courants que vous pouvez faire aux fichiers de données de modding Ostranauts
Une fois à l'aise avec l'édition de champs individuels, un univers de petits ajustements d'équilibrage devient disponible. Les exemples suivants sont tirés des demandes courantes de la communauté et constituent des points de départ sûrs pour les nouveaux moddeurs.
Ajuster les valeurs d'équipage, de vaisseau et d'économie
La plupart des changements d'équilibrage vivent dans une poignée de fichiers que le développeur garde intentionnellement plats. Voici un tableau de référence rapide des modifications de départ et des fichiers dans lesquels elles se trouvent.
| Objectif d'ajustement | Emplacement du fichier | Champ à modifier | Effet rapporté par la communauté |
|---|---|---|---|
| Augmenter les crédits de départ | Economy/StartingConditions.csv | credits | Début de partie plus facile, premier vaisseau plus rapide |
| Ralentir la déperdition de faim de l'équipage | NPCs/Needs.json | hungerRate | Moins de micromanagement sur les longs trajets |
| Augmenter la poussée des petits moteurs | Items/Engines/Stats.csv | thrust par pièce | Vaisseaux de départ plus viables |
| Augmenter le prix de vente de la ferraille | Economy/TradeGoods.csv | sellPrice pour scrap | Boucle de jeu de récupération renforcée |
| Raccourcir les durées de réparation | Events/RepairActions.csv | durationHours | Rotation plus rapide aux stations |
Rééquilibrez toujours par petits incréments — doubler un prix peut casser les scripts IA en aval qui supposent un certain ratio entre les biens. Les joueurs du canal Discord #modding-data-files avertissent fréquemment de ne pas modifier plus de deux ou trois valeurs liées par version.
Éviter les conflits entre mods et la corruption
La plupart des listes de mods cassées ne sont pas causées par du mauvais code — elles sont causées par des collisions entre mods où deux paquets essaient de remplacer le même ID d'objet. Quelques habitudes préviennent cela presque entièrement.
- Tenez une feuille de calcul maître listant chaque ID d'objet que votre mod touche, avec le mod source propriétaire de chacun.
- Préfixez tous les IDs d'objets personnalisés avec un tag unique de trois lettres (par exemple
abc_hull_v1) pour éviter les collisions avec les IDs vanilla. - Publiez votre mod avec un
loadOrder.txtdéclarant quels autres mods doivent se charger avant le vôtre. - Testez contre une installation propre du jeu de base avant de tester contre une configuration chargée.
Pour une couverture plus approfondie de la façon dont le chargeur résout ces collisions, l'article outils de modding Ostranauts compare les validateurs et les conditionneurs sur lesquels s'appuient la plupart des auteurs communautaires.
Fichiers sensibles à la version à surveiller
Tous les fichiers ne sont pas sûrs à modifier d'un patch à l'autre. Quand Blue Bottle Games livre une mise à jour majeure, certains fichiers — en particulier tout ce qui se trouve sous Blueprints/Ships/ — peuvent être réorganisés ou renommés. Les tests communautaires sur les branches beta récentes suggèrent que le développeur les ajuste activement pour plus de clarté, et un petit ajustement dans le prochain patch trimestriel est plausible. Abonnez-vous au fil des notes de patch sur le wiki officiel Ostranauts ou suivez le développeur sur Steam pour détecter tôt les changements cassants.
Meilleures pratiques pour publier des mods de fichiers de données de modding Ostranauts
Un mod qui fonctionne sur votre machine n'est que la moitié du travail. L'autre moitié consiste à s'assurer que d'autres joueurs peuvent l'installer sans avoir à fouiller dans des fichiers de configuration.
Standards de conditionnement attendus par la communauté
Les mods prêts pour le Workshop regroupent généralement trois choses : les fichiers de données modifiés dans un dossier auto-descriptif, un court readme.txt décrivant l'intention et l'ordre de chargement, et un preview.png optionnel montrant le résultat en jeu. Le readme.txt doit lister chaque fichier que le mod remplace afin que les réviseurs puissent auditer la portée avant de s'abonner.
Compatibilité avec d'autres mods populaires
Une poignée de piliers communautaires — refontes d'économie, extensions de vaisseaux, suites d'équilibrage — se chevauchent sur des IDs d'objets communs. Si votre mod cible les mêmes fichiers, déclarez le conflit dans votre description et recommandez un ordre de chargement. Les joueurs qui empilent les mods apprécient la transparence bien plus qu'un remplacement parfaitement silencieux qui casse discrètement le travail d'un autre créateur.
Où trouver de l'aide quand vous êtes bloqué
Le serveur Discord Ostranauts héberge des canaux dédiés à l'édition des fichiers de données, avec des moddeurs chevronnés qui déboguent régulièrement des erreurs d'analyse JSON en direct. La page Ostranauts sur Steam renvoie également vers le wiki officiel et vers le Workshop, qui est le canal de distribution le plus facile pour les éditeurs de mods débutants. Si vous vous lancez dans l'édition de données à partir de zéro, le guide d'édition de données en texte brut passe en revue le même flux de travail de manière plus détaillée, y compris comment gérer l'occasionnel fichier hérité non-JSON.
Questions Fréquentes
Dois-je posséder le jeu sur Steam pour éditer les fichiers de données de modding Ostranauts ?
Oui. Les fichiers de données de modding vivent dans le répertoire du jeu installé, donc vous aurez besoin d'une copie légitime — Steam, GOG, ou toute future vitrine officielle — pour y accéder. Les fichiers ne sont pas distribués séparément.
L'édition des fichiers de données entraînera-t-elle mon bannissement du multijoueur ou de Steam ?
Ostranauts en solo n'a pas de couche anti-triche qui analyse les fichiers de données, et l'édition de données communautaire est explicitement prise en charge par le développeur. Tant que vous ne touchez que les fichiers locaux, vous restez en règle. Évitez de distribuer les assets originaux du jeu avec votre mod — ne livrez que les fichiers que vous avez réellement modifiés.
Puis-je partager un mod qui modifie les mêmes fichiers qu'un autre créateur ?
Oui, mais déclarez clairement le conflit. Documentez l'ordre de chargement, notez quel mod doit se charger en premier, et créditez le créateur original. Les joueurs empilent régulièrement des mods compatibles quand les conflits sont transparents, et la communauté récompense la collaboration respectueuse.
Que se passe-t-il si une mise à jour du jeu casse mes fichiers de données moddés ?
Le jeu se lancera généralement mais échouera à lire les entrées concernées, en journalisant une MissingFieldException par ligne cassée. Réappliquez vos modifications sur les fichiers de base patchés, republiez le mod, et notifiez les abonnés via les notes de mise à jour du Workshop. La plupart des auteurs de mods constatent que 70 à 80 % des modifications survivent intactes aux patches majeurs.
Existe-t-il un moyen de prévisualiser les modifications des fichiers de données sans lancer le jeu ?
Partiellement. Un linter JSON et un visualiseur CSV détectent instantanément les erreurs structurelles, et des outils comme Notepad++ avec le plugin JSON Viewer rendent les structures imbriquées sous forme d'arbres dépliables. Pour la vérification sémantique — si le changement se comporte réellement comme prévu — il n'y a pas de substitut au lancement du jeu et à l'observation du résultat.
Quel est le premier ajustement de fichier de données de modding Ostranauts que vous prévoyez de publier — une passe d'équilibrage, un nouveau vaisseau, ou un roster d'équipage personnalisé ? Déposez votre idée de projet dans les commentaires et la communauté vous aidera à définir les bons fichiers à toucher en premier.