Fast jede Anpassung, die du in Ostranauts jemals vornehmen möchtest — von der Justierung der Crew-Gehälter bis zum Rebalancing der Schiffsteil-Kosten — beginnt an derselben Stelle: den Ostranauts Modding-Datendateien, die still in deinem lokalen Spielverzeichnis liegen. Da Blue Bottle Games den Großteil seiner Inhalte als menschenlesbaren Klartext ausliefert, brauchst du kein spezielles SDK, keinen benutzerdefinierten Compiler und nicht einmal einen Hex-Editor, um mit der Individualisierung deines Spielerlebnisses zu beginnen.
Dieser Leitfaden führt dich durch das Auffinden dieser Dateien, das sichere Lesen, das zuversichtliche Bearbeiten und das Vermeiden der häufigsten Fallstricke, die gespeicherte Durchläufe zerstören oder Mods gegeneinander kämpfen lassen.
Was Ostranauts Modding-Datendateien sind und warum sie wichtig sind
Ostranauts basiert auf einer datengetriebenen Architektur, was bedeutet, dass die Engine selbst sehr wenig fest codierten Inhalt enthält. Gegenstände, NPCs, Jobs, Ereignisse, Wirtschaftssysteme, Schiffmodule, Dialoge und sogar Physik-Abstimmungswerte leben in externen Klartext-Dateien, die das Spiel bei jedem Start liest. Für Spieler ist das ein Geschenk: Die gleichen Dateien, die der Entwickler zum Ausliefern des Spiels verwendet, sind die Dateien, die du als Modder bearbeiten wirst.
Der Klartext-Vorteil für Modder
Anders als Spiele, die ihre Inhalte hinter undurchsichtigen Archiven oder verschlüsselten Datenblöcken verschließen, können Ostranauts Modding-Datendateien in jedem Texteditor geöffnet werden. Notepad++, VS Code und Sublime Text verarbeiten sie alle ohne spezielle Plugins. Diese Transparenz bedeutet:
- Ein Tippfehler in einem Preisfeld ist offensichtlich, sobald du deinen Spielstand neu lädst.
- Du kannst mit
Ctrl+Fden gesamten Datenordner durchsuchen, um einen bestimmten Gegenstand, Stat oder Auslöser zu finden. - Diff-Tools wie WinMerge oder Beyond Compare ermöglichen schnelle Mod-Kompatibilitätsprüfungen.
- Einsteiger-Modder können lernen, indem sie die eigenen Werte des Entwicklers lesen, statt zu raten.
Der Kompromiss ist, dass ein einzelnes verlorenes Zeichen das Laden kaputt machen kann, also ist Disziplin wichtiger als Werkzeuge.
Risiken, die jeder Modder respektieren sollte
Da das Spiel diesen Dateien vollständig vertraut, machen sich Fehler sofort bemerkbar. Häufige Symptome einer schlechten Bearbeitung sind ein schwarzer Bildschirm beim Start, ein endloses Ladesymbol oder eine Speicherdatei, die sich nicht deserialisieren lässt. Sichere immer die ursprünglichen Ostranauts Modding-Datendateien, bevor du etwas änderst, und behandle den core-Ordner als schreibgeschütztes Referenzmaterial, sofern du nicht ausdrücklich beabsichtigst, ihn zu überschreiben.
| Risikoart | Symptom | Vorbeugung |
|---|---|---|
| Syntaxfehler in JSON/CSV | Spiel startet nicht | Verwende einen Editor mit Klammererkennung |
| Falscher Datentyp (String vs. Zahl) | Gegenstand lädt, ist aber unsichtbar | Validiere mit einem JSON-Linter |
| Encoding-Konflikt (BOM, UTF-16) | Erster Schlüssel stillschweigend ignoriert | Als UTF-8 ohne BOM speichern |
| Doppelte ID über Mods hinweg | Letzter Mod gewinnt, Inhalt verschwindet | Führe ein Mod-Ladereihenfolge-Blatt |
Kernordnerstruktur der Ostranauts Modding-Datendateien
Bevor du etwas bearbeitest, musst du wissen, wo die Dateien tatsächlich leben. Die Struktur ist seit dem Early-Access-Start des Spiels stabil geblieben, und Community-Wikis wie das offizielle Ostranauts-Wiki auf wiki.gg führen eine aktuelle Karte jedes Unterordners.
Auffinden des Steam-Installationsverzeichnisses
Unter Windows sieht der Standardpfad ungefähr so aus:
C:\Program Files (x86)\Steam\steamapps\common\Ostranauts\ostranauts_Data\StreamingAssets\
Der Ordner StreamingAssets ist der Ort, von dem die Engine zur Laufzeit fast alles bezieht. Darin findest du eine Mischung aus CSV-artigen Tabellen, JSON-Manifesten und einer Handvoll Lua-artiger Skriptfragmente. Linux- und macOS-Nutzer sehen die gleiche Hierarchie unter ihren jeweiligen Steam-Bibliotheksstammverzeichnissen, da das Projekt als Unity-Build mit plattformunabhängigen Datenpfaden ausgeliefert wird.
Wichtige Unterordner und ihre Rollen
Die Ostranauts Modding-Datendateien sind in thematische Buckets organisiert. Die folgende Tabelle fasst die Ordner zusammen, die die meisten Modder innerhalb ihres ersten Monats anfassen.
| Unterordner | Inhaltstyp | Modder-Anwendungsfall |
|---|---|---|
Blueprints/ | Schiffsrumpf- und Raumvorlagen | Frachtkapazität, Rumpfmasse anpassen |
NPCs/ | Crew-Generierung, Eigenschaften, Hintergründe | Eigene anstellbare Charaktere hinzufügen |
Economy/ | Handelsgüter, Preise, Angebotskurven | K-Leg-Handelsschleifen neu balancieren |
Events/ | Zufällige Begegnungen und Auslöser | Neue Handlungsmomente schreiben |
Items/ | Teile, Verbrauchsgüter, Frachtmanifeste | Stapelgrößen, Gewichte bearbeiten |
Strings/ | Lokalisierbare Dialoge und Beschriftungen | Flavor-Texte übersetzen oder umschreiben |
Ein häufiger Punkt der Verwirrung: Der Ordner Blueprints enthält sowohl spielerseitige Schiffe als auch NPC-exklusive Wracks. Filtere nach Datei-Header-Kommentaren — der Entwickler hinterlässt saubere Markierungen — um deine Bearbeitungen im Rahmen zu halten.
Wie das Spiel Overrides auflöst
Wenn mehrere Quellen dieselbe Gegenstands-ID definieren, verwendet Ostranauts ein Last-Wins-Prioritätsmodell. Die Basis-Spieldateien laden zuerst, dann lädt jeder Mods/-Unterordner alphabetisch darüber. Für vorhersehbares Verhalten benenne deine Mod-Ordner mit einem klaren Präfix (z. B. ZZ_MeinMod), damit sie immer gewinnen, und dokumentiere die Priorität in einer readme.txt, die mit deiner Veröffentlichung ausgeliefert wird.
Ostranauts Modding-Datendateien sicher bearbeiten
Zu wissen, wo die Dateien leben, ist die halbe Miete. Die andere Hälfte ist, sie zu bearbeiten, ohne das Speicher-Ökosystem zu beschädigen, das von ihnen abhängt.
Empfohlene Werkzeuge für die Klartext-Bearbeitung
Du brauchst keine kostenpflichtige IDE, aber die richtigen kostenlosen Werkzeuge machen einen riesigen Unterschied dabei, Fehler frühzeitig zu erkennen.
| Werkzeug | Kosten | Warum es nützlich ist |
|---|---|---|
| Visual Studio Code | Kostenlos | JSON/CSV-Syntaxhervorhebung, integrierter Diff-Viewer |
| Notepad++ | Kostenlos | Leichtgewichtig, Regex-Suchen-und-Ersetzen, Spaltenbearbeitung |
| Python 3 + pandas | Kostenlos | Massenvalidierung und Massenbearbeitungen über Hunderte von Dateien |
| WinMerge | Kostenlos | Visueller Diff zwischen Vanilla- und modifizierten Datenordnern |
| Beyond Compare | Bezahlt (Testversion) | Drei-Wege-Diff zur Auflösung von Merge-Konflikten |
Welchen Editor du auch wählst, konfiguriere ihn so, dass er Dateien als UTF-8 ohne Byte-Order-Mark speichert, verwende Unix- oder Windows-Zeilenenden konsistent und aktiviere niemals "Smart Quotes" — ein geschwungenes Apostroph in einem Gegenstandsnamen kann den Parser bei bestimmten Feldern zum Absturz bringen.
Schritt-für-Schritt-Bearbeitungsworkflow
Ein wiederholbarer Prozess verhindert die meisten Anfängerfehler, die in Community-Discord-Kanälen auftauchen. Der folgende Workflow ist das, was erfahrene Modder beim Balancieren größerer Überarbeitungen verwenden.
- Schritt 1: Kopiere den gesamten Ordner
StreamingAssetsin ein gleichgeordnetes_backup-Verzeichnis, bevor du Änderungen vornimmst. - Schritt 2: Starte das Spiel einmal, um zu bestätigen, dass das Backup einem bekannten guten Startzustand entspricht.
- Schritt 3: Nimm eine einzelne, fokussierte Bearbeitung in deiner Zieldatei vor und schließe dann Ostranauts und starte es neu, um zu überprüfen, ob die Änderung geladen wird.
- Schritt 4: Wenn das Spiel sauber startet, commite die Änderung in einen versionierten Ordner (z. B.
v01,v02), damit du zurückrollen kannst. - Schritt 5: Wiederhole die Schritte 3–4 für jede weitere Anpassung und isoliere Variablen einzeln.
Dieser iterative Rhythmus fängt Tippfehler ab, bevor sie sich zu stundenlangem Debugging auswachsen. Er erzeugt außerdem ein sauberes Changelog, das anderen Moddern hilft zu verstehen, was deine Veröffentlichung tatsächlich tut.
Wenn du neu in der breiteren Modding-Szene bist, behandelt das Ostranauts Modding-Tutorial den umfassenderen Lebenszyklus, einschließlich des Verpackens deines ersten Mods für den Steam Workshop.
Änderungen ohne vollständigen Durchlauf validieren
Du musst keinen kompletten Handelsflug fliegen, um eine Bearbeitung zu verifizieren. Die Engine protokolliert Parse-Fehler in Player.log (Windows: %AppData%\..\LocalLow\Blue Bottle Games\Ostranauts\). Durchsuche diese Datei nach den Strings JsonException oder MissingFieldException nach jedem Start — wenn einer davon auftaucht, ist deine letzte Bearbeitung der Hauptverdächtige. Für tiefere strukturelle Validierung kombiniere deine Bearbeitungen mit einer JSON-Schemadatei aus dem Ostranauts Modding-Leitfaden, der die unterstützten Feldtypen durchgeht.
Häufige Anpassungen, die du an Ostranauts Modding-Datendateien vornehmen kannst
Sobald du dich beim Bearbeiten einzelner Felder wohlfühlst, wird ein Universum kleiner Balancing-Anpassungen verfügbar. Die folgenden Beispiele stammen aus häufigen Community-Anfragen und sind sichere Ausgangspunkte für neue Modder.
Crew-, Schiffs- und Wirtschaftswerte anpassen
Die meisten Balance-Änderungen leben in einer Handvoll Dateien, die der Entwickler absichtlich flach hält. Hier ist eine Kurzreferenztabelle mit Starter-Bearbeitungen und den Dateien, in denen sie leben.
| Anpassungsziel | Dateipfad | Anzupassendes Feld | Von der Community berichteter Effekt |
|---|---|---|---|
| Startcredits erhöhen | Economy/StartingConditions.csv | credits | Leichteres frühes Spiel, schnelleres erstes Schiff |
| Crew-Hunger-Drain verlangsamen | NPCs/Needs.json | hungerRate | Weniger Mikromanagement auf langen Flügen |
| Schub kleiner Triebwerke boosten | Items/Engines/Stats.csv | thrust pro Teil | Lebensfähigere Starterschiffe |
| Schrott-Verkaufspreis erhöhen | Economy/TradeGoods.csv | sellPrice für scrap | Stärkere Bergbau-Gameplay-Schleife |
| Reparatur-Timer verkürzen | Events/RepairActions.csv | durationHours | Schnellere Abwicklung an Stationen |
Rebalanciere immer in kleinen Schritten — eine Verdopplung eines Preises kann nachgelagerte KI-Skripte zerstören, die ein bestimmtes Verhältnis zwischen Gütern annehmen. Spieler im Discord-Kanal #modding-data-files warnen häufig davor, mehr als zwei oder drei verknüpfte Werte pro Veröffentlichung zu ändern.
Mod-Konflikte und Beschädigung vermeiden
Die meisten kaputten Mod-Listen werden nicht durch schlechten Code verursacht — sie werden durch Mod-Kollisionen verursacht, bei denen zwei Pakete versuchen, dieselbe Gegenstands-ID zu überschreiben. Einige Gewohnheiten verhindern dies fast vollständig.
- Führe eine Master-Tabelle, die jede Gegenstands-ID auflistet, die dein Mod berührt, mit dem Quell-Mod, dem jede gehört.
- Stelle allen benutzerdefinierten Gegenstands-IDs einen eindeutigen Drei-Buchstaben-Tag voran (z. B.
abc_hull_v1), um Kollisionen mit Vanilla-IDs zu vermeiden. - Veröffentliche deinen Mod mit einer
loadOrder.txt, die erklärt, welche anderen Mods vor deinem laden müssen. - Teste gegen eine saubere Installation des Basisspiels, bevor du gegen ein gestapeltes Loadout testest.
Für eine tiefere Abdeckung, wie der Loader diese Kollisionen auflöst, vergleicht der Artikel Ostranauts Modding-Werkzeuge die Validatoren und Packager, auf die sich die meisten Community-Autoren verlassen.
Versionsempfindliche Dateien im Auge behalten
Nicht jede Datei ist sicher über Patches hinweg zu bearbeiten. Wenn Blue Bottle Games ein größeres Update ausliefert, können bestimmte Dateien — insbesondere alles unter Blueprints/Ships/ — umorganisiert oder umbenannt werden. Community-Tests auf kürzlichen Beta-Branches deuten darauf hin, dass der Entwickler diese aktiv auf Klarheit hin abstimmt, und eine kleine Anpassung im nächsten Quartals-Patch ist plausibel. Abonniere den Patch-Notes-Thread im offiziellen Ostranauts-Wiki oder folge dem Entwickler auf Steam, um Breaking Changes frühzeitig zu erkennen.
Best Practices für die Veröffentlichung von Ostranauts Modding-Datendatei-Mods
Ein Mod, der auf deiner Maschine funktioniert, ist nur die halbe Arbeit. Die andere Hälfte ist sicherzustellen, dass andere Spieler es installieren können, ohne durch Konfigurationsdateien zu jagen.
Verpackungsstandards, die die Community erwartet
Workshop-fähige Mods bündeln typischerweise drei Dinge: die modifizierten Datendateien in einem selbsterklärenden Ordner, eine kurze readme.txt, die Absicht und Ladereihenfolge beschreibt, und eine optionale preview.png, die das Ingame-Ergebnis zeigt. Die readme.txt sollte jede Datei auflisten, die der Mod überschreibt, damit Reviewer den Umfang vor dem Abonnieren prüfen können.
Kompatibilität mit anderen beliebten Mods
Eine Handvoll Community-Grundnahrungsmittel — Wirtschaftsüberarbeitungen, Schiffs-Erweiterungen, Balance-Suiten — überschneiden sich bei gemeinsamen Gegenstands-IDs. Wenn dein Mod auf die gleichen Dateien abzielt, deklariere den Konflikt in deiner Beschreibung und empfehle eine Ladereihenfolge. Spieler, die Mods stapeln, schätzen Transparenz weit mehr als einen perfekt stillen Override, der still die Arbeit eines anderen Erstellers kaputt macht.
Wo du Hilfe findest, wenn du nicht weiterkommst
Der Ostranauts-Discord-Server beherbergt dedizierte Kanäle für die Datendatei-Bearbeitung, mit Veteranen-Moddern, die routinemäßig JSON-Parse-Fehler live debuggen. Die Ostranauts-Seite auf Steam verlinkt auch zum offiziellen Wiki und zum Workshop, der der einfachste Distributionskanal für Erstveröffentlicher von Mods ist. Wenn du von Grund auf in die Datenbearbeitung einsteigst, führt der Klartext-Datenbearbeitungs-Leitfaden durch den gleichen Workflow in feineren Details, einschließlich des Umgangs mit gelegentlichen Nicht-JSON-Legacy-Dateien.
Häufig gestellte Fragen
Muss ich das Spiel auf Steam besitzen, um Ostranauts Modding-Datendateien zu bearbeiten?
Ja. Die Modding-Datendateien leben innerhalb des installierten Spielverzeichnisses, daher brauchst du eine legitime Kopie — Steam, GOG oder einen zukünftigen offiziellen Storefront — um darauf zuzugreifen. Die Dateien werden nicht separat vertrieben.
Werde ich vom Multiplayer oder Steam gebannt, wenn ich Datendateien bearbeite?
Ostranauts im Einzelspielermodus hat keine Anti-Cheat-Schicht, die Datendateien scannt, und die Community-Datenbearbeitung wird vom Entwickler ausdrücklich unterstützt. Solange du nur lokale Dateien anfasst, bleibst du in gutem Stand. Vermeide es, die ursprünglichen Spiel-Assets zusammen mit deinem Mod zu verbreiten — liefere nur die Dateien aus, die du tatsächlich geändert hast.
Kann ich einen Mod teilen, der die gleichen Dateien wie ein anderer Ersteller modifiziert?
Ja, aber deklariere den Konflikt klar. Dokumentiere die Ladereihenfolge, notiere, welcher Mod zuerst laden sollte, und gib dem ursprünglichen Ersteller Anerkennung. Spieler stapeln regelmäßig kompatible Mods, wenn Konflikte transparent sind, und die Community belohnt respektvolle Zusammenarbeit.
Was passiert, wenn ein Spiel-Update meine modifizierten Datendateien kaputt macht?
Das Spiel startet normalerweise, scheitert aber daran, die betroffenen Einträge zu lesen, und protokolliert eine MissingFieldException pro kaputter Zeile. Wende deine Änderungen erneut auf die gepatchten Basisdateien an, veröffentliche den Mod neu und benachrichtige Abonnenten über die Workshop-Update-Notizen. Die meisten Mod-Autoren stellen fest, dass 70–80 % der Bearbeitungen größere Patches intakt überstehen.
Gibt es eine Möglichkeit, Datendatei-Änderungen in der Vorschau anzuzeigen, ohne das Spiel zu starten?
Teilweise. Ein JSON-Linter und ein CSV-Viewer fangen strukturelle Fehler sofort ab, und Werkzeuge wie Notepad++ mit dem JSON-Viewer-Plugin rendern verschachtelte Strukturen als einklappbare Bäume. Für semantische Verifizierung — ob die Änderung tatsächlich wie beabsichtigt funktioniert — gibt es keinen Ersatz dafür, das Spiel zu starten und das Ergebnis zu beobachten.
Was ist die erste Ostranauts Modding-Datendatei-Anpassung, die du veröffentlichen möchtest — ein Balance-Pass, ein neues Schiff oder eine benutzerdefinierte Crew-Liste? Lass deine Projektidee in den Kommentaren fallen und die Community wird dir helfen, die richtigen Dateien zum Anfassen einzugrenzen.