Saiu uma atualização do jogo e você quer atualizar seus mods e o mundo sem perder o progresso. Alterar as configurações do servidor do Vintage Story e adicionar mods são as duas mudanças que podem impedir o carregamento do mundo, então este fluxo executa tudo em uma ordem fixa: copie os saves, altere uma coisa, inicie o servidor e leia o log, depois altere a próxima. O Cascadia Merge cuida dos arquivos e mostra cada resultado como um cartão. Você toma todas as decisões e mantém o servidor parado enquanto os arquivos mudam. Planeje gastar seu tempo lendo as diferenças e o log, não digitando caminhos, e anote a versão de cada mod antes de alterá-lo para ter um registro do dia da atualização.
Defina a pasta de dados do servidor como a pasta de trabalho de um novo chat. O agente lista a pasta com list_dir, permitindo ver as pastas Saves, Backups e Mods antes de qualquer alteração. Em um PC com Windows, o local padrão é a pasta VintagestoryData dentro de AppData\Roaming do seu usuário, a menos que você tenha iniciado o servidor com outro caminho de dados.
Com o servidor parado, o agente copia a pasta Saves para Backups usando seu próprio script de backup. Você verifica o código de saída no cartão, pede uma segunda list_dir da pasta Backups e confirma que a nova cópia está lá antes de prosseguir.
Edite o serverconfig.json ou substitua um mod, nunca os dois ao mesmo tempo. O agente mostra a diferença (diff) para alterações de configuração, e você aceita ou rejeita no modo Ask first. Um mod substituído manualmente vai para a pasta Mods como um arquivo .zip, e apenas um arquivo desse tipo é alterado por rodada.
Inicie o servidor com seu próprio script, deixe o agente buscar no log por mods com falha e entre no jogo. Se algo quebrar, você saberá qual alteração causou o problema e poderá mover esse arquivo ou restaurar a linha afetada a partir da cópia feita no início.
Mods/encontradoMods/examplemod/modinfo.jsonlidoversion Mods/3 correspondênciasmod-list.txtsalvo{
"ServerName": "Friends World",
"Port": 42420,
"MaxClients": 10,
"Password": null,
"AllowPvP": false,
"AdvertiseServer": false
}Este é um trecho do serverconfig.json, não um arquivo completo, contendo apenas valores de exemplo. A porta do jogo é 42420 (TCP), e uma senha nula indica que nenhuma senha foi definida, então adicione uma antes de abrir o mundo para a internet. Edite o arquivo real apenas enquanto o servidor estiver parado e mantenha sua própria cópia dele ao lado da pasta Saves.
Comece olhando antes de alterar qualquer coisa. O agente usa list_dir e glob para encontrar a pasta Mods dentro da pasta de dados, read_file para abrir o modinfo.json de cada mod que está em uma pasta e write_file para salvar uma lista simples de nomes e versões na sua pasta de trabalho. Se precisar de ajuda com mods em um servidor hospedado, verifique primeiro se consegue acessar a pasta de dados, pois o agente só pode trabalhar em arquivos que você pode abrir. Imprima a lista. Compare-a com os mods que seus jogadores têm, já que o servidor e os jogadores precisam dos mesmos mods e versões, e decida o que atualizar. Nada mudou ainda, e você tem um registro do que estava instalado antes da atualização, o que ajuda se precisar desfazer uma etapa mais tarde.
Seu mundo é um arquivo .vcdbs na pasta Saves, então copie essa pasta antes de cada atualização do jogo, alteração de mod ou de configurações. Pare o servidor primeiro. O agente usa copy_file para colocar o arquivo do mundo na pasta Backups, e Shell executa seu próprio script de backup, reportando o código de saída real no cartão. Uma cópia que nunca foi restaurada é apenas um palpite, então restaure-a uma vez em uma pasta extra, abra-a e verifique se o mundo está lá. Só então avance para a parte que altera arquivos, sabendo que há um caminho seguro de volta se a alteração falhar. Você não exclui nada, e um save nunca é removido sem uma cópia. Se a pasta contiver vários mundos, copie a pasta inteira de Saves para não perder nenhum.
Agora altere uma única coisa. Para ajustar as configurações do servidor do Vintage Story, o agente usa edit_file no serverconfig.json e mostra a diferença no modo Ask first; para atualizar um mod, você coloca o novo .zip na pasta Mods manualmente, apenas do banco de dados oficial de mods. Se o mundo não carregar após instalar um mod, a última alteração é a suspeita, e você pode desfazê-la movendo o arquivo para fora novamente. Pare aqui. Não adicione um segundo mod antes de testar o primeiro, pois duas mudanças ao mesmo tempo escondem a causa. O modo Plan only pode escrever as etapas primeiro sem executá-las, o que é útil para criar uma lista de verificação para o dia da atualização que um segundo administrador também possa ler.
Inicie o servidor com seu próprio script de início. Shell o executa e mostra o código de saída real, e depois grep pesquisa o log do servidor pelas palavras failed e error. A solução de problemas de um servidor dedicado começa por esse log, e o cartão lista cada linha correspondente para que você possa lê-las em ordem. glob encontra os arquivos de log se você não tiver certeza de qual é o mais recente. Em seguida, entre no jogo e explore o mundo. Aceite a alteração como concluída apenas após o log estar limpo e um segundo jogador ter entrado. Se não estiver limpo, volte uma etapa, leia o primeiro erro em vez do último e restaure a cópia dos saves se o mundo tiver ficado danificado.
