Errores de SMAPI en Stardew Valley: causas y soluciones

Casi todos los errores de SMAPI en Stardew Valley tienen una de estas cinco causas: el juego o SMAPI están desactualizados, a un mod le falta una dependencia, la carpeta del mod está mal colocada, el mod no es compatible con la versión 1.6 o el antivirus o las opciones de lanzamiento de Steam bloquean el arranque. Lo primero es siempre lo mismo: abre el registro (log) de SMAPI, súbelo a smapi.io/log y lee qué mods se han saltado y por qué. En esta guía te decimos dónde está ese archivo, qué significa cada error frecuente y cómo arreglarlo sin perder la partida. Si todavía no tienes SMAPI, empieza por la guía para instalar mods en Stardew Valley.

Antes de nada: comprueba las versiones

La mayoría de problemas desaparecen al poner todo al día. Revisa estas tres cosas antes de tocar ningún mod:

• Versión del juego. La última versión para PC es la 1.6.15. La ves en la pantalla de título, pulsando el botón «?»: aparece en la esquina inferior izquierda. Si usas Steam, comprueba también que no estás en la rama beta de 32 bits ni en la rama de compatibilidad, que SMAPI no admite.
• Versión de SMAPI. Aparece en la primera línea de la consola. La 4.5.2 necesita Stardew Valley 1.6.14 o posterior y funciona en Windows, macOS, Linux y Steam Deck. Para actualizar, ejecuta el instalador de la versión nueva: elimina la anterior por sí solo.
• Versión de los mods. Al arrancar, SMAPI avisa de los mods que tienen versión nueva. Según la wiki oficial, conviene actualizarlos todos, incluso los que parecen funcionar bien.

Varios mods muy usados piden versiones mínimas: Content Patcher 2.9.1 exige la 1.6.15, SpaceCore 1.28.4 también, y Lookup Anything 1.55.0 pide SMAPI 4.3.1 o posterior. Si tu juego se quedó en una versión anterior, esos mods no cargarán.

Dónde está el log de SMAPI y cómo compartirlo

SMAPI guarda todo lo que pasa al arrancar en un archivo de texto. Si el juego se ha cerrado de golpe, busca SMAPI-crash.txt; si no existe, usa SMAPI-latest.txt. Estas son las rutas que indica smapi.io:

Para pedir ayuda, arrastra el archivo a la página del analizador de smapi.io/log, súbelo y comparte el enlace que te da. Si el archivo es demasiado grande, la wiki recomienda copiar desde el principio hasta los primeros errores y analizar solo ese trozo. Las primeras líneas del log listan los mods que tienen actualización pendiente.

Los errores de SMAPI más frecuentes

Esta tabla resume los síntomas más habituales. Debajo tienes cada caso con más detalle.

Mods saltados por falta de dependencias

Es el error más común. Al final de la carga, SMAPI lista los mods que no ha podido cargar («Skipped mods») con el motivo al lado. Muchas veces el mod necesita otro que no tienes. Las grandes expansiones son el ejemplo típico:

• Stardew Valley Expanded 1.15.11 pide Content Patcher y Farm Type Manager. Ya no usa Json Assets, SpaceCore ni Shop Tile Framework.
• Ridgeside Village pide además Custom Companions y SpaceCore.
• East Scarp necesita siete requisitos, entre ellos MEEP, HxW Tilesheets y las dos hojas de casillas de Lumisteria.
• Json Assets no funciona sin SpaceCore y Expanded Preconditions Utility.
• Los mods de bcmpinc, como Bigger Backpack o Wear More Rings, necesitan StardewHack.

La solución es descargar la dependencia que nombra el log desde su página oficial y ponerla en Mods. Si el motivo es que el mod pide una versión más nueva de SMAPI o del juego, actualiza primero eso. Tienes una explicación de para qué sirve cada framework en la sección de frameworks de Stardew Valley.

«Skipped ‘…’ because it doesn’t have a manifest.json»

Según la wiki, este aviso significa que esa carpeta no es un mod de SMAPI. Puede pasar por dos motivos:

• Carpeta mal descomprimida. Cada mod necesita su propia subcarpeta con su manifest.json. Si la descarga se descomprime en una carpeta con números (por ejemplo, NombreDelMod-1234-1-0), entra y mueve a Mods la carpeta real del mod. La wiki aconseja descomprimir primero fuera de Mods para no dejar archivos sueltos.
• Mod que no es de SMAPI. Algunos mods antiguos sustituyen archivos .xnb del juego. Un ejemplo es Lili’s Portraits, que se copia en la carpeta Content\Portraits y no en Mods. Sigue las instrucciones del autor.

Las carpetas anidadas para organizar mods sí están permitidas: SMAPI busca dentro de cada carpeta hasta encontrar los archivos del mod.

SMAPI no abre o la ventana se cierra al instante

La wiki oficial propone estos pasos, en este orden:

1. Revisa las opciones de lanzamiento de Steam. En Windows deben coincidir con las que indica el instalador de SMAPI. En Linux y macOS, con SMAPI, déjalas vacías.
2. Borra el archivo startup_preferences de la carpeta de datos del juego.
3. Actualiza los controladores de la tarjeta gráfica y cierra programas que se enganchan al juego, como MSI Afterburner o RivaTuner.
4. En Linux, si tu terminal no es compatible, instala xterm.
5. Para ver el error, abre una terminal en la carpeta del juego y ejecuta .\StardewModdingAPI.exe en Windows o ./StardewModdingAPI en Mac y Linux.

Si Steam dice «missing executable», el problema también está en las opciones de lanzamiento. Si desinstalas SMAPI, esa casilla debe quedar completamente vacía.

El antivirus bloquea SMAPI o un mod

La wiki explica que suele ser un falso positivo: SMAPI es de código abierto y lo mantiene Pathoschild. Añade una excepción para SMAPI, el juego y su carpeta. Desde la versión 4.5, SMAPI incluye además su propia detección de archivos maliciosos en los mods. Si el instalador se abre y se cierra, ejecuta install on Windows.bat desde una ventana de comandos para ver el error.

«Could not load file or assembly» o el juego sigue en una versión vieja

Suele indicar archivos dañados o dos copias del juego instaladas. Restablece los archivos desde Steam, GOG Galaxy o la app de Xbox (opción de verificar o reparar). Si tienes dos instalaciones, la wiki recomienda guardar la carpeta Mods, desinstalar, borrar las dos carpetas, reinstalar el juego y SMAPI y volver a copiar los mods.

Un content pack no hace nada

Los mods con el prefijo [CP] son packs de Content Patcher y no funcionan solos. Comprueba en la consola que Content Patcher se ha cargado sin errores. Lo mismo vale para los packs de Alternative Textures, Fashion Sense o Farm Type Manager: si su framework falla, el pack se queda sin efecto.

Cargas muy lentas, tirones o falta de memoria

• En Windows, si la consola muestra «Select», haz clic en ella y pulsa Intro varias veces, como indica la wiki.
• Las listas de mods muy largas pueden tardar varios minutos en cargar. Es normal.
• Si la consola repite el mismo error sin parar, ese mod es el culpable de los tirones.
• En equipos con dos tarjetas gráficas, asigna StardewModdingAPI.exe a la gráfica dedicada («Alto rendimiento») en la configuración de gráficos de Windows.
• En Linux y Steam Deck, la wiki sugiere poner ListenForConsoleInput en false dentro de smapi-internal/config.json.
• Ante un OutOfMemoryException, quita mods de contenido que no uses.

Errores dentro de la partida

Algunos fallos no impiden arrancar, pero aparecen al jugar. Los más habituales:

• Eventos atascados. Event Repeater trae un salto de emergencia (Ctrl + S) para eventos que se quedan colgados. Muchos mods de personajes ya lo piden.
• Un evento de mascota que se repite. La wiki lo atribuye a que la mascota comparte nombre con un NPC, a menudo de Stardew Valley Expanded. Cámbiale el nombre.
• Errores en multijugador. Farm Type Manager y SpaceCore deben tenerlos todos los jugadores. Si solo los tiene el anfitrión, el resto puede ver errores. Más detalles en la guía de mods en multijugador.
• Objetos rotos al desinstalar. Antes de quitar Json Assets, su autor pide retirar del juego los objetos que añadía. Con SVE, si donas las Galdoran Gems al museo, activa la opción que permite moverlas.

Cómo encontrar el mod que da problemas

Si el log no señala a un mod concreto, aíslalo tú. Antes de nada, copia tu carpeta de partidas.

1. Desactiva la mitad de los mods. Para desactivar uno sin borrarlo, pon un punto delante del nombre de su carpeta (por ejemplo, .Automate).
2. Arranca el juego. Si el error desaparece, el culpable está en la mitad que has desactivado. Si sigue, está en la otra.
3. Repite con la mitad sospechosa hasta quedarte con un solo mod. Deja siempre activas las dependencias de los mods que pruebes.

Cuando lo encuentres, reinstálalo limpio: borra su carpeta, descárgalo de nuevo y revisa en la página del autor si es compatible con tu versión. La lista de compatibilidad de smapi.io/mods indica qué mods están rotos con la versión actual. SMAPI desactiva por su cuenta la mayoría de mods incompatibles.

Herramientas que evitan errores

• Stardrop: gestor de mods con perfiles (por ejemplo, uno para jugar solo y otro para multijugador), avisos de mods incompatibles y búsqueda de actualizaciones a través de SMAPI. Su interfaz está en español.
• Generic Mod Config Menu: cambia las opciones de los mods dentro del juego. Así no tienes que editar el config.json a mano, que es otra fuente de errores. Si lo editas, hazlo con el juego cerrado y respeta las comillas.
• Skip Intro: se salta los logotipos del arranque. Es útil si vas a reiniciar muchas veces para probar.

Más guías de Stardew Valley: cómo instalar mods con SMAPI, los mejores mods de la 1.6, mods de expansión y mods en Android y consolas.

Preguntas frecuentes

¿Dónde veo qué error me da SMAPI?

En la propia consola de SMAPI y en el archivo SMAPI-latest.txt (o SMAPI-crash.txt si el juego se cerró). En Windows con Steam está en %appdata%\StardewValley\ErrorLogs. Súbelo a smapi.io/log para leerlo ordenado.

¿Por qué SMAPI dice que un mod se ha saltado si lo tengo instalado?

Porque le falta una dependencia, pide una versión más nueva de SMAPI o del juego, o su carpeta no contiene un manifest.json. El motivo aparece al lado de su nombre en la lista «Skipped mods».

¿Pierdo la partida si un mod da error?

Normalmente no: si un mod no carga, la partida sigue ahí. El riesgo está en guardar sin un mod que añadía objetos o zonas. Copia tu carpeta de partidas antes de cambiar o quitar mods.

¿Puedo usar SMAPI en Switch, PS4 o Xbox?

No. SMAPI solo funciona en Windows, macOS, Linux y Steam Deck. En Android existe un port no oficial y experimental, que no es el mismo programa.

¿Cómo actualizo SMAPI sin romper nada?

Descarga el instalador nuevo desde smapi.io y ejecútalo: sustituye la versión anterior. Tus mods siguen en la carpeta Mods. Después arranca el juego y actualiza los mods que la consola marque como desfasados.