Une mise à jour du jeu est sortie et vous voulez mettre vos mods et votre monde à jour sans perdre le monde. Modifier les paramètres du serveur Vintage Story et ajouter des mods sont les deux changements qui peuvent empêcher le chargement d’un monde, c’est pourquoi ce flux les exécute dans un ordre fixe : copiez les sauvegardes, modifiez une chose, lancez le serveur et lisez le journal, puis modifiez la chose suivante. Cascadia Merge effectue le travail sur les fichiers et vous affiche chaque résultat sous forme de carte. Vous prenez chaque décision et vous gardez le serveur arrêté pendant que les fichiers changent. Prévoyez de passer votre temps à lire les différences et le journal, pas à taper des chemins, et notez la version de chaque mod avant de le modifier, afin que la liste serve de registre pour ce jour de mise à jour.
Choisissez le dossier de données du serveur comme dossier de travail pour une nouvelle conversation. L’agent liste le dossier avec list_dir, afin que vous puissiez voir Saves, Backups et Mods avant qu’une modification ne soit effectuée. Sur un PC Windows, l’emplacement par défaut est le dossier VintagestoryData sous le dossier AppData\Roaming de votre utilisateur, sauf si vous avez démarré le serveur avec un autre chemin de données.
Serveur arrêté, l’agent copie le dossier Saves dans Backups à l’aide de votre propre script de sauvegarde. Vous lisez le code de sortie dans la carte, demandez une deuxième list_dir du dossier Backups et confirmez que la nouvelle copie est bien présente avant de continuer.
Modifiez serverconfig.json ou remplacez un seul mod, jamais les deux à la fois. L’agent affiche la différence pour un changement de paramètre, et vous l’acceptez ou la rejetez en mode Ask first. Un mod que vous remplacez manuellement va dans le dossier Mods sous forme de fichier .zip, et un seul fichier de ce type change par tour.
Démarrez le serveur avec votre propre script, laissez l’agent rechercher les mods défaillants dans le journal et connectez-vous depuis le jeu. Si quelque chose se brise, vous savez quel changement en est la cause et vous pouvez déplacer ce fichier ou restaurer cette ligne à partir de la copie effectuée au début.
Mods/foundMods/examplemod/modinfo.jsonreadversion Mods/3 matchesmod-list.txtsaved{
"ServerName": "Friends World",
"Port": 42420,
"MaxClients": 10,
"Password": null,
"AllowPvP": false,
"AdvertiseServer": false
}Ceci est un extrait de serverconfig.json, pas un fichier complet, avec uniquement des valeurs fictives. Le port du jeu est 42420 (TCP) et un mot de passe nul signifie qu’aucun mot de passe n’est défini, alors ajoutez-en un avant d’ouvrir le monde à Internet. Modifiez le fichier réel uniquement lorsque le serveur est arrêté, et gardez votre propre copie à côté du dossier Saves.
Commencez par regarder avant de modifier quoi que ce soit. L’agent utilise list_dir et glob pour trouver le dossier Mods à l’intérieur du dossier de données, read_file pour ouvrir le modinfo.json de chaque mod qui se trouve dans un dossier, et write_file pour enregistrer une liste simple de noms et de versions dans votre dossier de travail. Si vous avez besoin d’aide pour les mods sur un serveur hébergé, vérifiez d’abord que vous pouvez accéder à son dossier de données, car l’agent ne peut travailler que sur les fichiers que vous pouvez ouvrir. Imprimez la liste. Vous la comparez avec les mods de vos joueurs, car le serveur et les joueurs doivent avoir les mêmes mods et versions, et vous décidez quoi mettre à jour. Rien n’a encore changé et vous avez un registre de ce qui était installé avant la mise à jour, ce qui aide si vous devez annuler une étape plus tard.
Votre monde est un fichier .vcdbs dans le dossier Saves, alors copiez ce dossier avant chaque mise à jour du jeu, changement de mod et modification des paramètres. Arrêtez d’abord le serveur. L’agent utilise copy_file pour placer le fichier du monde dans le dossier Backups, et Shell exécute votre propre script de sauvegarde et rapporte le véritable code de sortie dans la carte. Une copie qui n’a jamais été restaurée n’est qu’une supposition, alors restaurez-la une fois dans un dossier de secours, ouvrez-la et vérifiez que le monde est bien présent. Ce n’est qu’alors que vous passez à la partie du travail qui modifie les fichiers, avec une sortie de secours si le changement échoue. Vous ne supprimez rien et une sauvegarde n’est jamais retirée sans copie. Si le dossier contient plusieurs mondes, copiez tout le dossier Saves afin qu’aucun ne soit oublié.
Modifiez maintenant une seule chose. Pour ajuster les paramètres du serveur Vintage Story, l’agent utilise edit_file sur serverconfig.json et affiche la différence en mode Ask first ; pour mettre à jour un mod, vous placez vous-même le nouveau .zip dans le dossier Mods, uniquement depuis la base de données officielle des mods. Si le monde ne se charge pas après l’installation d’un mod, le dernier changement est suspect et vous pouvez l’annuler en déplaçant à nouveau ce fichier. Arrêtez-vous ici. Vous n’ajoutez pas un deuxième mod avant que le premier n’ait été testé, car deux changements à la fois masquent la cause. Plan only peut d’abord rédiger les étapes sans les exécuter, ce qui est utile lorsque vous souhaitez une liste de contrôle pour le jour de mise à jour qu’un deuxième administrateur peut également lire.
Démarrez le serveur avec votre propre script de démarrage. Shell l’exécute et affiche le véritable code de sortie, puis grep recherche les mots failed et error dans le journal du serveur. Le dépannage d’un serveur dédié commence par ce journal, et la carte liste chaque ligne correspondante afin que vous puissiez les lire dans l’ordre. glob trouve les fichiers journal si vous n’êtes pas sûr de quel est le plus récent. Ensuite, vous vous connectez depuis le jeu et vous explorez le monde. Vous acceptez le changement comme terminé uniquement après que le journal est propre et qu’un deuxième joueur s’est connecté. Si le journal n’est pas propre, revenez d’une étape, lisez la première erreur plutôt que la dernière et restaurez la copie des sauvegardes si le monde lui-même est endommagé.
