Inhalt

 

Mit dem Steam Workshop ist es jetzt einfacher als je zuvor, Erweiterungen für X Rebirth zu finden und zu installieren. Stöbere im Workshop und abonniere Erweiterungen, an denen Du interessiert bist. Sie werden automatisch installiert, wenn Du X Rebirth das nächste Mal startest. Lies Dir aber zunächst die Beschreibungen durch und achte auf Inkompatibilitäten mit anderen abonnierten Erweiterungen.

Erweiterungen aus dem Workshop werden auch automatisch aktualisiert, wenn der Autor aktualisierte Inhalte zur Verfügung stellt. Um eine Erweiterung beim nächsten Spielstart wieder zu deaktivieren, bestell sie einfach ab, entweder direkt im Spiel oder auf der Steam-Website.

X Rebirth VR Edition hat einen eigenen Workshop auf Steam, da Workshop-Erweiterungen nicht gemeinsam von verschiedenen Spielen genutzt werden können. Das Workshop-Tool von X Rebirth unterstützt aber beide Spiele, und eine Erweiterung für X Rebirth VR Edition zu veröffentlichen funktioniert sehr ähnlich.

Allgemeine Regeln zur Veröffentlichung von Erweiterungen

Allgemeine Regeln und Richtlinien:

Vorbereitung

Um eine Erweiterung im Steam Workshop zu veröffentlichen, benötigst du:

 

Weitere Voraussetzungen:

 

 

 

Beispiel für eine content.xml, um eine neue Erweiterung zu veröffentlichen:

<?xml version="1.0" encoding="utf-8" ?>
<!-- Meine Test-Erweiterung v0.10 -->
<content id="total_unwichtig" name="My Test Extension" description="This is just an example." version="10">
  <!-- Benötigt Workshop-Erweiterung 12345, Mindestversion 1.00 -->
  <dependency id="ws_12345" version="100" />
  <!-- Benötigt mindestens Spielversion 1.50 -->
  <dependency version="150" />
  <!-- Optionale Lokalisierung (BEACHTE: Diese ist nicht sichtbar im Steam Workshop und kann auf der Internetseite des Workshops nicht aktualisiert werden) -->
  <!-- Deutsch: -->
  <text language="49" name="Meine Test-Erweiterung" description="Dies ist nur ein Beispiel." />
</content>

(BEACHTE: Bei den Texten zwischen den Pfeilen <!-- --> handelt es sich um Kommentare, die hier der Veranschaulichung dienen. Sie müssen in der eigentlichen content.xml nicht mitangegeben werden.)

Minimalistisches Beispiel:

<?xml version="1.0" encoding="utf-8" ?>
<content id="" name="Foo" description="Test" version="100">
</content>

Das Workshop-Tool benutzen

Das Workshop-Tool ist in den X Rebirth Tools enthalten. Es ist ein Kommandozeilen-Programm, eine grafische Benutzeroberfläche haben wir (noch) nicht. Du benötigst daher eine Kommandokonsole, um es laufen zu lassen. Der einfachste Weg dies zu tun, ist es, die "Spielen"-Option der X Rebirth Tools auszuwählen. Dies wird die Windows-Eingabeaufforderung im X Rebirth Tools Ordner öffnen, wo sich die WorkshopTool.exe befindet.

Tippe WorkshopTool und drücke Enter. Dies gibt dir eine Übersicht über die zur Verfügung stehenden Befehle und Schalter. Hab keine Angst etwas auszuprobieren, das Tool wird eine Bestätigung verlangen, bevor es irgendetwas hochlädt.

Eine Erweiterung veröffentlichen

Wichtig: Du musst den Workshop-Nutzungsbedingungen zustimmen, um Inhalte zum Steam Workshop hochladen zu können.

 

Nehmen wir an, du hast eine Erweiterung im "extensions"-Ordner des Spiels vorbereitet:

...\steamapps\common\X Rebirth\extensions\my first mod

Du hast außerdem ein Vorschaubild (siehe oben). Es heißt preview.jpg und es befindet sich in deinem Erweiterungsordner ("my first mod"). Beachte den kleingeschriebenen Ordnernamen. Nun ist es Zeit, das WorkshopTool auszuführen! Die Kommandozeile, um deine Mod zu veröffentlichen, sollte wie folgt aussehen:

 

WorkshopTool publish -path "..\X Rebirth\extensions\my first mod" -preview "..\X Rebirth\extensions\my first mod\preview.jpg" -buildcat

 

[In Zukunft möchtest du vielleicht auch den -tags Schalter nutzen. Tags sind aber noch nicht implementiert. Komme später wieder, um zu schauen, ob sich dies geändert hat.]

Du musst bei Steam angemeldet sein, während das Workshop-Tool läuft.

Also was passiert jetzt?

 

Nach dem erfolgreichen Hochladen wird du gefragt, ob du die Internetseite für dein Workshop-Objekt öffnen möchtest. Du solltest dies aus folgenden Gründen tun:

 

Wenn dir die Internetseite sagt, dass das Workshop-Objekt nicht existiert, bist du wahrscheinlich nicht eingeloggt. Logge dich ein, um deine Erweiterung zu sehen.

Wenn du später zu dieser Seite zurückkehren möchtest, lege entweder ein Lesezeichen in deinem Browser an, oder starte das Workshop-Tool mit dem Befehl showpage:

WorkshopTool showpage -path "..\X Rebirth\extensions\my first mod"

Wenn du eine Erweiterung im Workshop abonniert hast und X Rebirth startest, werden deren Dateien heruntergeladen und überschreiben möglicherweise Dateien früherer Versionen. Dies passiert nicht für deine eigene Erweiterung, da das Workshop-Tool nach der Veröffentlichung sync="false" in deine content.xml schreibt. Somit kannst du deine Erweiterung sicher in deinem Spielordner halten, während du an Updates arbeitest. (Nichtsdestotrotz ist es immer eine gute Idee, deine Dateien regelmäßig zu sichern.) Wenn du die Synchronisierung dennoch aktivieren möchtest, ist dies auch ohne Weiteres möglich: Gehe ins Erweiterungen-Menü im Spiel, wähle deine Erweiterung und setze "Updates" auf "Ja".

Eine Nebenwirkung deaktivierter Updates ist, dass X Rebirth den Namen und die Beschreibung deiner lokalen content.xml nicht ändern wird, wenn du sie im Steam Workshop änderst. Andere Spieler werden aber den aktualisierten Namen und die Beschreibung in ihren Spielen sehen.

Sobald Spieler deine Erweiterung im Workshop sehen können, können sie sie abonnieren und installieren, indem sie X Rebirth starten. Erweiterungen werden deaktiviert, indem man sie wieder abbestellt. Wenn nur der Ordner gelöscht wird, ohne die Erweiterung abzubestellen, wird sie beim nächsten Spielstart erneut heruntergeladen.

Wenn deine Erweiterung von anderen Workshop-Erweiterungen abhängt, müssen Spieler all diese manuell abonnieren, andernfalls erhalten sie eine Fehlermeldung im Spiel. Die benötigten Erweiterungen werden im spielinternen Erweiterungen-Menü angezeigt und können dort ebenfalls abonniert werden.

Eine Erweiterung aktualisieren

Um eine vorhandene Workshop-Erweiterung zu aktualisieren, könnte eine Kommandozeile wie folgt aussehen:

WorkshopTool update -path "..\X Rebirth\extensions\my first mod" -buildcat -changenote "This is my first update"

Der Befehl "update" unterscheidet sich vom Befehl "publish" zum Veröffentlichen einer Erweiterung in einigen Punkten:

Wenn X Rebirth eine Erweiterung installiert, überprüft es die heruntergeladene content.xml nach einer vorausgesetzten Spielversion. Wenn die Erweiterung eine höhere als die zurzeit installierte Spielversion benötigt, wird der Download (mit einer Warnung) verworfen und stattdessen weiterhin die bereits installierten Dateien genutzt. Änderst du als Workshop-Autor also die benötigte Spielversion, wird dies nicht das Spiel von anderen kaputt machen. Solche Sicherheitsüberprüfungen gibt es jedoch nicht, wenn du die "dependencies" von anderen Workshop-Erweiterungen und ihrer Versionen änderst – das Update wird dann trotzdem heruntergeladen und installiert.

Mehrere Spielversionen unterstützen

Unter Umständen möchtest du vielleicht verschiedene Dateien für verschiedene Spielversionen in der gleichen Workshop-Erweiterung bereitstellen. Das ist nützlich, wenn Egosoft eine neue Beta-Version des Spiels bereitstellt und du deine Mod für diese Beta anpassen möchtest, ohne dass alle Spieler der öffentlichen Version deiner Mod von diesem Update beeinflusst werden. Zum Beispiel könnte eine neue Beta-Version neue Funktionen einführen, die du in deiner Mod nutzen möchtest oder deine Mod könnte inkompatibel werden und muss angepasst werden. Du kannst die Betaphase nutzen, um die notwendigen Änderungen vorzunehmen und kannst damit beide Versionen, öffentliche und Beta, gleichzeitig unterstützen.

Und so funktioniert es: Wie in der Dokumentation zum Katalog-Tool beschrieben, wird das Spiel in deinem Erweiterungsordner nach einem Versionskatalog suchen, der deiner aktuellen Spielversion entspricht, z.B. würde die Spiel-Version 1.50 nach ext_v150.cat suchen. Existiert dieser Katalog, wird er genutzt, um die anderen Kataloge deiner Erweiterung zu überschreiben (im Normallfall nur ext_01.cat).

Wenn du das Katalog-Tool nicht manuell nutzt, kann das Workshop-Tool die ganze Arbeit für dich übernehmen. Angenommen du hast eine Erweiterung, die mit der aktuellen Version von X Rebirth (sagen wir mal 1.50) funktioniert und es gibt eine Beta für X Rebirth (sagen wir mal Version 2.00). Du möchtest nun Änderungen an deiner Erweiterung vornehmen, um sie für v2.00 vorzubereiten. Dann gehst du wie folgt vor:

Wenn du vorhast, alle deine Kataloge und die Versions-Kataloge manuell zu erstellen, sei dir bewusst, dass du sie mit jedem Update neu erstellen musst – die Versions-Kataloge müssen stets ein "diff" zur jeweils aktuellen Version sein.

Eine Erweiterung für X Rebirth VR Edition veröffentlichen

Dies ist analog zur Veröffentlichung einer Erweiterung für X Rebirth (siehe oben), aber statt des Befehls "publish" verwendest Du "publishvr", z.B.:

WorkshopTool publishvr -path "..\X Rebirth VR\extensions\my first mod" -preview "..\X Rebirth VR\extensions\my first mod\preview.jpg" -buildcat

Du kannst eine Erweiterung nur für ein Spiel veröffentlichen, dass du auch auf Steam besitzt, der Befehl "publishvr" funktioniert also nur, wenn du X Rebirth VR Edition besitzt, während "publish" X Rebirth erfordert.

Es ist wie folgt möglich, dieselbe Erweiterung für beide Spiele zu veröffentlichen:

Um eine Erweiterung für X Rebirth VR Edition zu aktualisieren, verwende einfach den Befehl "update" wie oben beschrieben. Das Workshop-Tool wird das Spiel automatisch erkennen, indem es die Workshop-ID aus der entsprechenden content.xml-Datei ausliest.