A 23 de octubre de 2026, con Stardew Valley en la 1.6.15 y SMAPI en la 4.5.2, casi todos los casos de «los mods no funcionan» se resuelven con cuatro comprobaciones: que el juego se abra de verdad con SMAPI, que juego, SMAPI y mods estén actualizados, que cada mod tenga sus dependencias y que esté bien colocado en la carpeta Mods. Si el juego se cierra, el log de SMAPI (SMAPI-crash.txt o SMAPI-latest.txt) dice qué mod falla; si no queda claro, desactiva los mods por mitades poniendo un punto delante del nombre de su carpeta.
Diagnóstico rápido
| Síntoma | Causa probable | Qué hacer |
|---|---|---|
| Ningún mod hace nada y no se abre la consola de SMAPI | El juego arranca sin SMAPI | Revisa las opciones de lanzamiento de Steam o abre StardewModdingAPI |
| Un mod sale en «Skipped mods» | Le falta una dependencia o pide otra versión | Instala lo que indica el motivo del log |
| Un content pack ([CP]) no cambia nada | Falta su framework, como Content Patcher | Instálalo y comprueba que carga sin errores |
| Todo dejó de funcionar tras actualizar el juego | SMAPI o mods desactualizados | Reinstala SMAPI y actualiza los mods |
| El juego se cierra al cargar la partida | Un mod de contenido roto o retirado a medias | Lee SMAPI-crash.txt y aísla el mod |
| Mensajes rojos repetidos en la consola | Un mod falla en cada momento del juego | Actualízalo o quítalo |
Para cada mensaje concreto de SMAPI (manifest.json, antivirus, «Could not load file or assembly»…) tienes la explicación detallada en nuestra guía de errores de SMAPI. Aquí vamos a lo práctico: cómo encontrar al culpable.
Paso 1: confirma que el juego se abre con SMAPI
Es el fallo más simple y más frecuente: el juego arranca como siempre, sin SMAPI, y por eso los mods no hacen nada. Con SMAPI se abre una ventana de consola junto al juego que lista los mods cargados. Si no la ves:
- Windows con Steam: las opciones de lanzamiento del juego deben ser las que te dio el instalador de SMAPI, con el formato
"…\Stardew Valley\StardewModdingAPI.exe" %command%. - Linux, macOS y Steam Deck nativa: deja las opciones de lanzamiento vacías.
- Después de una actualización del juego: si la ventana de SMAPI dejó de aparecer, vuelve a ejecutar el instalador.
Paso 2: versiones de juego, SMAPI y mods
SMAPI 4.5.2 necesita Stardew Valley 1.6.14 o posterior, y muchos mods actuales piden ya la 1.6.15: Content Patcher 2.9.1 y SpaceCore exigen esa versión. La versión del juego aparece en la pantalla de título al pulsar «?», y la de SMAPI en la primera línea de su consola. Al arrancar, SMAPI también te avisa de qué mods tienen versión nueva: la wiki aconseja actualizarlos todos, aunque parezcan funcionar. Si usas Steam, comprueba además que no estás en una rama beta que SMAPI no admite.
Paso 3: lee el log de SMAPI
SMAPI guarda cada sesión en un archivo de texto. Si el juego se cerró de golpe, abre SMAPI-crash.txt; si no existe, SMAPI-latest.txt. Están en:
- Windows (Steam o GOG): %appdata%\StardewValley\ErrorLogs
- Linux, macOS y Steam Deck: ~/.config/StardewValley/ErrorLogs
Al final de la carga, SMAPI lista los «Skipped mods» con el motivo al lado: casi siempre una dependencia que falta o una versión mínima. Si pides ayuda, sube el archivo al analizador de smapi.io/log y comparte el enlace que te da.
Paso 4: aísla el mod culpable (mitad y mitad)
- Copia tu carpeta de partidas: %appdata%\StardewValley\Saves en Windows o ~/.config/StardewValley/Saves en Linux, macOS y Steam Deck.
- En la carpeta Mods, desactiva la mitad de los mods poniendo un punto delante del nombre de su carpeta (por ejemplo, .LookupAnything). SMAPI ignora esas carpetas.
- Abre el juego. Si el fallo sigue, el culpable está entre los activos; si desaparece, entre los que desactivaste.
- Vuelve a partir el grupo sospechoso y repite hasta quedarte con un mod.
Dos trucos: desactiva los mods junto con los que dependen de ellos (si quitas Content Patcher, todos los [CP] dejan de cargar y el log se llena de avisos), y prueba primero en una partida nueva. Ojo con las expansiones: Stardew Valley Expanded y similares añaden mapas, personajes y objetos, y retirarlas de una partida empezada puede dar problemas. Por eso la copia de partidas es lo primero.
Otras causas habituales
- Carpeta mal descomprimida. Cada mod va en su propia carpeta, con su manifest.json. Si al descomprimir queda una carpeta con números (NombreDelMod-1234-1-0), mueve a Mods la carpeta real del mod.
- Mods que no son de SMAPI. Algunos mods antiguos sustituyen archivos .xnb del juego y no van en Mods. Sigue las instrucciones del autor.
- Dos versiones del mismo mod. SMAPI no carga duplicados: deja solo la más reciente.
- Steam Deck con Proton. Si ves «The library ‘libhostpolicy.so’ required to execute the application was not found», tienes el SMAPI de Linux con la versión de Windows del juego.
Más guías de Stardew Valley: cómo instalar mods, errores de SMAPI, mods de expansión y mods en multijugador.
Preguntas frecuentes
¿Por qué mis mods de Stardew Valley no hacen nada?
Lo más probable es que el juego no esté arrancando con SMAPI. Si no se abre su ventana de consola, revisa las opciones de lanzamiento de Steam o vuelve a ejecutar el instalador.
¿Cómo desactivo un mod sin borrarlo?
Pon un punto delante del nombre de su carpeta dentro de Mods. SMAPI la ignora; quita el punto para volver a activarlo.
¿Dónde está el log de SMAPI?
En %appdata%\StardewValley\ErrorLogs en Windows y en ~/.config/StardewValley/ErrorLogs en Linux, macOS y Steam Deck. Usa SMAPI-crash.txt si el juego se cerró.
¿Qué hago si un mod aparece en «Skipped mods»?
Lee el motivo que da SMAPI al lado: suele ser una dependencia que falta o una versión mínima del juego o de SMAPI. Instala o actualiza lo que pide.
¿Puedo quitar un mod a mitad de partida?
Los de interfaz o calidad de vida, normalmente sí. Los que añaden contenido (objetos, mapas, personajes) pueden dejar la partida con problemas: haz copia antes.