Ein Spiel-Update ist erschienen, und du möchtest deine Mods und deine Welt aktualisieren, ohne die Welt zu verlieren. Änderungen an den Vintage Story Server-Einstellungen und das Hinzufügen von Mods sind die beiden Änderungen, die das Laden einer Welt verhindern können. Dieser Workflow führt sie in fester Reihenfolge aus: Saves kopieren, eine Sache ändern, Server starten und Log lesen, dann die nächste Sache ändern. Cascadia Merge übernimmt die Datei-Arbeit und zeigt dir jedes Ergebnis als Karte. Du triffst jede Entscheidung, und du hältst den Server angehalten, während Dateien geändert werden. Plane, deine Zeit für das Lesen der Diffs und des Logs zu verwenden, nicht für das Tippen von Pfaden, und notiere die Version jedes Mods, bevor du sie änderst, damit die Liste als Aufzeichnung für deinen Update-Tag dient.
Wähle den Datenordner des Servers als Arbeitsordner für einen neuen Chat. Der Agent listet den Ordner mit list_dir auf, sodass du Saves, Backups und Mods siehst, bevor etwas berührt wird. Auf einem Windows-PC ist der Standardort der VintagestoryData-Ordner unter dem AppData\Roaming-Ordner deines Benutzers, es sei denn, du hast den Server mit einem anderen Datenpfad gestartet.
Mit angehaltenem Server kopiert der Agent den Saves-Ordner in Backups mit deinem eigenen Backup-Skript. Du liest den Exit-Code in der Karte, bittest um eine zweite list_dir des Backups-Ordners und bestätigst, dass die neue Kopie wirklich vorhanden ist, bevor du fortfährst.
Bearbeite serverconfig.json oder ersetze einen Mod, nie beides gleichzeitig. Der Agent zeigt den Diff für eine Einstellungänderung an, und du akzeptierst oder verwerfst ihn im Ask first-Modus. Ein Mod, den du von Hand ersetzt, landet als .zip-Datei im Mods-Ordner, und pro Runde ändert sich nur eine solche Datei.
Starte den Server mit deinem eigenen Skript, lass den Agenten nach fehlgeschlagenen Mods im Log suchen, und trete dem Spiel bei. Wenn etwas kaputt geht, weißt du, welche Änderung die Ursache war, und kannst diese eine Datei verschieben oder diese eine Zeile aus der zu Beginn erstellten Kopie wiederherstellen.
Mods/foundMods/examplemod/modinfo.jsonreadversion Mods/3 matchesmod-list.txtsaved{
"ServerName": "Friends World",
"Port": 42420,
"MaxClients": 10,
"Password": null,
"AllowPvP": false,
"AdvertiseServer": false
}Dies ist ein Auszug einer serverconfig.json, keine vollständige Datei, nur mit Platzhalterwerten. Der Spiel-Port ist 42420 (TCP), und ein null Passwort bedeutet, dass kein Passwort gesetzt ist, also füge eines hinzu, bevor du die Welt für das Internet öffnest. Bearbeite die echte Datei nur, während der Server angehalten ist, und halte deine eigene Kopie davon neben dem Saves-Ordner.
Schau zuerst, bevor du etwas änderst. Der Agent nutzt list_dir und glob, um den Mods-Ordner im Datenordner zu finden, read_file, um die modinfo.json jedes Mods in einem Ordner zu öffnen, und write_file, um eine einfache Liste von Namen und Versionen in deinem Arbeitsordner zu speichern. Wenn du Hilfe bei Mods auf einem gehosteten Server brauchst, prüfe zuerst, ob du seinen Datenordner erreichen kannst, da der Agent nur an Dateien arbeiten kann, die du öffnen kannst. Drucke die Liste. Du vergleichst sie mit den Mods deiner Spieler, da Server und Spieler dieselben Mods und Versionen benötigen, und entscheidest, was aktualisiert werden muss. Noch hat sich nichts geändert, und du hast eine Aufzeichnung dessen, was vor dem Update installiert war, was hilft, wenn du später einen Schritt rückgängig machen musst.
Deine Welt ist eine .vcdbs-Datei im Saves-Ordner, also kopiere diesen Ordner vor jedem Spiel-Update, jeder Mod-Änderung und jeder Einstellungsänderung. Stoppe zuerst den Server. Der Agent nutzt copy_file, um die Welt-Datei in den Backups-Ordner zu legen, und Shell führt dein eigenes Backup-Skript aus und meldet den echten Exit-Code in der Karte. Eine Kopie, die nie wiederhergestellt wurde, ist nur eine Vermutung, also stelle sie einmal in einem freien Ordner wieder her, öffne sie und prüfe, ob die Welt vorhanden ist. Erst dann fährst du mit dem Teil der Arbeit fort, der Dateien ändert, mit einem sicheren Rückweg, wenn die Änderung schiefgeht. Du löschst nichts, und ein Save wird nie entfernt, ohne dass eine Kopie vorhanden ist. Wenn der Ordner mehrere Welten enthält, kopiere den gesamten Saves-Ordner, damit keine davon übersehen wird.
Ändere jetzt eine einzelne Sache. Um die Vintage Story Server-Einstellungen anzupassen, nutzt der Agent edit_file an der serverconfig.json und zeigt den Diff im Ask first-Modus an; um einen Mod zu aktualisieren, legst du die neue .zip selbst in den Mods-Ordner, nur aus der offiziellen Mod-Datenbank. Wenn die Welt nach der Installation eines Mods nicht lädt, ist die letzte Änderung der Verdächtige, und du kannst sie rückgängig machen, indem du die Datei wieder verschiebst. Halt hier an. Du fügst keinen zweiten Mod hinzu, bevor der erste getestet wurde, da zwei Änderungen gleichzeitig die Ursache verbergen. Plan only kann die Schritte zuerst ohne Ausführen aufschreiben, was nützlich ist, wenn du eine Checkliste für den Update-Tag möchtest, die auch ein zweiter Admin lesen kann.
Starte den Server mit deinem eigenen Start-Skript. Shell führt es aus und zeigt den echten Exit-Code, und dann sucht grep im Server-Log nach den Worten failed und error. Die Fehlersuche auf einem Dedicated Server beginnt mit diesem Log, und die Karte listet jede übereinstimmende Zeile auf, damit du sie in der richtigen Reihenfolge lesen kannst. glob findet die Log-Dateien, wenn du nicht sicher bist, welche die neueste ist. Als Nächstes trittst du dem Spiel bei und läufst durch die Welt. Du akzeptierst die Änderung als abgeschlossen, erst nachdem das Log sauber ist und ein zweiter Spieler beigetreten ist. Wenn es nicht sauber ist, gehst du einen Schritt zurück, liest den ersten Fehler statt des letzten und stellst die Kopie der Saves wieder her, wenn die Welt selbst beschädigt geworden ist.
