Cómo instalar y solucionar problemas de mods en Vintage Story

Antes de descargar un mod

La base oficial de mods de Vintage Story es el principal sitio de descubrimiento y distribución recomendado por la wiki mantenida por la comunidad y alojada en la infraestructura oficial de Vintage Story. Que un mod sea popular no significa automáticamente que sea seguro para tu configuración actual. Lee su descripción, dependencias, indicación de lado de ejecución, versiones compatibles del juego, historial de archivos e informes recientes de problemas.

Comprobación	Qué confirmar para la versión 1.22.5
Compatibilidad con el juego	El archivo elegido indica compatibilidad con la 1.22.5 o con un intervalo 1.22.x que su autor declara compatible
Dependencias	Todas las bibliotecas o mods complementarios obligatorios están instalados en versiones compatibles
Cliente o servidor	El mod está instalado en el lado que indica su página oficial
Funciones superpuestas	Ningún otro mod activo sustituye las mismas mecánicas, recursos o registros
Efecto sobre el mundo	Sabes si eliminarlo después podría borrar bloques, objetos, entidades o datos del mundo
Copia de seguridad	Existe una copia de la partida afectada fuera de la carpeta activa de guardado

No des por hecho que el archivo más reciente del mod es el correcto. La guía oficial de solución de problemas advierte expresamente que una versión más nueva del mod puede estar dirigida a otra versión del juego. La pestaña de archivos es el lugar de referencia para asociar una compilación del mod con la versión de Vintage Story que realmente estás ejecutando.

Instalar un mod en una partida individual

Descarga el archivo elegido desde la página del mod en la base oficial.
Déjalo empaquetado como archivo .zip, salvo que su autor indique expresamente otro procedimiento. La instalación normal no requiere descomprimirlo.
Inicia Vintage Story y abre Gestor de mods desde el menú principal.
Selecciona Abrir carpeta de mods. Así evitas adivinar qué carpeta de datos de usuario está utilizando la instalación.
Copia o mueve el archivo .zip del mod a esa carpeta.
Vuelve al gestor y elige Recargar mods, o cierra y reinicia el juego.
Confirma que el mod aparece y está activado. Mantén activos los componentes integrados Essentials, Survival y Creative Mode: juntos forman el juego estándar.
Prueba el cambio en un mundo nuevo o en una copia desechable antes de aplicarlo a una partida valiosa que lleve mucho tiempo activa.

En Windows, la ruta predeterminada de los mods de usuario es %appdata%\VintagestoryData\Mods. En Linux, la guía oficial indica ~/.config/VintagestoryData/Mods. El botón del gestor es una opción más segura si has personalizado la ruta de datos o has movido la instalación.

Copias de seguridad y actualizaciones

La guía oficial recomienda hacer una copia de seguridad antes de añadir o eliminar un mod, así como antes de actualizar Vintage Story. Conviene aplicar el mismo hábito a las actualizaciones importantes de los propios mods. La copia debe estar separada de la partida activa; otro archivo dentro de la misma carpeta de guardado no ofrece la misma protección.

Para actualizar un mod:

Deja de jugar y cierra el juego o el servidor.
Lee el registro de cambios del mod por si incluye instrucciones de migración o cambios incompatibles.
Copia el mundo y los archivos de configuración relevantes.
Elimina el archivo antiguo duplicado si el nuevo utiliza un nombre diferente.
Instala el reemplazo compatible y confirma que solo queda una copia activa.
Carga primero una copia de prueba y revisa los bloques, inventarios, entidades y recetas relacionados con el mod.

Lista de solución de problemas

Síntoma	Primeras comprobaciones	Siguiente acción segura
El mod no aparece	Carpeta Mods equivocada, archivo no válido o rutas `modPaths` personalizadas y obsoletas	Abre la carpeta desde el gestor; si cambió el nombre de usuario del sistema, revisa las rutas de `clientsettings.json` y `serverconfig.json` con el juego cerrado
El juego falla después de actualizar	El mod no es compatible con la 1.22.5	Desactiva los mods ajenos al juego base e instala versiones que indiquen compatibilidad con la versión actual
Faltan bloques o aparecen excepciones al iniciar	Hay dos versiones del mismo mod de código	Busca en todas las rutas de mods configuradas y conserva solo la copia que quieres usar
El fallo aparece únicamente al combinar varios mods	Existe un conflicto entre dos mods	Reprodúcelo en un mundo de prueba y desactiva la mitad del conjunto cada vez hasta aislar al responsable
El mundo funciona sin mods, pero no con ellos	Dependencia ausente, versión incorrecta o instalación en el lado equivocado	Revisa la pestaña de archivos, las dependencias y los requisitos de cliente o servidor
Un servidor con mods conserva un archivo antiguo	La caché específica del servidor contiene un archivo con el mismo nombre	Sal del servidor, elimina su carpeta dentro de `ModsByServer` y vuelve a conectarte para descargar de nuevo el conjunto del servidor

Realiza las pruebas de conflictos en un mundo nuevo o en una copia. Activar y desactivar repetidamente mods de contenido en la única copia de una partida valiosa puede eliminar o reasignar datos, y además dificulta identificar el problema original.

Mods en multijugador

Los clientes modernos de Vintage Story crean una carpeta específica dentro de ModsByServer al entrar en un servidor modificado. Los mods universales o del servidor que este ofrezca pueden descargarse para ese servidor sin mezclarse con la carpeta Mods habitual de las partidas individuales. Los mods exclusivos del cliente pueden seguir necesitando instalación manual, según el mod y las normas del servidor.

Quienes administren un servidor deben mantener compatibles la versión del servidor, sus mods y los clientes que se conectan. Cambia los mods con el servidor desconectado, crea antes una copia del mundo y prueba el conjunto completo de forma local antes de volver a abrir un servidor público. Consulta la guía de multijugador para conocer las rutas de datos, los puertos y las precauciones al actualizar.

Preguntas frecuentes

¿Debo descomprimir un mod de Vintage Story?

Normalmente no. La guía oficial de instalación indica que la mayoría de los mods se descargan como archivos .zip y deben colocarse directamente en la carpeta Mods.

¿Puede funcionar en la 1.22.5 un mod creado para una versión anterior?

Es posible, pero no conviene adivinar. Consulta la compatibilidad indicada en la pestaña de archivos y las instrucciones del autor.

¿Por qué Essentials, Survival y Creative Mode aparecen como mods?

Vintage Story construye el juego estándar mediante su propio sistema de mods. Esas tres entradas forman el juego base y, en condiciones normales, deben permanecer activadas.

¿Cómo encuentro el mod que provoca un cierre inesperado?

Crea una prueba que puedas repetir en un mundo nuevo o una copia de la partida. Desactiva la mitad de los mods ajenos al juego base y repite la prueba; después continúa dividiendo el grupo sospechoso por mitades. Este método es mucho más rápido que probar una lista grande sin un orden definido.

Cómo instalar mods en Vintage Story

Haz copia, conserva el paquete, aísla el conflicto

Copia el mundo

Conserva el .zip

Aísla