È uscito un aggiornamento del gioco e vuoi portare le tue mod e il tuo mondo all'ultima versione senza perdere i progressi. Le modifiche alle impostazioni del server di Vintage Story e l'aggiunta di mod sono le due cose che possono impedire il caricamento di un mondo, quindi questo flusso di lavoro le esegue in un ordine fisso: copia i salvataggi, cambia una cosa alla volta, avvia il server e leggi il log, poi passa alla modifica successiva. Cascadia Merge si occupa del lavoro sui file e ti mostra ogni risultato come una scheda. Prendi ogni decisione tu, e tieni il server spento mentre i file vengono modificati. Dedica il tuo tempo alla lettura delle differenze e del log, non alla digitazione dei percorsi, e annota la versione di ogni mod prima di cambiarla, così da avere un registro aggiornato.
Scegli la cartella dei dati del server come cartella di lavoro per una nuova chat. L'agente elenca il contenuto della cartella con list_dir, così puoi vedere Saves, Backups e Mods prima che venga toccato qualsiasi file. Su un PC Windows la posizione predefinita è la cartella VintagestoryData sotto AppData\Roaming del tuo utente, a meno che tu non abbia avviato il server con un percorso dati diverso.
Con il server spento, l'agente copia la cartella Saves in Backups utilizzando il tuo script di backup. Leggi il codice di uscita nella scheda, chiedi un secondo list_dir della cartella Backups e conferma che la nuova copia sia effettivamente presente prima di procedere.
Modifica serverconfig.json o sostituisci una mod, mai entrambe contemporaneamente. L'agente mostra la differenza per una modifica alle impostazioni e tu la accetti o la rifiuti in Ask first. Una mod sostituita manualmente va nella cartella Mods come file .zip e solo un file di questo tipo cambia per ogni turno.
Avvia il server con il tuo script, lascia che l'agente cerchi nel log le mod non funzionanti e unisciti dal gioco. Se qualcosa si rompe, sai quale modifica lo ha causato e puoi spostare quel file o ripristinare quella riga dalla copia fatta all'inizio.
Mods/trovatoMods/examplemod/modinfo.jsonlettoversion Mods/3 corrispondenzemod-list.txtsalvato{
"ServerName": "Friends World",
"Port": 42420,
"MaxClients": 10,
"Password": null,
"AllowPvP": false,
"AdvertiseServer": false
}Questo è un estratto di un serverconfig.json, non un file completo, con solo valori segnaposto. La porta di gioco è 42420 (TCP) e una password vuota significa che non è impostata nessuna password, quindi aggiungine una prima di aprire il mondo a Internet. Modifica il file reale solo mentre il server è spento e tieni una tua copia accanto alla cartella Saves.
Inizia a guardare prima di modificare qualsiasi cosa. L'agente usa list_dir e glob per trovare la cartella Mods all'interno della cartella dei dati, read_file per aprire il modinfo.json di ogni mod che si trova in una cartella e write_file per salvare un elenco semplice di nomi e versioni nella tua cartella di lavoro. Se hai bisogno di aiuto per le mod su un server ospitato, controlla prima di poter raggiungere la sua cartella dei dati, perché l'agente può lavorare solo sui file che puoi aprire. Stampa l'elenco. Lo confronti con le mod che hanno i tuoi giocatori, poiché server e giocatori devono avere le stesse mod e le stesse versioni, e decidi cosa aggiornare. Nulla è ancora cambiato e hai un registro di cosa era installato prima dell'aggiornamento, il che aiuta se devi annullare un passaggio in seguito.
Il tuo mondo è un file .vcdbs nella cartella Saves, quindi copia quella cartella prima di ogni aggiornamento del gioco, modifica della mod e modifica delle impostazioni. Ferma prima il server. L'agente usa copy_file per posizionare il file del mondo nella cartella Backups e Shell esegue il tuo script di backup segnalando il vero codice di uscita nella scheda. Una copia che non è mai stata ripristinata è solo un'ipotesi, quindi ripristinala una volta in una cartella di riserva, aprila e controlla che il mondo sia presente. Solo allora passi alla parte del lavoro che modifica i file, con una via di fuga sicura se la modifica va male. Non elimini nulla e un salvataggio non viene mai rimosso senza una copia. Se la cartella contiene più mondi, copia l'intera cartella Saves in modo che nessuno di essi venga trascurato.
Ora modifica una singola cosa. Per regolare le impostazioni del server di Vintage Story, l'agente usa edit_file su serverconfig.json e mostra la differenza in Ask first; per aggiornare una mod, posizioni tu stesso il nuovo .zip nella cartella Mods, solo dal database ufficiale delle mod. Se il mondo non si carica dopo aver installato una mod, l'ultima modifica è il sospettato e puoi annullarla spostando di nuovo quel file. Fermati qui. Non aggiungi una seconda mod prima che la prima sia stata testata, perché due modifiche contemporaneamente nascondono la causa. Plan only può scrivere prima i passaggi senza eseguirli, il che è utile quando vuoi una lista di controllo per il giorno dell'aggiornamento che un secondo amministratore possa leggere.
Avvia il server con il tuo script di avvio. Shell lo esegue e mostra il vero codice di uscita, poi grep cerca nel log del server le parole failed e error. Il troubleshooting di un server dedicato inizia con quel log e la scheda elenca ogni riga corrispondente in modo che tu possa leggerle in ordine. glob trova i file di log se non sei sicuro di quale sia il più recente. Poi ti unisci dal gioco e cammini nel mondo. Accetti la modifica come completata solo dopo che il log è pulito e un secondo giocatore si è unito. Se non è pulito, torni indietro di un passo, leggi il primo errore invece dell'ultimo e ripristini la copia dei salvataggi se il mondo stesso è diventato danneggiato.
