Vydala se nová verze hry a chceš aktualizovat své mody i svět, aniž bys přišel o uložený postup. Změna nastavení serveru ve Vintage Story a přidání nových modů jsou dvě změny, které mohou zabránit načtení světa, takže tento pracovní postup je provádí ve stanoveném pořadí: zkopíruj složku uložení, proveď jednu změnu, spusť server a přečti log, poté proveď další změnu. Cascadia Merge provede práci se soubory a zobrazí ti každý výsledek jako kartu. Ty rozhoduješ o každém kroku a server držíš zastavený, dokud se soubory mění. Plánuj, že svůj čas věnuješ čtení rozdílů a logu, ne psaní cest, a před změnou si zapiš verzi každého modu, aby seznam mohl sloužit jako záznam o dni aktualizace.
Vyber datovou složku serveru jako pracovní složku pro nový chat. Agent vypíše obsah složky pomocí list_dir, takže uvidíš složky Saves, Backups a Mods, než se něco změní. Na počítači s Windows je výchozí umístění složka VintagestoryData v adresáři AppData\Roaming tvého uživatele, pokud jsi server nespustil s jinou cestou k datům.
Se zastaveným serverem agent zkopíruje složku Saves do Backups pomocí tvého vlastního skriptu pro zálohování. V kartě si přečteš návratový kód, požádáš o druhý výpis list_dir složky Backups a potvrď, že nová kopie skutečně existuje, než pokračuješ.
Uprav soubor serverconfig.json nebo nahraj nový mod, nikdy obojí najednou. Agent zobrazí diff pro změnu nastavení a ty ho v režimu Ask first přijmeš nebo zamítnes. Mod, který nahraješ ručně, umístíš do složky Mods jako soubor .zip, a v jednom kole se změní jen jeden takový soubor.
Spusť server svým vlastním skriptem, nech agenta prohledat log na selhané mody a připoj se z hry. Pokud něco selže, víš, která změna to způsobila, a můžeš tento soubor přesunout nebo obnovit tento řádek z kopie, kterou jsi vytvořil na začátku.
Mods/nalezenoMods/examplemod/modinfo.jsonpřečtenoversion Mods/3 shodymod-list.txtuloženo{
"ServerName": "Friends World",
"Port": 42420,
"MaxClients": 10,
"Password": null,
"AllowPvP": false,
"AdvertiseServer": false
}Toto je ukázka souboru serverconfig.json, ne kompletní soubor, pouze s ukázkovými hodnotami. Port hry je 42420 (TCP) a prázdné heslo znamená, že heslo není nastaveno, takže si před otevřením světa pro internet nastav vlastní heslo. Skutečný soubor edituj pouze při zastaveném serveru a měj vedle složky Saves vlastní kopii tohoto souboru.
Začni tím, že se podíváš, než začneš cokoliv měnit. Agent použije list_dir a glob k nalezení složky Mods uvnitř datové složky, read_file k otevření souboru modinfo.json každého modu, který je v samostatné složce, a write_file k uložení prostého seznamu názvů a verzí do tvé pracovní složky. Pokud potřebuješ pomoc s mody na hostovaném serveru, nejprve zkontroluj, zda se můžeš dostat k jeho datové složce, protože agent může pracovat pouze se soubory, které můžeš otevřít. Vytiskni seznam. Porovnáš ho s mody, které mají tví hráči, protože server i hráči potřebují stejné mody a verze, a rozhodneš, co aktualizovat. Nic se ještě nezměnilo a máš záznam o tom, co bylo nainstalováno před aktualizací, což pomůže, pokud budeš muset krok vrátit.
Tvůj svět je jeden soubor .vcdbs ve složce Saves, takže tuto složku zkopíruj před každou aktualizací hry, změnou modu i změnou nastavení. Nejprve zastav server. Agent použije copy_file k umístění souboru světa do složky Backups a Shell spustí tvůj vlastní skript pro zálohování a v kartě hlásí skutečný návratový kód. Kopie, která nikdy nebyla obnovena, je jen domněnka, takže ji jednou obnov do dočasné složky, otevři ji a zkontroluj, zda je svět přítomen. Teprve pak přejdeš k části práce, která mění soubory, se zabezpečenou cestou zpět, pokud se změna pokazí. Nic nemažeš a uložení není nikdy odstraněno bez kopie. Pokud složka obsahuje několik světů, zkopíruj celou složku Saves, aby žádný z nich nebyl přehlédnut.
Nyní změň jednu věc. Pro úpravu nastavení serveru ve Vintage Story agent použije edit_file na soubor serverconfig.json a zobrazí diff v režimu Ask first; pro aktualizaci modu umístíš nový .zip do složky Mods sám, pouze z oficiální databáze modů. Pokud se svět po instalaci modu nenačte, poslední změna je podezřelá a můžeš ji vrátit tím, že tento soubor znovu přesuneš. Zde přestaň. Nepřidáš druhý mod, dokud nebyl otestován ten první, protože dvě změny najednou skryjí příčinu. Režim Plan only může nejprve pouze zapsat kroky bez jejich spuštění, což je užitečné, když chceš seznam úkolů pro den aktualizace, který si může přečíst i druhý správce.
Spusť server svým vlastním startovacím skriptem. Shell ho spustí a zobrazí skutečný návratový kód a poté grep prohledá log serveru na výskyty slov failed a error. Řešení problémů na dedikovaném serveru začíná právě tímto logem a karta vypíše každou odpovídající řádku, abys je mohl číst v pořadí. glob najde soubory logu, pokud si nejsi jistý, který je nejnovější. Poté se připojíš z hry a projdeš se světem. Změnu přijmeš jako dokončenou až poté, co je log čistý a připojil se druhý hráč. Pokud není čistý, vrátíš se o krok zpět, přečteš první chybu, nikoliv tu poslední, a obnovíš kopii uložení, pokud se svět sám poškodil.
