Ostranauts Modding Tutorial: Erstelle und installiere deine erste Mod

Wenn du jemals die Regeln deiner Bergungsmissionen verbiegen wolltest, führt dich dieses Ostranauts-Modding-Tutorial Schritt für Schritt durch den gesamten Prozess – von der Ordnereinrichtung bis zur Veröffentlichung einer funktionierenden Mod im Steam Workshop. Das Spiel basiert auf derselben Engine wie NEO Scavenger und wird mit vollständigen Klartext-Datendateien ausgeliefert, die jeder Spieler lesen, bearbeiten und neu verpacken kann, ohne die ausführbare Datei anzufassen. Genau diese Offenheit ist der Grund, warum die Community Hunderte von Mods hervorgebracht hat – von Balance-Anpassungen bis hin zu völlig neuen Schiffsteilen. Der Rest dieses Ostranauts-Modding-Tutorials zeigt dir den kürzesten zuverlässigen Weg, selbst Teil dieser Szene zu werden.

Das Ostranauts-Modding-Ökosystem verstehen

Das Erste, was du verstehen musst, bevor du irgendeine Datei öffnest, ist die Frage, wie das Spiel seine Daten lädt. Ostranauts speichert nahezu jeden Gameplay-Wert – von Schubdüsen-Schubwerten bis hin zu Besatzungs-Moral-Verfallsraten – in lesbaren JSON-Dateien, die im Installationsverzeichnis gebündelt sind. Wenn du das Spiel startest, liest es diese Dateien zuerst ein und überlagert sie anschließend mit allem, was es in deinem Benutzer-Mod-Ordner findet. Das bedeutet, dass sich Mods eher wie Überschreibungstabellen verhalten als wie kompilierte Plugins. Eine ausführlichere Erklärung der Philosophie und des Ökosystems findest du in unserem Ostranauts-Modding-Leitfaden.

Die Modding-Szene teilte sich früh in zwei praktische Lager auf: Entwickler, die über den Steam Workshop veröffentlichen, und Entwickler, die rohe Ordnerstrukturen über Discord verbreiten. Die Workshop-Integration kam mit dem 1.0-Release am 3. August 2026, sodass ältere Mods, die nur auf Community-Discords existierten, jetzt einen Ein-Klick-Installationspfad für Neueinsteiger haben. Beide Workflows sind gültig, und die Datenschicht behandelt sie identisch.

Die Wahl betrifft hauptsächlich deine Spieler, nicht deinen Code. Für deinen ersten Versuch, diesem Ostranauts-Modding-Tutorial zu folgen, ist die manuelle Installation der schnellste Feedback-Loop, da du in unter dreißig Sekunden bearbeiten, neu starten und neu laden kannst, ohne jemals Steam öffnen zu müssen. Sobald sich das Design stabil anfühlt, ist das Neuverpacken für den Workshop eine Aufgabe von fünf Minuten.

Einrichtung deiner Modding-Umgebung

Du brauchst keine schwere IDE, um anzufangen. Die meisten Modder beginnen mit einem leichtgewichtigen Texteditor und einer Kopie der Basis-Spieldateien als Referenz. Die Community behandelt im Allgemeinen drei Werkzeuge als Standard-Stack, und unser Artikel Ostranauts-Modding-Werkzeuge erweitert die Liste mit Screenshots.

Erforderliche Software und Ordnerpfade

Die Basisinstallation befindet sich auf dem PC unter SteamLibrary/steamapps/common/Ostranauts/. In diesem Ordner findest du ein data/-Verzeichnis, das die JSON-Quellen enthält, und ein ostranauts_Data/-Verzeichnis, das kompilierte Unity-Assets enthält, die du im Allgemeinen nicht anfassen solltest. Dein Benutzer-Mod-Ordner befindet sich eine Ebene höher, unter SteamLibrary/steamapps/workshop/content/1022980/ für abonnierte Workshop-Inhalte und unter Documents/Ostranauts/mods/ für manuelle Installationen.

Editor-Empfehlungen

Ein guter Editor sollte mindestens JSON-Syntaxhervorhebung, Klammer-Matching und UTF-8-Kodierung ohne BOM unterstützen. Visual Studio Code mit der Even Better TOML-Erweiterung, Notepad++ mit dem JSON Viewer-Plugin und Sublime Text 4 sind die drei häufigsten Wahlen, die Modder im offiziellen Wiki angeben. Speichere jede Datei mit Unix-Zeilenenden (LF), wenn du planst, die Mod plattformübergreifend zu teilen, da Windows-artige CRLF einige Steam-Workshop-Uploader beschädigen und Spieler dazu zwingen, Kodierungsfehler zu beheben, bevor die Mod geladen werden kann.

Ostranauts-Datendateien erkunden

Bevor du auch nur eine einzige Zeile schreibst, verbringe eine Stunde damit, die Originale zu lesen. Der Basisordner data/ enthält ungefähr zwei Dutzend JSON-Dateien, jede für ein einzelnes Spielsystem zuständig, und unsere Referenz Ostranauts-Datendateien deckt jede einzelne davon im Detail ab. Die fünf, die du während der ersten Experimente am häufigsten bearbeiten wirst, sind unten aufgelistet.

JSON sicher lesen

Jede JSON-Datei in Ostranauts beginnt mit einer Versions-Ganzzahl (zum Beispiel "version": 4) und einem Array auf oberster Ebene. Eine einzelne Zahl zu bearbeiten – sagen wir, die Sauerstoffverbrauchsrate der Besatzung – ist so einfach wie das Auffinden des passenden Schlüssels innerhalb des crew.json-Arrays, das Kopieren des gesamten Objekts und das Ändern nur dieses einen Wertes. Dupliziere die Datei immer vor jeder Änderung, damit du eine sofortige Rollback-Option hast, falls das Spiel nicht starten sollte.

Asset-Dateien jenseits von JSON

Sprite-Tausch und Audio-Ersetzungen erfordern das Anfassen des Ordners ostranauts_Data/StreamingAssets/AssetBundles/, was einen anderen Workflow darstellt. Für reine Daten-Mods – die Art, mit der die meisten Anfänger beginnen sollten – kannst du in data/ bleiben und musst nie ein einziges Unity-Asset entpacken. Das hält deine Mod unter 50 KB, leicht versionierbar und trivial vergleichbar in Git, wenn du später Revisionen vergleichst.

Erstelle deine erste Ostranauts-Mod Schritt für Schritt

Sobald du weißt, wo die Dateien liegen, dauert die Erstellung einer echten Mod ungefähr zwanzig Minuten. Die folgende Anleitung zielt auf ein anfängerfreundliches Ziel: die Verdopplung des Bergungswerts jedes Wracks in K-Leg, damit du dir schneller ein besseres Schiff leisten kannst. Betrachte es als das kanonische erste Projekt für jedes Ostranauts-Modding-Tutorial, da sich das Ergebnis im Spiel leicht überprüfen lässt, ohne den Fortschritt zu unterbrechen.

Schritt 1: Baue den Mod-Ordner auf

Erstelle ein neues Verzeichnis namens KLegDoubleSalvage/ irgendwo bequem auf deinem Laufwerk. Erstelle darin mit einem data/-Unterordner die gleiche Struktur wie im Original. Wenn das Spiel lädt, führt es alles im data/-Ordner deiner Mod mit den Basisdateien zusammen, daher muss der Pfad innerhalb deiner Mod exakt mit dem Pfad innerhalb des Spiels übereinstimmen – Groß-/Kleinschreibung, Schrägstriche und Dateierweiterungen sind alle wichtig.

Schritt 2: Kopiere und modifiziere die Zieldatei

Kopiere world.json aus dem Basisordner data/ in den data/-Ordner deiner Mod. Öffne die Kopie und suche die salvageValue-Schlüssel innerhalb der K-Leg-Stationseinträge. Ändere jeden numerischen Wert, multipliziere mit 2, und speichere. Widerstehe dem Drang, die Datei umzubenennen, da der Loader nach dem Pfad und nicht nach internen IDs abgleicht. Eine Umbenennung würde deine Änderungen für die Engine einfach unsichtbar machen.

Schritt 3: Erstelle das Manifest

Jede Mod benötigt einen kleinen Textdeskriptor, damit der Launcher einen Namen und eine Version anzeigen kann. Erstelle eine mod.json im Stammverzeichnis deines Mod-Ordners mit den folgenden Feldern:

Schritt 4: Manuell installieren und testen

Lege den gesamten Ordner KLegDoubleSalvage/ in Documents/Ostranauts/mods/, starte das Spiel und prüfe den Bildschirm Mods im Hauptmenü. Deine Mod sollte mit einem grünen Häkchen erscheinen. Lade einen Spielstand, docke bei K-Leg an und verschrotte das nächste Wrack. Wenn sich die Kredit-Auszahlung verdoppelt hat, funktioniert die Mod. Wenn der Launcher ein rotes X zeigt, öffne world.json erneut und suche nach einem fehlenden Komma oder einer unabgeschlossenen Klammer – diese beiden Fehler machen laut Community-Daten, die im offiziellen Ostranauts-Wiki geteilt wurden, etwa achtzig Prozent der Fehler beim ersten Upload aus.

Schritt 5: Im Steam Workshop veröffentlichen

Öffne den Mod-Manager im Spiel, klicke auf Upload und zeige auf deinen Mod-Ordner. Steam übernimmt die Thumbnail-Generierung, Versionierung und Verteilung. Nach dem Hochladen befindet sich deine Mod neben der offiziellen Ostranauts auf Steam-Seite, und die meisten Erst-Uploads sind für Abonnenten innerhalb einer Stunde sichtbar, da die Validierung rein syntaktisch ist.

Fortgeschrittene Techniken und bewährte Verfahren

Sobald deine erste Mod funktioniert, trennen eine Handvoll Gewohnheiten eine einmalige Anpassung von einer polierten Veröffentlichung. Die Community hat sich in den letzten Jahren des Moddens derselben Engine-Familie auf einige Konventionen geeinigt, und deren frühe Übernahme macht den Rest deines Ostranauts-Modding-Tutorial-Weges deutlich reibungsloser.

Versionierung und Changelogs

Markiere jede Veröffentlichung mit SemVer und führe eine CHANGELOG.md im Mod-Ordner. Spieler werden Fehler zu bestimmten Versionen melden, und du musst wissen, ob der Fehler in 1.2.0 oder erst in 1.3.0 auftritt. Ein sauberes Protokoll lässt dich auch professionell wirken, wenn du mit anderen Entwicklern auf Discord werbewirksam zusammenarbeitest, und es dient zugleich als öffentliches Dokument deiner Designabsicht für Neueinsteiger, die deinen Code lesen.

Häufige Fallstricke vermeiden

Die beiden häufigsten Anfängerfehler, die in Community-Threads gemeldet werden, sind versehentliches Bearbeiten kompilierter Assets und das Vergessen, den Mod-Ordner bei Rollback-Tests zu löschen. Halte deinen Mod-Ordner immer getrennt von der Basisinstallation und sichere immer Documents/Ostranauts/saves/, bevor du etwas testest, das Besatzungs-, Dialog- oder Wirtschaftsdateien berührt, da dies die Systeme sind, in denen eine defekte Mod einen Spielstand weich sperren und das Zurückladen eines früheren Backups erzwingen kann.

Kompatibilität mit anderen Mods

Wenn zwei Mods beide items.json bearbeiten, gewinnt die zuletzt geladene. Verwende das optionale Feld loadOrder in mod.json, um eine deterministische Reihenfolge zu erzwingen, und dokumentiere jede erforderliche Ladeposition in deiner Beschreibung. Mods, die nur neue Einträge hinzufügen, stehen selten im Konflikt, während Mods, die bestehende Zahlen bearbeiten, dies fast immer tun. Deshalb ist die Etikette der Ladereihenfolge in diesem Ostranauts-Modding-Tutorial-Workflow so wichtig.

Testen, Debuggen und Teilen deiner Arbeit

Eine Mod ist erst wirklich fertig, wenn mindestens drei andere Personen sie ohne Abstürze gestartet haben. Die Ostranauts-Community ist klein und freundlich, und der Workshop-Hub macht es leicht, Beta-Tester zu finden, die bereit sind, eine neue Veröffentlichung auf Herz und Nieren zu prüfen, bevor du sie als stabil markierst.

Die Logdatei lesen

Jeder Start schreibt ein ausführliches Log in Documents/Ostranauts/logs/latest.log. Wenn deine Mod nicht geladen wird, gibt das Log den genauen Dateipfad und den JSON-Parse-Fehler aus, der normalerweise auf ein verirrtes Komma oder eine fehlende schließende Klammer hinweist. Suche im Log nach mod load failed, um direkt zum relevanten Block zu springen und das zehnminütige Scrollen durch Tausende von Info-Zeilen zu sparen.

Schnell iterieren

Der schnellste Feedback-Loop ist: bearbeiten, speichern, Alt+Tab, starten, Spielstand neu laden. Mit Übung dauert die Runde weniger als eine Minute. Wenn du eine werteintensive Datei wie crew.json modifizierst, halte eine kleine Tabelle mit den ursprünglichen Zahlen bereit, damit du die Deltas auf einen Blick vergleichen kannst, anstatt rohe JSON mit den Augen zu diffen. So erkennst du Regressionen, die das reine Textbearbeiten stundenlang versteckt halten würde.

Häufig gestellte Fragen

Benötige ich Programmiererfahrung für ein Ostranauts-Modding-Tutorial?

Nein. Der Workflow dieses Ostranauts-Modding-Tutorials basiert auf der Bearbeitung von reinem JSON, sodass jeder Spieler, der einen Ordner kopieren und einen Texteditor verwenden kann, eine funktionierende Mod veröffentlichen kann. Wenn du ein Haushaltsbuch führen kannst, kannst du die zuvor erwähnten Bergungs-Auszahlungs-Werte anpassen. Für tiefgreifendere Mods mit Skripting oder neuen Sprites sind grundlegende JSON- und Unity-Kenntnisse hilfreich, aber zum Starten nicht erforderlich.

Wo finde ich die Basis-Spieldatendateien?

Die Basisdateien befinden sich in deinem Steam-Installationsverzeichnis unter SteamLibrary/steamapps/common/Ostranauts/data/. Du erreichst es, indem du das Spiel in Steam mit der rechten Maustaste anklickst und Verwalten → Lokale Dateien durchsuchen auswählst. Kopiere diese Dateien, bearbeite sie niemals direkt, da jede Änderung in deinen eigenen Mod-Ordner gehört, damit die Basisinstallation zur Überprüfung sauber bleibt.

Werden Mods meine Spielstände beschädigen?

Die meisten Balance- und Inhalts-Mods beschädigen Spielstände nicht, aber Mods, die Besatzungsbedürfnisse, Dialogstrukturen oder Schiffslayouts umstrukturieren, können ältere Spielstände in einem inkonsistenten Zustand hinterlassen. Sichere immer Documents/Ostranauts/saves/, bevor du eine neue Mod testest, und vermeide es, einen Spielstand, der mit einer aktiven Mod erstellt wurde, in eine Vanilla-Installation zu laden. Laut Community-Berichten im offiziellen Wiki ist das Zurückkehren zu einem Spielstand vor der Mod der schnellste Wiederherstellungsweg, wenn etwas schief geht.

Kann ich eine Mod veröffentlichen, die auf den Änderungen eines anderen basiert?

Nur wenn du eine ausdrückliche Genehmigung hast oder die ursprüngliche Mod eine permissive Lizenz wie MIT oder CC0 verwendet. Die Standarderwartung in der Ostranauts-Community, wie von langjährigen Moddern berichtet, ist Quellenangabe und Offenlegung der Quelle. Im Zweifelsfall verlinke die ursprüngliche Mod in deiner Beschreibung und gib den Autor in mod.json an. Spieler und Entwickler belohnen Transparenz, und der Workshop-Hub macht Plagiate ohnehin leicht erkennbar.

Wie aktualisiere ich eine bestehende Steam-Workshop-Mod?

Öffne den Mod-Manager im Spiel, wähle deine Mod aus und klicke auf Neue Version hochladen. Steam verwendet dein vorhandenes Thumbnail und deine Beschreibung erneut und erhöht die Versionsnummer. Spieler, die deine Mod abonniert haben, erhalten das Update automatisch beim nächsten Start, weshalb die Versionierung mit SemVer wichtig ist – sie sagt den Nutzern, ob es sich um einen Hotfix oder ein umbruchsicheres Refactoring handelt, das möglicherweise das Starten eines neuen Spielstands erfordert.