Ostranauts Créer un Mod : Guide de Modding pour Débutants 2026

Ostranauts est livré avec l'un des pipelines de modding les plus propres de la scène des simulateurs spatiaux indépendants, et cela signifie que toute personne à l'aise avec l'édition de fichiers texte peut publier un mod personnalisé sans toucher au code compilé. Si vous voulez Ostranauts créer un mod, l'ensemble du flux de travail repose sur des fichiers de données JSON, CSV et en texte brut stockés dans un dossier utilisateur dédié que le jeu lit à chaque lancement.

Ce guide vous accompagne tout au long du processus complet, de l'installation des outils de modding à la publication sur Steam Workshop, avec des chemins de fichiers concrets et des exemples JSON tirés de la documentation officielle du wiki. À la fin, vous disposerez d'un dossier de mod fonctionnel, d'un ordre de chargement vérifié et d'une entrée publiable à laquelle les autres joueurs pourront s'abonner en un seul clic.

Ostranauts Créer un Mod : Comprendre les Bases

Ostranauts utilise un système de modding basé sur des données textuelles pures, ce qui signifie que chaque mod n'est qu'un dossier de fichiers texte structurés que le jeu traite comme une couche de priorité supérieure aux données vanilla. Selon le wiki officiel d'Ostranauts, ce choix de conception était délibéré car le développeur souhaitait que la communauté de modding puisse ajuster les objets, les personnages, les vaisseaux et même des systèmes économiques entiers sans jamais ouvrir d'éditeur de code ni installer un SDK de développement de jeu.

Ce qui Compte comme Mod de Données

Un mod de données est tout dossier qui remplace, ajoute ou étend les fichiers JSON, CSV ou texte livrés avec le jeu de base. Le même fichier que vous copiez depuis le répertoire du jeu peut être édité, réenregistré et instantanément se comporter comme une nouvelle variante en jeu, car le chargeur parcourt simplement votre dossier de mod en premier et utilise tout ce qu'il y trouve. Les rapports de la communauté indiquent que plus de 90 % de tous les mods Ostranauts publiés sont des mods de données purs, la fraction restante étant des remplacements artistiques ou audio qui suivent la même structure de dossiers.

Les catégories de mods les plus courantes incluent :

• Nouvelles pièces de vaisseau — moteurs, tuiles de coque, salles internes, cockpits
• Objets personnalisés — armes, outils, consommables, vêtements
• Archétypes de personnages — statistiques de PNJ, traits, inventaires de départ
• Ajouts de lore — nouvelles chaînes de dialogue, journaux d'e-mails, journaux audio
• Ajustements d'économie — prix ajustés, listes de marchandises, inventaires de stations
• Patches de qualité de vie — texte d'interface, règles de tri, étiquettes de raccourcis

Pourquoi Modder Ostranauts en Premier Lieu

Parce que la simulation sous-jacente est orientée données, une petite modification JSON peut se répercuter sur le comportement de l'équipage, les routes commerciales et les rencontres de récupération. Les joueurs rapportent qu'un seul CSV édité peut faire évoluer l'économie du début de jeu et rendre les dix premières heures sensiblement différentes. Le jeu encourage également activement le modding via le gestionnaire de mods intégré, qui analyse à la fois le dossier de mods local et le Steam Workshop à chaque lancement.

Configuration de l'Environnement de Développement de Mod

Avant de Ostranauts créer un mod, vous avez besoin de trois éléments sur votre PC : le jeu de base installé, un éditeur de texte qui gère proprement le JSON, et un emplacement connu pour votre dossier de mod. La configuration est volontairement légère, et vous n'avez pas besoin de Visual Studio, d'un compilateur C++, ni d'un SDK moteur pour commencer.

Outils Requis

Un éditeur de texte avec coloration syntaxique JSON intégrée fait gagner énormément de temps car la plupart des bugs de débutant proviennent de guillemets manquants ou de virgules parasites. Selon le développeur, le jeu lui-même embarque un journal intégré qui signale le fichier exact et le numéro de ligne de toute erreur d'analyse, donc une deuxième paire d'yeux sous forme de linter raccourcira considérablement le cycle de débogage.

Localiser le Dossier de Mod

Le jeu crée un répertoire de données spécifique à l'utilisateur lors de son premier lancement. Le chemin exact dépend de votre plateforme, mais les emplacements les plus couramment cités dans les tests communautaires sont :

Selon la page Steam d'Ostranauts, le jeu est vérifié pour Steam Deck, donc le chemin Linux s'applique nativement sans couche de compatibilité. Sur Windows, le dossier AppData est masqué par défaut, vous devrez donc peut-être activer « Afficher les fichiers cachés » dans l'Explorateur de fichiers ou coller le chemin directement dans la barre d'adresse.

Créer Votre Premier Sous-Dossier de Mod

Dans le répertoire mods, créez un nouveau dossier avec un nom court, en minuscules et séparé par des tirets, tel que my-first-mod. Ce nom de dossier est également l'identifiant interne de mod que le jeu et Steam Workshop utiliseront, alors choisissez-le soigneusement et évitez de le renommer après publication. À l'intérieur de ce dossier, vous pouvez placer n'importe lequel des types de fichiers pris en charge, et le jeu traitera le chemin de fichier le plus profond comme la cible de remplacement.

Ostranauts Créer un Mod : Structure Centrale des Fichiers

Chaque mod suit le même principe : le chemin relatif à l'intérieur de votre dossier de mod reflète le chemin relatif à l'intérieur du répertoire data du jeu. Si vous voulez remplacer un fichier situé à data/items/weapons/plasma_rifle.json dans le jeu de base, vous placez votre copie éditée à mods/my-first-mod/items/weapons/plasma_rifle.json. Cette convention signifie qu'un seul mod peut remplacer des dizaines de fichiers simplement en reproduisant la même arborescence.

Types de Fichiers que Vous Rencontrerez

Le jeu utilise plusieurs formats de fichiers, et chacun a un rôle clair. Le tableau ci-dessous résume les types les plus courants et ce qu'ils contrôlent dans la simulation :

Aide-Mémoire de Syntaxe JSON

Parce que le JSON est le format dominant, chaque moddeur débutant doit comprendre quelques règles. Les clés et les valeurs de chaîne doivent utiliser des guillemets droits doubles, chaque accolade ouvrante doit avoir une accolade fermante correspondante, et les virgules de fin sont interdites. L'exemple ci-dessous montre une entrée d'objet simplifiée basée sur des modèles documentés dans le wiki communautaire :

{
  "id": "salvage_lantern_v2",
  "displayName": "Salvage Lantern Mk II",
  "description": "A rugged work lamp rated for hard vacuum.",
  "weight": 1.2,
  "value": 340,
  "tags": ["light", "tool", "salvage"]
}

Selon les tests communautaires sur le wiki officiel, copier-coller un fichier JSON fonctionnel et éditer uniquement les champs que vous comprenez est la manière la plus sûre de commencer. Supprimer un champ casse presque toujours le fichier, mais ajouter de nouvelles entrées à une liste telle que tags est généralement sûr et permet au reste du jeu de découvrir automatiquement le nouveau comportement.

Comprendre l'Ordre de Chargement des Mods

Lorsque deux mods éditent le même fichier, le mod qui se charge en dernier l'emporte. Le jeu charge les mods par ordre alphabétique par défaut, mais vous pouvez remplacer l'ordre via le gestionnaire de mods intégré. La meilleure pratique testée par la communauté est de préfixer votre dossier de mod avec un numéro lorsque l'ordre compte, par exemple 01-core-overhaul se chargeant avant 10-additional-content. Le tableau ci-dessous montre un ordre de chargement typique utilisé par les moddeurs expérimentés :

Tutoriel Pas à Pas Ostranauts Créer un Mod

Cette section présente un exemple complet et fonctionnel pour que vous puissiez voir l'ensemble du flux de travail Ostranauts créer un mod, d'un dossier vide à un objet en jeu testé. L'objectif est de publier un petit mod autonome qui ajoute un nouvel objet d'ambiance à l'économie de récupération sans casser le reste du jeu.

Procédure Pas à Pas

Les étapes ci-dessous supposent des chemins Windows, mais la même structure s'applique sur Linux et macOS. Chaque étape est suffisamment petite pour être vérifiée avant de passer à la suivante, ce qui est le modèle recommandé par les tutoriels communautaires car il isole les défaillances tôt.

Étape 1 — Créez le dossier du mod. Dans le répertoire mods, créez flavor-mod-starter. Ouvrez-le dans votre éditeur de texte de choix pour pouvoir éditer les fichiers sur place.

Étape 2 — Ajoutez un manifeste mod.json. Chaque mod devrait inclure un fichier manifeste que le jeu utilise pour afficher le nom du mod, sa version et son auteur dans le navigateur intégré. Créez flavor-mod-starter/mod.json avec les champs suivants :

{
  "name": "Flavor Mod Starter",
  "version": "0.1.0",
  "author": "YourName",
  "description": "Adds a few flavor items to the salvage economy.",
  "dependencies": []
}

Étape 3 — Copiez un objet du jeu de base comme modèle. Naviguez vers le dossier data/items du jeu, choisissez n'importe quel petit fichier d'objet tel qu'un en-cas ou un outil, et copiez-le dans flavor-mod-starter/items/. Renommez-le en salvage_lollipop.json. Reproduire la structure originale du dossier est ce qui indique au jeu de traiter votre fichier comme un remplacement.

Étape 4 — Éditez le fichier copié. Changez l'id, displayName, description et toutes les valeurs numériques telles que weight et value. Enregistrez le fichier en encodage UTF-8 sans BOM, car l'analyseur JSON utilisé par le jeu est strict sur l'ordre des octets.

Étape 5 — Lancez le jeu. Ouvrez Ostranauts et vérifiez le gestionnaire de mods. Votre mod devrait apparaître dans la liste avec le nom tiré de mod.json. S'il n'apparaît pas, vérifiez le fichier journal référencé dans la section de dépannage ci-dessous avant de supposer que le fichier est cassé.

Étape 6 — Vérifiez en jeu. Faites apparaître le nouvel objet via des commandes de débogage ou trouvez-le naturellement dans une cargaison de récupération, puis confirmez que le nom d'affichage, le poids et la valeur correspondent à votre JSON édité. Cette étape est ce qui boucle le processus Ostranauts créer un mod et prouve que le remplacement se déclenche réellement.

Écrire Votre Première Entrée JSON

L'exemple ci-dessous est une entrée d'objet complète et minimale. Déposez-la dans flavor-mod-starter/items/salvage_lollipop.json et elle devrait apparaître dans votre inventaire au prochain lancement du jeu avec le mod activé :

{
  "id": "salvage_lollipop",
  "displayName": "Salvage Lollipop",
  "description": "A pre-collapse candy stick, still sealed.",
  "weight": 0.05,
  "value": 4,
  "tags": ["snack", "flavor", "salvage"]
}

Le tableau tags est l'endroit le plus facile pour ajouter un nouveau comportement, car le jeu utilise les tags pour piloter le tri, la tarification et les interactions avec les PNJ. Les rapports de la communauté suggèrent qu'ajouter "rare" à une liste de tags rendra les PNJ plus attentifs à l'objet pendant les conversations, ce qui est une astuce utile lorsque vous voulez qu'un objet personnalisé semble important plutôt que jetable.

Pièges Courants à Éviter

• Erreurs de caractères invisibles — assurez-vous que votre éditeur enregistre en UTF-8 sans BOM, sinon l'analyseur JSON échouera silencieusement sans message d'erreur.
• Identifiants en doublon — deux objets avec le même id provoqueront le remplacement de l'un par l'autre sans avertissement, ce qui est la cause la plus fréquente des rapports « mon objet a disparu après que j'en ai ajouté un second ».
• Mauvaise profondeur de dossier — si le remplacement ne prend pas effet, vérifiez que le chemin relatif à l'intérieur de votre dossier de mod correspond exactement au chemin à l'intérieur du répertoire data du jeu, y compris les sous-dossiers.
• Virgules de fin — elles sont courantes lors des copies depuis des tutoriels et casseront le fichier au lancement, donc validez toujours avec un linter avant de tester.

Tester, Déboguer et Publier Votre Ostranauts Créer un Mod

Une fois que votre première tentative de Ostranauts créer un mod se charge dans le gestionnaire de mods, l'étape suivante consiste à vérifier qu'elle fonctionne dans des conditions réalistes, à déboguer les défaillances silencieuses et à décider de publier via Steam Workshop ou de distribuer le dossier manuellement. Les choix que vous faites ici détermineront la découvrabilité de votre mod et la facilité avec laquelle les autres joueurs pourront l'installer.

Flux de Test

Un cycle de test simple et reproductible fait gagner des heures. Le tableau ci-dessous résume un flux de travail fiable que les testeurs communautaires ont partagé sur le wiki officiel et affiné au cours des dernières années de modding Ostranauts :

Liste de Vérification de Débogage

Lorsque quelque chose ne fonctionne pas, le fichier journal du jeu est le premier endroit où chercher. Il se trouve à côté du dossier mods et est mis à jour à chaque lancement. Les schémas d'erreur les plus courants, basés sur les données communautaires, sont résumés ci-dessous :

Publier sur Steam Workshop

La publication se gère depuis l'intérieur du gestionnaire de mods intégré. Une fois votre mod stable, cliquez sur le bouton publier, remplissez le titre, la description, la visibilité et l'image d'aperçu, et Steam téléversera automatiquement le dossier. Le nom du dossier de mod que vous avez choisi à l'étape 1 devient l'identifiant Workshop, évitez donc de le renommer après votre première publication. Si vous voulez que votre mod apparaisse dans le navigateur intégré officiel, le développeur recommande une image d'aperçu claire et une description d'un paragraphe qui nomme la version d'Ostranauts ciblée par le mod.

Distribuer Manuellement

Si vous préférez ne pas utiliser Steam Workshop, vous pouvez zipper le dossier du mod et le partager directement. Les joueurs peuvent déposer le dossier dézippé dans leur propre répertoire mods et il apparaîtra dans leur gestionnaire de mods au lancement suivant. La distribution manuelle est courante pour les mods expérimentaux, les branches bêta et les mods que l'auteur veut garder hors du pipeline de modération Steam pour une raison quelconque.

Pour le flux de travail associé qui se concentre sur l'installation des mods existants sur votre machine, consultez le guide d'installation de mods Ostranauts. Pour un aperçu plus large des types de mods possibles, le guide pratique comment modder Ostranauts se marie bien avec ce guide. Si vous êtes complètement nouveau dans le jeu lui-même, le guide de démarrage Ostranauts couvre les premières heures de jeu. Une fois votre mod publié, déposez un lien dans le Discord officiel et regardez le nombre d'abonnés grimper.

Questions Fréquentes

Dois-je savoir coder pour Ostranauts créer un mod ?

Non. Ostranauts repose sur des fichiers de données textuelles pures, donc vous n'avez besoin que d'un éditeur de texte, d'un validateur JSON et de patience. Selon le wiki officiel, la grande majorité des mods publiés sont des modifications JSON et CSV effectuées par des joueurs sans expérience en programmation. Les hooks de script les plus avancés utilisent un sous-ensemble Lua restreint, mais ils sont entièrement optionnels et réservés aux systèmes de déclencheurs complexes.

Où dois-je mettre mon dossier de mod pour que le jeu le trouve ?

Sur Windows, l'emplacement par défaut est C:\Users\<USER>\AppData\LocalLow\Blue Bottle Games\Ostranauts\mods. Sur Linux et Steam Deck, le chemin est ~/.local/share/Blue Bottle Games/Ostranauts/mods. Créez un nouveau sous-dossier dans mods avec un nom unique en minuscules, et le jeu le détectera automatiquement au prochain lancement.

Deux mods peuvent-ils éditer le même fichier JSON en même temps ?

Oui, mais le mod qui se charge en dernier l'emportera pour tous les champs qui se chevauchent. La meilleure pratique communautaire est de donner à chaque mod un préfixe numérique tel que 01- ou 10- pour contrôler l'ordre de chargement, et d'utiliser le gestionnaire de mods intégré pour glisser-déposer les mods dans la séquence souhaitée. Ce schéma est la manière la plus fiable de garder stables les configurations multi-mods.

Comment publier mon mod sur Steam Workshop ?

Ouvrez le gestionnaire de mods intégré, activez votre mod, puis cliquez sur le bouton publier. Steam demandera un titre, une description, un paramètre de visibilité et une image d'aperçu. Après le téléversement, le mod apparaît sur la page Workshop associée à la fiche Steam d'Ostranauts, et les autres joueurs peuvent s'y abonner en un clic et recevoir des mises à jour automatiques.

Pourquoi mon mod n'apparaît-il pas dans le gestionnaire de mods ?

Les causes les plus courantes sont un chemin de dossier incorrect, un manifeste mod.json manquant ou invalide, ou une erreur de syntaxe JSON qui échoue silencieusement. Vérifiez le fichier journal dans le même répertoire que le dossier mods, et validez chaque fichier JSON avec un linter avant le lancement. Un seul guillemet non échappé ou une virgule de fin suffit pour que le jeu ignore le fichier et laisse votre mod invisible jusqu'à ce que la syntaxe soit corrigée.