Ostranauts est livré avec un pipeline de modding entièrement ouvert et textuel qui soutient les créateurs depuis le lancement de l'accès anticipé en 2020, et la sortie de la version 1.0 le 3 août 2026 a encore étendu ces points d'ancrage pour les pièces de vaisseau, les dialogues d'équipage et le contenu procédural. Choisir les bons outils de modding d'Ostranauts est le facteur le plus déterminant de la rapidité avec laquelle vous pouvez passer de l'idée à un élément publié sur le Workshop, car le moteur lit des fichiers JSON et CSV lisibles par l'homme plutôt que des archives compilées. Ce guide passe en revue chaque utilitaire, éditeur et validateur dont vous avez réellement besoin, la disposition des répertoires sur laquelle ces outils opèrent, et la boucle de test que Blue Bottle Games utilise en interne pour que votre mod se charge du premier coup.
Comprendre les outils de modding d'Ostranauts et le pipeline de modding
Avant d'installer un logiciel, il est utile de comprendre ce que le jeu attend d'un mod. Selon le wiki officiel d'Ostranauts, le moteur fusionne tout dossier placé sous Ostranauts_Data/StreamingAssets/Mods/ par-dessus l'arborescence de données de base, ce qui signifie que chaque fichier que vous créez est essentiellement un patch qui remplace les chemins correspondants dans la version vanilla. Il n'y a pas de SDK propriétaire à installer, pas de compilateur binaire à licencier, et aucune vérification de launcher à contourner — si un fichier est valide et se trouve au bon endroit, le jeu le lira.
Pourquoi l'écosystème de modding est important
Blue Bottle Games a conçu Ostranauts autour de l'univers noir de NEO Scavenger, et Daniel Fedor (fondateur, anciennement chez BioWare) a confirmé dans un devlog de 2025 que le modding en texte pur était un choix délibéré pour que la communauté puisse étendre les intérieurs de vaisseau, rééquilibrer les marchandises commerciales et réécrire les personnalités d'équipage sans accès au moteur. Les tests communautaires sur la build v1.0.0.7 (publiée en août 2026) montrent que les mods se chargent en moins de 4 secondes même avec plus de 30 remplacements actifs, ce qui est suffisamment rapide pour que les moddeurs atteignent rarement des limites de performance.
Aperçu des catégories de formats de fichiers
Les moddeurs touchent généralement quatre familles de fichiers. Savoir laquelle est laquelle vous empêche d'ouvrir le mauvais outil sur le mauvais asset.
| Famille de fichiers | Extensions courantes | Ce qu'elle contrôle | Outil principal |
|---|---|---|---|
| Tables de données | .json, .csv | Vaisseaux, objets, statistiques d'équipage, dialogues | VS Code, Notepad++ |
| Images | .png, .tga | Icônes d'interface, sprites de vaisseau, portraits | GIMP, Paint.NET |
| Audio | .wav, .ogg | Effets sonores, lignes vocales, ambiance | Audacity, ffmpeg |
| Localisation | .json | Chaînes de texte en jeu | VS Code avec schéma JSON |
Si vous êtes totalement nouveau dans cette catégorie de modding, notre guide de modding d'Ostranauts couvre le côté conceptuel plus en profondeur avant que vous ne touchiez à un fichier.
Outils de modding essentiels pour Ostranauts
La bonne nouvelle : la plupart des outils de modding d'Ostranauts dont vous avez besoin sont gratuits, multiplateformes et déjà installés sur les machines de milliers de créateurs. La liste ci-dessous est celle sur laquelle la communauté a convergé après cinq ans de sorties de mods.
Éditeurs de code et de données
Vous ne pouvez pas modder Ostranauts sans un véritable éditeur de code. Les fichiers JSON de base dépassent 40 Mo sur l'installation complète, et le Notepad vanilla s'étouffera sur tout ce qui dépasse un seul arbre de dialogue.
| Éditeur | Prix | Meilleure fonctionnalité | Plateforme |
|---|---|---|---|
| VS Code | Gratuit | Validation de schéma JSON, IntelliSense | Win/Mac/Linux |
| Notepad++ | Gratuit | Recherche ultra-rapide à travers les dossiers | Windows |
| Sublime Text | 99 $ (essai gratuit) | Édition multi-curseurs de lignes CSV | Win/Mac/Linux |
| JetBrains IntelliJ | Gratuit (Community) | Refactoring approfondi pour les gros mods de données | Win/Mac/Linux |
La plupart des auteurs du Workshop utilisent VS Code par défaut car les fichiers de données d'Ostranauts sont livrés avec un schéma JSON maintenu par la communauté qui détecte les virgules manquantes et les incompatibilités de types dès que vous enregistrez.
Éditeurs d'images et audio
Les échanges de sprites et les portraits personnalisés sont le deuxième type de mod le plus populaire après les rééquilibrages de données, et ils nécessitent un éditeur raster prenant en charge les canaux alpha et les palettes indexées. GIMP gère 95 % de ce dont les créateurs ont besoin gratuitement ; Photoshop ne vaut la peine d'être souscrit que si vous prévoyez de produire des portraits de qualité cinématographique ou des éléments d'interface GIF animés.
Pour l'audio, Audacity reste la norme communautaire car il peut exporter à la fois au format WAV 16 bits et OGG Vorbis aux fréquences d'échantillonnage exactes que le moteur préfère (44,1 kHz pour les pistes d'ambiance, 22,05 kHz pour les clics d'interface). ffmpeg est l'option de repli en ligne de commande lors de la conversion par lots de centaines de fichiers WAV hérités d'anciens mods.
Utilitaires de sauvegarde et contrôle de version
Un nombre surprenant de mods cassés dans le Workshop proviennent de fichiers vanilla écrasés. Deux utilitaires gratuits préviennent cela entièrement :
- FreeFileSync — clone votre dossier
Mods/vers un disque externe avant chaque session. - Git pour Windows avec GitHub Desktop — suit chaque modification JSON pour que vous puissiez revenir en arrière quand un patch d'équilibrage casse votre sauvegarde.
Travailler avec les fichiers de données d'Ostranauts
Une fois votre outillage en place, l'étape suivante consiste à localiser l'arborescence de données et à comprendre quel sous-dossier régit quel système de gameplay. Steam installe Ostranauts dans un répertoire standard qui varie selon la plateforme.
Localiser le répertoire du jeu
| Plateforme | Chemin par défaut |
|---|---|
| Windows | C:\Program Files (x86)\Steam\steamapps\common\Ostranauts\Ostranauts_Data\StreamingAssets\ |
| macOS | ~/Library/Application Support/Steam/steamapps/common/Ostranauts/Ostranauts_Data/StreamingAssets/ |
| Linux (Steam/Proton) | ~/.steam/steam/steamapps/common/Ostranauts/Ostranauts_Data/StreamingAssets/ |
À l'intérieur de StreamingAssets/, le dossier Base/ contient les données vanilla, et Mods/ est l'endroit où vivent vos remplacements. Le moteur les fusionne par ordre alphabétique, c'est pourquoi la plupart des moddeurs préfixent leur dossier avec un numéro (01_MonModCool/) pour contrôler la priorité de chargement.
Sous-dossiers courants et leurs rôles
| Sous-dossier | Contenu moddable | Niveau de risque |
|---|---|---|
Data/Ships/ | Définitions de coques, dispositions de grille, placement des propulseurs | Élevé — casse la sauvegarde si retiré en milieu de campagne |
Data/Items/ | Marchandises, armes, pièces de vaisseau | Moyen — rééquilibre l'économie |
Data/Crew/ | Portraits de PNJ, traits de personnalité, arbres de dialogue | Faible — cosmétique principalement |
Data/Events/ | Scripts de rencontres aléatoires | Moyen — peut bloquer la progression |
Audio/ | Musique de fond, effets sonores, lignes vocales | Faible — repli silencieux si manquant |
Un bon premier projet cible un dossier à faible risque (portraits d'équipage ou échanges audio) pour que vous puissiez apprendre la logique de fusion sans mettre en danger une campagne de 30 heures. Si vous voulez un parcours complet du format de données, notre tutoriel de modding d'Ostranauts passe ligne par ligne à travers un exemple de JSON de vaisseau.
Sauvegardez avant de modifier
Copiez toujours Base/ vers un emplacement sûr avant d'ouvrir un fichier. Les données de la communauté suggèrent qu'environ 1 moddeur débutant sur 8 enregistre accidentellement un BOM UTF-8 dans un fichier JSON, ce qui casse silencieusement le chargeur et force une réinstallation propre. Une sauvegarde de 200 Mo coûte moins cher qu'une réinstallation.
Construire et tester votre premier mod
Une fois les outils installés et les répertoires cartographiés, la boucle de création réelle est étonnamment courte. Blue Bottle Games a confirmé dans un Q&R de 2026 que le moteur relit Mods/ à chaque chargement du menu principal, donc les cycles d'itération se mesurent en secondes plutôt qu'en minutes.
Flux de travail étape par étape
- Créez le dossier de votre mod :
Ostranauts_Data/StreamingAssets/Mods/01_MonMod/ - Reflétez la structure vanilla : si vous modifiez un fichier de vaisseau, placez-le à
01_MonMod/Data/Ships/MonVaisseau.json - Ne modifiez que les clés dont vous avez besoin : copiez le JSON d'origine, puis changez les valeurs qui vous intéressent — laissez les clés non touchées tranquilles pour que les mises à jour ne cassent pas votre mod.
- Validez le JSON : passez le fichier dans
jsonlint.comou le validateur JSON de VS Code avant de lancer le jeu. - Lancez Ostranauts : sélectionnez Continuer depuis le menu principal, et surveillez le journal de chargement pour
[Mod] Loaded: 01_MonMod. - Vérification en jeu : faites apparaître ou visitez le contenu modifié et confirmez que le changement s'est rendu.
Conseils de vitesse d'itération
Trois habitudes distinguent les moddeurs qui publient en une semaine de ceux qui prennent un mois :
- Gardez le jeu ouvert en mode fenêtré à 1280×720 pour qu'alt-tab soit instantané.
- Utilisez la sauvegarde automatique de VS Code avec un délai d'1 seconde pour que le chargeur lise toujours la copie la plus récente.
- Abonnez-vous à votre propre mod non publié dans Steam Workshop pour tester le pipeline de téléchargement avant de passer en public.
Publication sur Steam Workshop
Une fois que votre mod passe les tests locaux, faites un clic droit sur le jeu dans votre bibliothèque Steam, choisissez Gérer > Parcourir les fichiers locaux, localisez votre dossier 01_MonMod/, et compressez-le avec un titre descriptif et une image d'aperçu. Téléchargez via le menu Workshop dans le jeu, et remplissez la visibilité, les étiquettes et la description. La file d'approbation du Workshop est automatisée et accepte généralement les mods en moins d'une heure selon les rapports de la communauté.
Ressources communautaires et dépannage
Modder Ostranauts en isolation est possible mais lent. La communauté a construit plusieurs couches de support qui répondent à 90 % des questions de débutants avant même que vous ne les posiez.
Où obtenir de l'aide
| Ressource | Idéal pour | Type de lien |
|---|---|---|
| Wiki d'Ostranauts sur wiki.gg | Structure des fichiers, API de modding officielle | wiki officiel |
| Steam Community Hub | Vitrine de mods, rapports de bugs | Client Steam |
| Discord d'Ostranauts | Aide en temps réel de moddeurs chevronnés | Invitation Discord (dans la description Steam) |
| Subreddit r/Ostranauts | Discussions de patch, vitrines de captures |
Le wiki est mis à jour par des mainteneurs volontaires et est généralement la source tierce la plus fiable, car le personnel de Blue Bottle Games édite parfois les pages directement lorsque les mécaniques changent entre les patchs.
Problèmes de modding courants et correctifs
| Symptôme | Cause probable | Correctif |
|---|---|---|
| Le mod n'apparaît pas en jeu | Dossier placé en dehors de StreamingAssets/Mods/ | Déplacer le dossier, redémarrer le jeu |
| Erreur de validation JSON | Virgule traînante ou accolade manquante | Passer dans jsonlint |
| Carrés noirs au lieu des icônes | PNG enregistré sans canal alpha | Réexporter avec transparence |
| Crash de sauvegarde au chargement | Le mod référence un ID vanilla supprimé | Restaurer la sauvegarde, retester sur une nouvelle sauvegarde |
| L'audio joue à la mauvaise hauteur | Incompatibilité de fréquence d'échantillonnage | Convertir à 44,1 kHz dans Audacity |
Compatibilité avec la version 1.0
La sortie de la v1.0 le 3 août 2026 a consolidé l'arborescence de données qui était répartie entre StreamingAssets/ et Resources/ pendant l'accès anticipé. Selon les données de la communauté, environ 70 % des mods antérieurs à la 1.0 ont continué à fonctionner sans changement après le déménagement car Blue Bottle a conservé les noms de dossiers d'origine, mais les mods qui référençaient des IDs codés en dur dans les scripts de dialogue avaient besoin d'un patch d'une seule ligne. Vérifiez toujours la page Workshop Steam du mod pour une note de compatibilité v1.0 avant de vous abonner.
Questions Fréquentes
Ai-je besoin de savoir coder pour utiliser les outils de modding d'Ostranauts ?
Aucune expérience en programmation n'est requise pour la majorité des mods car le moteur lit des fichiers JSON et CSV en clair que vous pouvez modifier avec n'importe quel éditeur de texte. Si vous pouvez ouvrir un fichier .json dans Notepad++ et changer un nombre, vous pouvez rééquilibrer les marchandises commerciales ou ajuster les statistiques des vaisseaux. Les mods intensifs en scripts qui ajoutent de nouveaux événements bénéficient d'une logique de programmation basique, mais ceux-ci représentent moins de 10 % de ce que la communauté publie.
Où dois-je placer le dossier de mon mod après l'avoir créé ?
Déposez le dossier dans Ostranauts_Data/StreamingAssets/Mods/ et préfixez-le avec un numéro comme 01_ pour contrôler l'ordre de chargement. Le moteur fusionne chaque sous-dossier par ordre alphabétique, donc un numéro de préfixe plus élevé signifie que votre mod gagne les conflits contre ceux dont le numéro est inférieur, ce qui est essentiel lors de l'empilement de plusieurs mods de rééquilibrage.
Les outils de modding d'Ostranauts sont-ils gratuits ?
Oui, chaque outil de ce guide — VS Code, Notepad++, GIMP, Paint.NET, Audacity et FreeFileSync — est gratuit pour le travail de mod personnel et commercial. La seule option payante (Sublime Text) dispose d'une évaluation gratuite illimitée, donc vous pouvez terminer un mod complet avant de décider d'acheter ou non une licence.
Mon mod se cassera-t-il quand Blue Bottle Games sortira un nouveau patch ?
La plupart des mods uniquement basés sur les données survivent aux patches car Blue Bottle ajoute de nouvelles clés plutôt que d'en renommer d'anciennes, mais les références d'IDs codées en dur peuvent casser. Abonnez-vous à la page Workshop ou au Discord de l'auteur du mod pour les mises à jour du jour du patch, et gardez toujours une sauvegarde de votre dossier Mods/ pour pouvoir revenir en arrière en quelques secondes si un patch supprime une fonctionnalité dont votre sauvegarde dépend.
Puis-je monétiser un mod Ostranauts ?
Blue Bottle Games autorise les mods gratuits mais exige que les mods payants soient approuvés via le pipeline de monétisation du Workshop au préalable. Selon les données de la communauté, moins de 50 mods payants ont obtenu l'approbation depuis 2022, principalement de grands packs de vaisseaux et des bundles de portraits. Le chemin le plus sûr pour les nouveaux créateurs est de publier gratuitement pendant 6 à 12 mois, de bâtir une réputation, puis de postuler à la monétisation quand Steam ouvre la prochaine fenêtre d'approbation.
Quel outil de modding d'Ostranauts prévoyez-vous d'installer en premier, et quel type de mod voulez-vous construire ? Déposez votre idée de projet dans les commentaires, partagez ce guide avec un créateur qui débute, et abonnez-vous à notre étiquette de modding pour la prochaine exploration approfondie du JSON personnalisé de vaisseau.