Ha salido una actualización del juego y quieres poner al día tus mods y tu mundo sin perder el progreso. Cambiar la configuración del servidor de Vintage Story y añadir mods son los dos cambios que pueden impedir que el mundo cargue, por eso este flujo los ejecuta en un orden fijo: copia los saves, cambia una cosa, inicia el servidor y lee el log, luego cambia la siguiente cosa. Cascadia Merge se encarga del trabajo con archivos y te muestra cada resultado como una tarjeta. Tú tomas todas las decisiones y mantienes el servidor detenido mientras cambian los archivos. Planifica dedicar tu tiempo a leer los diffs y el log, no a escribir rutas, y anota la versión de cada mod antes de cambiarla, para que la lista sirva como tu registro del día de actualización.
Elige la carpeta de datos del servidor como la carpeta de trabajo de un nuevo chat. El agente lista la carpeta con list_dir, para que puedas ver Saves, Backups y Mods antes de que se toque nada. En un PC con Windows, la ubicación predeterminada es la carpeta VintagestoryData dentro de la carpeta AppData\Roaming de tu usuario, a menos que hayas iniciado el servidor con otra ruta de datos.
Con el servidor detenido, el agente copia la carpeta Saves en Backups con tu propio script de respaldo. Lees el código de salida en la tarjeta, pides un segundo list_dir de la carpeta Backups y confirmas que la nueva copia está realmente allí antes de continuar.
Edita serverconfig.json o reemplaza un mod, nunca ambos a la vez. El agente muestra el diff para un cambio de configuración, y tú lo aceptas o lo rechazas en modo Ask first. Un mod que reemplaces a mano va a la carpeta Mods como un archivo .zip, y solo cambia un archivo de ese tipo por ronda.
Inicia el servidor con tu propio script, deja que el agente busque en el log los mods que fallaron y únete desde el juego. Si algo falla, sabrás qué cambio lo causó y podrás mover ese archivo o restaurar esa línea desde la copia que hiciste al inicio.
Mods/encontradoMods/examplemod/modinfo.jsonleídoversion Mods/3 coincidenciasmod-list.txtguardado{
"ServerName": "Friends World",
"Port": 42420,
"MaxClients": 10,
"Password": null,
"AllowPvP": false,
"AdvertiseServer": false
}Este es un fragmento de un serverconfig.json, no un archivo completo, con valores de marcador de posición. El puerto del juego es 42420 (TCP), y una contraseña nula significa que no hay contraseña configurada, así que añade una antes de abrir el mundo a internet. Edita el archivo real solo mientras el servidor está detenido y mantén tu propia copia junto a la carpeta Saves.
Empieza por mirar antes de cambiar algo. El agente usa list_dir y glob para encontrar la carpeta Mods dentro de la carpeta de datos, read_file para abrir el modinfo.json de cada mod que está en una carpeta, y write_file para guardar una lista simple de nombres y versiones en tu carpeta de trabajo. Si necesitas ayuda con mods en un servidor alojado, primero verifica que puedas acceder a su carpeta de datos, porque el agente solo puede trabajar en archivos que puedas abrir. Imprime la lista. La comparas con los mods que tienen tus jugadores, ya que el servidor y los jugadores necesitan los mismos mods y versiones, y decides qué actualizar. Nada ha cambiado aún y tienes un registro de lo que estaba instalado antes de la actualización, lo que ayuda si debes deshacer un paso más tarde.
Tu mundo es un archivo .vcdbs en la carpeta Saves, así que copia esa carpeta antes de cada actualización del juego, cambio de mod y cambio de configuración. Detén el servidor primero. El agente usa copy_file para colocar el archivo del mundo en la carpeta Backups, y Shell ejecuta tu propio script de respaldo e informa el código de salida real en la tarjeta. Una copia que nunca se restauró es solo una suposición, así que restaura una vez en una carpeta de repuesto, ábrela y verifica que el mundo esté allí. Solo entonces pasas a la parte del trabajo que cambia archivos, con una vía segura de regreso si el cambio sale mal. No eliminas nada y un save nunca se quita sin una copia. Si la carpeta contiene varios mundos, copia toda la carpeta Saves para que no se pase ninguno por alto.
Ahora cambia una sola cosa. Para ajustar la configuración del servidor de Vintage Story, el agente usa edit_file en serverconfig.json y muestra el diff en modo Ask first; para actualizar un mod, colocas el nuevo .zip en la carpeta Mods tú mismo, solo desde la base de datos oficial de mods. Si el mundo no carga después de instalar un mod, el último cambio es el sospechoso y puedes deshacerlo moviendo ese archivo de nuevo. Detente aquí. No añades un segundo mod antes de que el primero haya sido probado, porque dos cambios a la vez ocultan la causa. Plan only puede escribir los pasos primero sin ejecutarlos, lo cual es útil cuando quieres una lista de verificación para el día de actualización que un segundo administrador pueda leer también.
Inicia el servidor con tu propio script de inicio. Shell lo ejecuta y muestra el código de salida real, y luego grep busca en el log del servidor las palabras failed y error. La resolución de problemas de un servidor dedicado comienza con ese log, y la tarjeta lista cada línea coincidente para que puedas leerlas en orden. glob encuentra los archivos de log si no estás seguro de cuál es el más reciente. Luego te unes desde el juego y caminas por el mundo. Aceptas el cambio como terminado solo después de que el log esté limpio y un segundo jugador se haya unido. Si no está limpio, retrocedes un paso, lees el primer error en lugar del último y restauras la copia de los saves si el mundo en sí se ha dañado.
