ModdingintermediateMis à jour: 04/08/2026

Guide de Modding Ostranauts : Installer, Créer et Dépanner

Guide complet du modding Ostranauts couvrant les installations Steam Workshop, les modifications manuelles de JSON, les meilleurs mods de la communauté, la création de pièces personnalisées et la résolution des erreurs courantes.

Si vous avez acheté Ostranauts et vous êtes demandé si l'univers K-Leg pouvait être plus personnel, la réponse se trouve dans un simple dossier de fichiers JSON et CSV. Ce guide de modding Ostranauts vous accompagne à travers chaque étape dont un nouveau joueur a besoin, depuis la localisation du dossier Mods jusqu'à la publication d'une pièce personnalisée qui remplace un réacteur d'origine par un noyau Kleg récupéré. Le jeu est livré avec des fichiers de données en texte brut, ce qui signifie que vous n'avez besoin ni d'un compilateur, ni d'une licence Unity, ni même d'un outil de zip pour commencer à bricoler des mods Ostranauts. La communauté crée ces modules depuis le lancement de l'Accès Anticipé en 2020, et Blue Bottle Games a activement préservé cette architecture privilégiant le texte brut jusqu'à la version v1.0.0.7 publiée le 3 août 2026. Selon les moddeurs de longue date de la communauté Steam, cet engagement est ce qui permet à un mod Ostranauts vieux de cinq ans de fonctionner encore en 2026 sans aucune mise à jour du développeur.

Où Ostranauts Stocke Ses Fichiers de Mods

La première chose que tout nouveau moddeur apprend, c'est qu'Ostranauts ne cache pas ses données derrière des assets compilés. Tout, du coût d'un Quantum Reactor au taux de déclin d'humeur d'un membre d'équipage mécontent, se trouve dans des fichiers texte modifiables à l'intérieur du répertoire d'installation, raison pour laquelle ce guide de modding Ostranauts consacre une section entière aux chemins de fichiers avant toute modification.

Localiser le Répertoire d'Installation

PlateformeChemin par Défaut
Steam (Windows)C:\Program Files (x86)\Steam\steamapps\common\Ostranauts\
Steam (Linux/Proton)~/.steam/steam/steamapps/common/Ostranauts/
Steam Deck/home/deck/.steam/steam/steamapps/common/Ostranauts/
Installation AutonomeLà où vous avez extrait le zip, généralement ~/Ostranauts/

À l'intérieur de ce dossier racine, les deux répertoires qui importent le plus pour les moddeurs sont Ostranauts_Data (éléments moteur compilés que vous ne devriez pas toucher) et Ostranauts_Data/StreamingAssets/data (les tables JSON lisibles par l'humain). Un troisième dossier, simplement nommé Mods, n'existe pas par défaut, vous le créez vous-même lors de la première installation.

La Convention du Dossier Mods

DossierRôleModifiable ?
Mods/Racine des mods à déposerOui, vos ajouts vivent ici
Ostranauts_Data/StreamingAssets/data/Tables de données vanillaOui, pour référence uniquement
Ostranauts_Data/StreamingAssets/Defs/Définitions de classesOui, modifications avancées uniquement
Ostranauts_Data/Managed/C# compiléNon, code moteur, ne pas toucher

Le jeu charge le dossier Mods/ en dernier, donc tout nom de fichier dupliqué dans votre mod écrase le fichier vanilla correspondant. Cette règle d'écrasement par nom est le concept le plus important de tout guide de modding Ostranauts, car elle vous permet de modifier une seule statistique sur une seule pièce sans réécrire le reste de la table, ce qui explique aussi pourquoi les débutants corrompent rarement leurs sauvegardes.

Installer des Mods Ostranauts : Trois Méthodes Qui Fonctionnent Vraiment

Il existe trois méthodes fiables pour installer des mods dans Ostranauts, et celle que vous choisissez dépend du fait que l'auteur ait publié via Steam Workshop, un canal Discord, ou un GitHub personnel. Chaque méthode aboutit au même dossier Mods, mais le flux de travail diffère en termes de réversibilité et de gestion des mises à jour.

Comparaison des Méthodes

MéthodeSourceDifficultéRéversible ?
Steam WorkshopClient SteamDébutantOui, se désabonner
Installation ManuelleZIP depuis Discord ou forumIntermédiaireOui, supprimer le dossier
Clone GitDépôt GitHubAvancéOui, exécuter git pull

Installation via Steam Workshop

Ouvrez le client Steam, recherchez « Ostranauts Workshop », ou cliquez sur le bouton vert Workshop sur la page Steam d'Ostranauts. Abonnez-vous au mod, attendez que l'icône de téléchargement se vide, puis lancez Ostranauts. Le jeu analyse les éléments Workshop abonnés à chaque démarrage et les place dans un sous-dossier workshop caché sous Mods/. Vous pouvez vérifier que l'installation s'est bien déroulée en contrôlant la présence d'un fichier info.json dans Mods/<workshop_id>/ avant d'aller où que ce soit.

Installation Manuelle par Dépôt

La plupart des auteurs livrent leurs mods sous forme de .zip contenant un dossier de premier niveau nommé d'après le mod. Extrayez le zip directement dans Mods/ de sorte que le chemin soit Mods/ReactorRebalance/info.json plutôt que Mods/ReactorRebalance/ReactorRebalance/info.json. Lancez le jeu ; si le mod Ostranauts s'est chargé, son nom apparaît dans la liste des mods de l'écran titre sous le menu Mods. Si rien n'apparaît, l'imbrication des dossiers est presque toujours en cause, et la communauté rapporte que cette unique erreur provoque plus d'installations ratées que n'importe quelle autre.

Installation par Clone Git

Pour les mods en développement actif, avec des passes d'équilibrage et des corrections de bugs tous les quelques jours, cloner le dépôt de l'auteur vous maintient à la pointe. Ouvrez un terminal dans Mods/ et exécutez git clone https://github.com/author/reactor-rebalance.git. Les mises à jour arrivent avec un simple git pull depuis l'intérieur du dossier du mod. Cette méthode nécessite Git installé sur votre système, mais reproduit sinon le processus de dépôt et constitue le moyen le plus résilient de maintenir une configuration complexe de guide de modding Ostranauts à jour à travers les patchs.

Catégories de Mods Populaires et Choix de Démarrage Recommandés

Le Workshop n'est plus un désert. À la mi-2026, les données de la communauté montrent plus de 120 mods publiés couvrant les pièces, l'équilibrage, la QoL et les conversions totales, et choisir vos trois premiers mods compte davantage que de courir après une longue liste. Les conflits d'ordre de chargement et les fonctionnalités redondantes s'accumulent rapidement quand vous vous abonnez à trop de mods, voilà pourquoi un démarrage curé bat une bibliothèque chargée à chaque fois.

Les Trois Premiers Mods d'un Débutant

EmplacementModCe qu'il faitPourquoi c'est important
1Quality of Life PackAjoute des raccourcis, tri automatique, filtres de récupérationRéduit la friction en début de partie pendant que vous apprenez le vol newtonien
2Better DealingsRééquilibre les prix commerciaux K-Leg, ajoute l'UI de trocRend la boucle économique d'échange moins punitive
3Realistic SalvageRalentit la déchéance des épaves, augmente les taux de drop de pièces raresSe combine naturellement avec le guide de récupération

Catégories de Mods par Objectif de Joueur

  • Les joueurs hardcore et immersion ont tendance à empiler les ajustements de physique, les sons d'intérieur atmosphériques et les refontes de l'humeur de l'équipage. Selon les données de la communauté, ces auteurs touchent rarement aux chiffres de l'économie, ce qui maintient leurs mods compatibles avec les mods centrés sur l'équilibrage et vous permet de les combiner avec les bases de la gestion d'équipage sans conflit.
  • Les builders et designers de vaisseaux gravitent vers les ajouts de pièces, incluant de nouveaux réacteurs, des sas plus grands et des peintures personnalisées. La culture du kit-bash autour de la construction Ostranauts est l'une des raisons pour lesquelles la catégorie Workshop des nouvelles pièces croît plus vite que toute autre.
  • Les joueurs occasionnels s'arrêtent généralement à un pack QoL et un mod d'équilibrage. Empiler trop de mods dans cette catégorie est la raison la plus fréquente pour laquelle les moddeurs débutants accusent le jeu d'instabilité alors qu'en fait, deux mods sans rapport se battent pour la même touche.

Bonnes Pratiques d'Ordre de Chargement

PrioritéType de ModRaisonnement
HauteRefontes principalesDoit charger en premier pour que les mods suivants puissent référencer leurs pièces
MoyenneNouveau contenuCharge après le cœur, pour que les nouvelles pièces s'enregistrent proprement
BasseCosmétique et QoLDernier à charger pour qu'ils écrasent les valeurs mineures sans conflit

Steam Workshop trie par nombre d'abonnés par défaut, ce qui approxime le bon ordre la plupart du temps. Les installations manuelles s'appuient sur les noms de dossiers alphabétiques sauf si l'auteur inclut un load_order.txt, et on peut généralement dire quels auteurs se soucient de l'ordre de chargement parce que leur README le mentionne.

Créer Votre Premier Mod à Partir de Zéro

Le fait le plus négligé du modding dans Ostranauts, c'est que vous pouvez écrire un mod fonctionnel en quinze minutes avec rien d'autre que Notepad. Les tables de données du jeu sont en JSON, et le schéma est suffisamment indulgent pour que vous puissiez copier une entrée vanilla, changer trois nombres et considérer que c'est fait. Cette section est le cœur pratique de tout guide de modding Ostranauts car elle transforme un lecteur en éditeur.

Anatomie d'un Mod Minimal

FichierRequis ?Nom d'Exemple
info.jsonOui, doit inclure nom, auteur, versioninfo.json
<VosDonnées>.jsonAu moins une tableReactorStats.json
README.mdOptionnel mais recommandéREADME.md

Un Vrai Exemple de Rééquilibrage de Réacteur

Supposons que vous vouliez que chaque Quantum Reactor du jeu produise 15 % de puissance en plus mais consomme 10 % d'hydrogène en plus. Ouvrez Ostranauts_Data/StreamingAssets/data/ReactorStats.json, localisez l'entrée du Quantum Reactor et copiez son bloc JSON dans un nouveau fichier à Mods/ReactorRebalance/ReactorStats.json. Changez le champ powerOutput à sa nouvelle valeur et hydrogenUse à sa nouvelle valeur, puis sauvegardez. Lancez Ostranauts, survolez la pièce dans le menu de construction et les nouveaux nombres apparaissent instantanément parce que la règle d'écrasement par nom permet à votre fichier de l'emporter sur celui vanilla.

Checklist Étape par Étape

  1. Créez Mods/VotreNomDeMod/ à l'intérieur du répertoire d'installation.
  2. Ajoutez un bloc info.json avec au minimum {"name": "Votre Mod", "version": "1.0.0"}.
  3. Copiez n'importe quel fichier JSON vanilla depuis StreamingAssets/data/ dans votre dossier de mod, en conservant le nom de fichier original.
  4. Modifiez uniquement les champs que vous comprenez, en commençant par les statistiques numériques avant de toucher aux flags.
  5. Lancez Ostranauts et vérifiez que votre entrée apparaît dans la liste des mods en jeu sous le menu Mods.
  6. Si quelque chose casse, supprimez votre dossier de mod et vérifiez que le jeu se charge encore, car cela confirme que vous avez isolé le problème.

Quand Publier Votre Mod

Si votre rééquilibrage est satisfaisant après dix heures de jeu, envisagez de le publier sur le Workshop. La plupart des auteurs en première publication sous-estiment la valeur d'un README.md clair décrivant les étapes d'installation et les conflits connus. Les mods publiés sans documentation attirent généralement des rapports de bugs confus et survivent rarement à leur premier patch majeur, tandis que les mods documentés gagnent souvent de longs fils de commentaires qui font office de QA gratuit.

Dépanner les Problèmes Courants de Modding

Même les moddeurs vétérans rencontrent des difficultés, car Ostranauts lit des dizaines de fichiers au lancement et un seul JSON mal formé peut bloquer toute la charge. La bonne nouvelle, c'est que les messages d'erreur sont descriptifs, et le chemin de récupération est généralement évident une fois que vous les lisez attentivement et résistez à l'envie de raser tout votre dossier Mods.

Les Cinq Principales Erreurs et Leurs Corrections

Message d'Erreur (paraphrasé)CauseCorrection
Mod failed to load: malformed JSONVirgule traînante ou accolade non ferméeValidez avec jsonlint.com, sauvegardez en UTF-8
Duplicate ID found in <Table>Deux mods ont ajouté le même ID de pièceRenommez votre ID avec un préfixe unique, par exemple RB_Reactor_01
Workshop item unavailableDélai de synchronisation SteamRedémarrez Steam, puis vérifiez les fichiers du jeu
Mod not appearing in-gameMauvaise imbrication des dossiersConfirmez que le chemin est Mods/NomDuMod/info.json
Crash on startup after mod installIncompatibilité de version moteurVérifiez le champ « Last Tested » du mod avec votre v1.0.0.7

Vérifier l'Intégrité des Fichiers du Jeu

Quand rien d'autre ne marche, l'option Vérifier l'Intégrité des Fichiers d'Outils de Steam réinitialise les données vanilla tout en préservant votre dossier Mods/. C'est le moyen le plus rapide de confirmer si un crash est causé par un mod. Lancez la vérification, démarrez une fois sans mods, puis réajoutez vos mods un par un pour identifier le coupable, car le débogage par recherche dichotomique fait gagner des heures de tâtonnement quand vous avez une douzaine de mods Ostranauts qui tournent ensemble.

Maintenir la Compatibilité des Mods à Travers les Patchs

Blue Bottle Games a livré six correctifs depuis la version v1.0.0.7 lancée le 3 août 2026, et le centre de guides de la Communauté Steam suit les changements cassants par mod. S'abonner aux items Workshop de vos auteurs préférés garantit que vous serez notifié quand une mise à jour restaure la compatibilité après un patch. Pour les mods que vous avez installés manuellement, suivez l'auteur sur le Discord lié ou consultez sa page de releases GitHub chaque semaine pendant les semaines de patch, et vous raterez rarement un hotfix critique.

Questions Fréquentes

Dois-je redémarrer le jeu après avoir installé un mod ?

Oui, Ostranauts ne scanne le dossier Mods/ qu'au lancement. Fermer pour revenir au bureau et rouvrir l'exécutable est le seul moyen fiable de charger du nouveau contenu. Les installations en cours de session nécessitent un redémarrage complet, ce qui est l'une des raisons pour lesquelles les moddeurs sérieux conservent un second profil de sauvegarde pour tester de nouveaux ajouts sans risquer leur sauvegarde de carrière principale.

Les mods peuvent-ils casser mon fichier de sauvegarde ?

Rarement, mais cela arrive quand un mod ajoute des pièces qu'un vaisseau actif référence déjà. Si vous retirez un mod qui ajoute des pièces alors que vous pilotez un vaisseau qui utilise ces pièces, le menu de construction affichera des avertissements. Gardez une sauvegarde de votre dossier saves/ avant d'installer tout mod qui touche aux vaisseaux ou à l'équipage, d'autant plus que les fichiers de sauvegarde sont en JSON brut et faciles à copier par un simple glisser-déposer.

Mes mods survivront-ils à la mise à jour v1.0.0.7 et aux patchs futurs ?

La plupart des mods de l'ère 2020-2025 se chargent encore en v1.0.0.7 parce que Blue Bottle Games a préservé le schéma JSON. Cependant, les mods qui se挂钩ent dans les internals du moteur, comme les plugins .dll compilés, sont plus fragiles à travers les patchs. Tenez-vous en aux mods en données texte sauf si vous avez spécifiquement besoin de hooks au niveau moteur, et lisez toujours le champ Last Tested du mod avant de vous y abonner pendant les semaines de patch.

Puis-je exécuter des mods Ostranauts sur Steam Deck ?

Oui, Ostranauts est vérifié Steam Deck, et le dossier mods est accessible depuis le Mode Bureau. Les mêmes étapes d'installation s'appliquent, mais Proton peut occasionnellement bloquer les téléchargements automatiques du Workshop. Les installations manuelles par dépôt contournent entièrement ce problème et restent la méthode la plus fiable sur le Deck, surtout pour les joueurs qui bidouillent loin du Wi-Fi domestique.

Où signaler un mod cassé ou poser une question au développeur ?

Les forums de la Communauté Steam et le Discord intégré lié depuis le launcher sont tous deux surveillés par le personnel de Blue Bottle Games. Taguez votre rapport de bug avec le nom du mod, le numéro de build v1.0.0.7 et votre extrait de Player.log depuis Ostranauts_Data/. Les auteurs de mods surveillent aussi leurs propres fils de commentaires Workshop, donc un retour direct là-bas obtient souvent des corrections plus rapides qu'un post générique sur le forum.


Quel est le premier mod que vous prévoyez d'installer, un petit ajustement QoL ou une refonte complète de pièces ? Partagez vos choix dans les commentaires, et nous échangerons des astuces d'ordre de chargement avec quiconque se débat avec une erreur d'ID dupliqué récalcitrante.