Si vous avez déjà voulu contourner les règles de vos runs de récupération, ce tutoriel de modding Ostranauts vous guide à travers chaque étape, de la configuration des dossiers à la publication d'un mod fonctionnel sur Steam Workshop. Construit sur le même moteur que NEO Scavenger, le jeu est livré avec des fichiers de données en texte brut complets que n'importe quel joueur peut lire, modifier et reconditionner sans toucher à l'exécutable. Cette ouverture explique précisément pourquoi la communauté a produit des centaines de mods allant des ajustements d'équilibrage à des pièces de vaisseau entièrement nouvelles, et la suite de ce tutoriel de modding Ostranauts vous offre le chemin le plus court et le plus fiable pour les rejoindre.
Comprendre l'écosystème du modding Ostranauts
La première chose à comprendre avant d'ouvrir un fichier est la façon dont le jeu charge ses données. Ostranauts stocke quasiment toutes les valeurs de gameplay — des valeurs de poussée des propulseurs aux taux de décroissance du moral de l'équipage — dans des fichiers JSON lisibles par un humain, regroupés dans le répertoire d'installation. Quand vous lancez le jeu, il lit d'abord ces fichiers puis superpose tout ce qu'il trouve dans votre dossier de mods utilisateur, ce qui signifie que les mods se comportent davantage comme des feuilles de substitution que comme des plugins compilés. Pour une analyse approfondie de la philosophie et de l'écosystème, consultez notre guide de modding Ostranauts.
La scène du modding s'est divisée tôt en deux camps pratiques : les créateurs qui publient via Steam Workshop et les créateurs qui distribuent des dossiers bruts sur Discord. L'intégration au Workshop est arrivée avec la sortie 1.0 le 3 août 2026, donc les anciens mods qui n'existaient que sur les Discord communautaires disposent désormais d'un chemin d'installation en un clic pour les nouveaux venus. Les deux méthodes sont valides, et la couche de données les traite de manière identique.
| Canal de distribution | Effort d'installation | Livraison des mises à jour | Visibilité |
|---|---|---|---|
| Steam Workshop | Un clic | Automatique via Steam | Élevée (recherche intégrée) |
| Dossier manuel (Documents) | Glisser-déposer | Re-téléchargement manuel | Faible (Discord/forum uniquement) |
| Hub externe type Nexus | Variable | Manuelle | Moyenne |
| Archive zip de release GitHub | Téléchargement + extraction | Manuelle | Faible (développeurs uniquement) |
Le choix affecte surtout vos joueurs, pas votre code. Pour votre première tentative en suivant ce tutoriel de modding Ostranauts, l'installation manuelle est la boucle de rétroaction la plus rapide car vous pouvez éditer, relancer et recharger en moins de trente secondes sans jamais ouvrir Steam. Une fois le design stable, reconditionner pour le Workshop est un travail de cinq minutes.
Configurer votre environnement de modding
Vous n'avez pas besoin d'un IDE lourd pour commencer. La plupart des moddeurs commencent avec un éditeur de texte léger et une copie des fichiers du jeu de base pour référence. La communauté considère généralement trois outils comme la stack par défaut, et notre article sur les outils de modding Ostranauts enrichit la liste avec des captures d'écran.
Logiciels requis et emplacements des dossiers
L'installation de base se trouve dans SteamLibrary/steamapps/common/Ostranauts/ sur PC. Dans ce dossier, vous trouverez un répertoire data/ contenant les sources JSON et un répertoire ostranauts_Data/ contenant les assets Unity compilés que vous ne devriez généralement pas toucher. Votre dossier de mods utilisateur se trouve un niveau au-dessus, dans SteamLibrary/steamapps/workshop/content/1022980/ pour les éléments Workshop auxquels vous êtes abonné et dans Documents/Ostranauts/mods/ pour les installations manuelles.
Recommandations d'éditeur
Un bon éditeur devrait au minimum prendre en charge la coloration syntaxique JSON, l'appariement des crochets et l'encodage UTF-8 sans BOM. Visual Studio Code avec l'extension Even Better TOML, Notepad++ avec le plugin JSON Viewer, et Sublime Text 4 sont les trois choix les plus couramment signalés par les moddeurs sur le wiki officiel. Enregistrez chaque fichier avec des fins de ligne Unix (LF) si vous prévoyez de partager le mod multi-plateformes, car le style Windows CRLF casse certains outils de téléversement Steam Workshop et oblige les joueurs à corriger des erreurs d'encodage avant que le mod ne se charge.
Explorer les fichiers de données Ostranauts
Avant d'écrire une seule ligne, passez une heure à lire les originaux. Le dossier de base data/ contient environ deux douzaines de fichiers JSON, chacun étant limité à un seul système de jeu, et notre référence sur les fichiers de données Ostranauts les couvre tous en détail. Les cinq que vous modifierez le plus souvent lors de vos premières expérimentations sont listés ci-dessous.
| Nom du fichier | Système contrôlé | Modifications courantes |
|---|---|---|
ships.json | Coques de vaisseau, pièces, agencements de grille | Ajouter de nouveaux modèles de vaisseau |
items.json | Cargaison, outils, armes, consommables | Ajuster prix, poids, effets |
crew.json | Stats, traits et besoins des PNJ | Ajuster les courbes de moral, faim, oxygène |
world.json | Système solaire, stations, marchandises | Ajouter de nouvelles zones ou commodités |
dialogue.json | Arbres de conversation | Réécrire les répliques des PNJ |
Lire le JSON en toute sécurité
Chaque fichier JSON d'Ostranauts commence par un entier de version (par exemple "version": 4) et un tableau de premier niveau. Modifier un seul nombre — disons, le taux de consommation d'oxygène de l'équipage — est aussi simple que de trouver la clé correspondante dans le tableau crew.json, de copier l'objet entier et de ne changer que cette valeur. Dupliquez toujours le fichier avant toute modification afin de disposer d'un retour en arrière immédiat si le jeu refuse de se lancer.
Fichiers d'assets au-delà du JSON
Les échanges de sprites et les remplacements audio nécessitent de toucher au dossier ostranauts_Data/StreamingAssets/AssetBundles/, ce qui constitue un flux de travail différent. Pour les mods purement basés sur les données — le type que la plupart des débutants devraient commencer par créer — vous pouvez rester dans data/ et ne jamais décompresser un seul asset Unity. Cela maintient votre mod sous 50 Ko, facile à versionner, et trivialement diffable dans Git quand vous comparerez les révisions plus tard.
Créer votre premier mod Ostranauts étape par étape
Une fois que vous savez où vivent les fichiers, un vrai mod prend environ vingt minutes à produire. Le guide ci-dessous cible un objectif adapté aux débutants : doubler la valeur de récupération de chaque épave dans K-Leg pour que vous puissiez vous offrir un meilleur vaisseau plus vite. Traitez-le comme le premier projet canonique de tout tutoriel de modding Ostranauts, car le résultat est facile à vérifier en jeu sans casser la progression.
Étape 1 : Construire le dossier du mod
Créez un nouveau répertoire appelé KLegDoubleSalvage/ n'importe où sur votre disque, à un endroit qui vous convient. À l'intérieur, reproduisez la structure d'origine avec un sous-dossier data/. Quand le jeu se charge, il fusionne tout ce qui se trouve dans le dossier data/ de votre mod par-dessus les fichiers de base, donc le chemin à l'intérieur de votre mod doit correspondre exactement au chemin à l'intérieur du jeu — capitalisation, barres obliques et extensions de fichiers comptent tous.
Étape 2 : Copier et modifier le fichier cible
Copiez world.json depuis le dossier data/ de base vers le dossier data/ de votre mod. Ouvrez la copie et localisez les clés salvageValue à l'intérieur des entrées de la station K-Leg. Changez chaque valeur numérique, multipliez par 2, et enregistrez. Résistez à l'envie de renommer le fichier, car le chargeur se base sur le chemin, pas sur les IDs internes, et renommer rendra simplement vos modifications invisibles au moteur.
Étape 3 : Créer le manifeste
Chaque mod a besoin d'un petit descripteur texte pour que le lanceur puisse afficher un nom et une version. Créez un mod.json à la racine de votre dossier de mod avec les champs suivants :
| Champ | Requis | Objectif |
|---|---|---|
name | Oui | Nom affiché dans la liste des mods |
version | Oui | Chaîne SemVer pour les vérifications de mise à jour |
author | Oui | Pseudo du créateur |
description | Non | Résumé d'une ligne dans le lanceur |
dependencies | Non | Tableau des IDs de mods requis |
loadOrder | Non | Entier pour forcer l'ordre de chargement |
Étape 4 : Installer manuellement et tester
Déposez le dossier complet KLegDoubleSalvage/ dans Documents/Ostranauts/mods/, lancez le jeu, et vérifiez l'écran Mods du menu principal. Votre mod devrait apparaître avec une coche verte. Chargez une sauvegarde, amarrez-vous à K-Leg et démantelez l'épave la plus proche. Si le paiement en crédits a doublé, le mod fonctionne. Si le lanceur affiche un X rouge, rouvrez world.json et cherchez une virgule manquante ou une accolade non fermée — ces deux erreurs représentent environ quatre-vingt pour cent des échecs de premier téléversement, selon les données communautaires partagées sur le wiki officiel Ostranauts.
Étape 5 : Publier sur Steam Workshop
Ouvrez le Mod Manager en jeu, cliquez sur Upload et pointez-le vers votre dossier de mod. Steam s'occupera de la génération des vignettes, du versionnage et de la distribution. Une fois téléversé, votre mod apparaît à côté de la page officielle Ostranauts sur Steam, et la plupart des premiers téléversements sont visibles pour les abonnés en moins d'une heure car la validation est purement syntaxique.
Techniques avancées et bonnes pratiques
Une fois que votre premier mod fonctionne, quelques habitudes séparent une retouche ponctuelle d'une version soignée. La communauté a convergé vers quelques conventions au cours des dernières années de modding sur la même famille de moteurs, et les adopter tôt rend la suite de votre parcours de tutoriel de modding Ostranauts beaucoup plus fluide.
Versionnage et changelogs
Taguez chaque release avec SemVer et conservez un CHANGELOG.md dans le dossier du mod. Les joueurs signaleront des bugs par rapport à des versions spécifiques, et vous devez savoir si le bug existe en 1.2.0 ou seulement en 1.3.0. Un journal propre vous donne également un aspect professionnel lors de la promotion croisée avec d'autres créateurs sur Discord, et sert de registre public de vos intentions de conception pour les nouveaux venus qui lisent votre code.
Éviter les pièges courants
Les deux erreurs de débutant les plus fréquemment signalées sur les fils communautaires sont modifier par erreur des assets compilés et oublier de supprimer le dossier du mod lors des tests de retour en arrière. Gardez toujours votre dossier de mod séparé de l'installation de base, et sauvegardez toujours Documents/Ostranauts/saves/ avant de tester quoi que ce soit qui touche aux fichiers d'équipage, de dialogue ou d'économie, car ce sont les systèmes où un mod cassé peut softlock une sauvegarde et forcer à recharger une sauvegarde antérieure.
Compatibilité avec les autres mods
Quand deux mods modifient tous les deux items.json, celui chargé en dernier gagne. Utilisez le champ optionnel loadOrder dans mod.json pour forcer un ordre déterministe, et documentez toute position de chargement requise dans votre description. Les mods qui ne font qu'ajouter de nouvelles entrées rentrent rarement en conflit, alors que les mods qui modifient des nombres existants le font presque toujours, c'est pourquoi l'étiquette de l'ordre de chargement compte tellement dans ce flux de travail de tutoriel de modding Ostranauts.
Tester, déboguer et partager votre travail
Un mod n'est pas vraiment terminé tant qu'au moins trois autres personnes ne l'ont pas lancé sans plantage. La communauté Ostranauts est petite et amicale, et le hub Workshop permet de trouver facilement des bêta-testeurs prêts à vérifier une nouvelle version avant que vous ne la taguiez comme stable.
Lire le fichier log
Chaque lancement écrit un log verbeux dans Documents/Ostranauts/logs/latest.log. Si votre mod échoue à se charger, le log affichera le chemin exact du fichier et l'erreur d'analyse JSON, qui pointe généralement sur une virgule errante ou une accolade fermante manquante. Recherchez mod load failed dans le log pour accéder directement au bloc pertinent et économiser les dix minutes de défilement à travers des milliers de lignes d'information.
Itérer rapidement
La boucle de rétroaction la plus rapide est : éditer, enregistrer, alt-tab, lancer, recharger la sauvegarde. Avec de la pratique, l'aller-retour prend moins d'une minute. Si vous moddez un fichier riche en valeurs comme crew.json, gardez une petite feuille de calcul des nombres d'origine pour pouvoir comparer les deltas d'un coup d'œil au lieu de différencier du JSON brut à l'œil, et vous détecterez des régressions que la pure édition de texte cacherait pendant des heures.
Questions Fréquentes
Ai-je besoin d'une expérience en programmation pour un tutoriel de modding Ostranauts ?
Non. Le flux de travail d'un tutoriel de modding Ostranauts s'articule autour de l'édition JSON en clair, donc tout joueur capable de copier un dossier et d'utiliser un éditeur de texte peut livrer un mod fonctionnel. Si vous savez équilibrer un budget, vous pouvez ajuster les valeurs de paiement de récupération mentionnées plus haut. Pour des mods plus profonds impliquant du scripting ou de nouveaux sprites, une familiarité basique avec JSON et Unity aide mais n'est pas requise pour commencer.
Où trouver les fichiers de données du jeu de base ?
Les fichiers de base se trouvent dans votre répertoire d'installation Steam à SteamLibrary/steamapps/common/Ostranauts/data/. Vous pouvez y accéder en faisant un clic droit sur le jeu dans Steam et en choisissant Gérer → Parcourir les fichiers locaux. Copiez, ne modifiez jamais directement ces fichiers, car chaque modification appartient à votre propre dossier de mod pour que l'installation de base reste propre à des fins de vérification.
Les mods vont-ils casser mes fichiers de sauvegarde ?
La plupart des mods d'équilibrage et de contenu ne corrompent pas les sauvegardes, mais les mods qui restructurent les besoins de l'équipage, les arbres de dialogue ou les agencements de vaisseau peuvent laisser les sauvegardes plus anciennes dans un état incohérent. Sauvegardez toujours Documents/Ostranauts/saves/ avant de tester un nouveau mod, et évitez de charger une sauvegarde faite avec un mod actif dans une installation vanilla. Selon les rapports communautaires sur le wiki officiel, revenir à une sauvegarde d'avant-mod est le chemin de récupération le plus rapide quand quelque chose se passe mal.
Puis-je publier un mod fait à partir des modifications de quelqu'un d'autre ?
Seulement si vous avez une permission explicite ou si le mod original utilise une licence permissive comme MIT ou CC0. L'attente par défaut dans la communauté Ostranauts, comme le rapportent les moddeurs de longue date, est l'attribution et la divulgation de la source. En cas de doute, liez le mod original dans votre description et créditez l'auteur dans mod.json. Joueurs et créateurs récompensent tous deux la transparence, et le hub Workshop rend le plagiat facile à repérer de toute façon.
Comment mettre à jour un mod Steam Workshop existant ?
Ouvrez le Mod Manager en jeu, sélectionnez votre mod et cliquez sur Upload New Version. Steam réutilisera votre vignette et description existantes tout en incrémentant le numéro de version. Les joueurs abonnés à votre mod recevront la mise à jour automatiquement au prochain lancement, ce qui explique pourquoi le versionnage avec SemVer est important — il indique aux utilisateurs si le changement est un correctif d'urgence ou un refactor cassant qui pourrait nécessiter de recommencer une sauvegarde.