Oxygen Not Included News - ONI führt ein Upgrade auf Harmony 2.0 durch!

Es gibt eine neue News zu dem Steam Game Oxygen Not Included vom 10.06.2021. Folgendes hat dabei der Entwickler von Oxygen Not Included veröffentlicht:

Ursprünglich gepostet von Ipsquiggle in den offiziellen Foren

Hallo Modder!

Im Laufe des letzten Jahres haben viele in der Community darum gebeten, dass wir die Version von Harmony, die wir mit dem Spiel ausliefern, aktualisieren, um die Mod-Entwicklung zu vereinfachen und sicherzustellen, dass Modder Zugang zu den neuesten Funktionen der Harmony-API haben!

In der Testphase, die am 10. Juni beginnt, werden wir Harmony 2.0.4.0 auf dem öffentlichen Testzweig ausliefern.

Dieses Upgrade erfordert, dass Modder alle .dll-Mods aktualisieren!

Es ist auch so, dass die großen Code-Änderungen, die wir gerade machen, eine signifikante Anzahl von Mods kaputt machen werden, und später, wenn die Vanilla und DLC Codebases endlich vollständig zusammengeführt sind, werden alle existierenden Vanilla .dll Mods sowieso kaputt sein. Wir würden lieber gar keine Mods kaputt machen, aber da es passieren wird, entscheiden wir uns dafür, alle Brüche in ein einziges Update zu packen, und das gibt Euch etwas Zeit, sich vorzubereiten.

Der Mergedown-Prozess - Verwenden Ihr mod_info.yaml



Während wir die Codebases vereinheitlichen, werden all diese Änderungen (einschließlich des Harmony 2.0 Updates) langsam durch die verschiedenen Versionen des Spiels rollen, etwa so:

Spaced Out Public Testing - Spaced Out (alle Spieler) - Oxygen Not Included Public Testing - Oxygen Not Included (alle Spieler)

Mods, die auf Spaced Out laufen, müssen also zuerst aktualisiert werden und werden diese Testphase haben, bevor alle Spaced Out-Spieler die Codeänderungen sehen.

Die Änderungen am Basisspiel werden einige Zeit danach erfolgen, obwohl genaue Termine noch festgelegt werden.

Sobald Euch Mod kompatibel gemacht wurde, wird er für den Rest des Mergedowns kompatibel bleiben. (Abgesehen von Brüchen durch die normale Weiterentwicklung ;) ) Stellen Ihr sicher, dass Ihr mod_info.yaml und den Archiv-Ordner verwenden, um die Versionen Eures Mods zu trennen und den Übergang für Eure Benutzer nahtlos zu gestalten! (Mehr Details unten)

Wie kann ich meine Mod aktualisieren?



Es gibt drei wichtige Änderungen, die Ihr vornehmen müssen:
  1. Ändern Ihr alle using Harmony; zu using HarmonyLib; in Eurem Code
  2. Wenn Ihr OnLoad(HarmonyInstance harmony) verwenden, ändern Ihr es in OnLoad(Harmony harmony)
  3. Installieren Ihr das .net 4.8-Entwicklerpaket und richten Ihr Euch Projekt neu auf .net 4.8 aus.

Zusätzlich:

  • Eine Reihe von Methoden in Harmony haben ihre Signatur oder ihren Geltungsbereich geändert, so dass verschiedene Kompilierfehler behoben werden müssen
  • Wie immer gibt es eine Reihe von Änderungen im ONI-Code, so dass diese Fehler behoben werden müssen
  • Aktualisieren Ihr Eure mod_info.yaml wie unten beschrieben, um beste Kompatibilität zu gewährleisten. HINWEIS! Wenn Ihr derzeit eine einzige Version Eurer Mod verwenden...
Die vollständige News zu ONI führt ein Upgrade auf Harmony 2.0 durch! findet ihr auf der Oxygen Not Included Steam Seite