HOLYMOD
Guía · Stardew Valley

Cómo instalar mods en Stardew Valley con SMAPI

Cómo instalar mods en Stardew Valley: SMAPI en Windows, Mac, Linux y Steam Deck, la carpeta Mods, Content Patcher, gestores y errores del log.

Actualizada: 20 Oct 2026

Si te preguntas cómo instalar mods en Stardew Valley, la respuesta corta es que necesitas SMAPI, el cargador de mods del juego: lo instalas una vez con su instalador y después copias cada mod en la carpeta Mods, dentro de la carpeta del juego. La versión actual es SMAPI 4.5.2 (a octubre de 2026), que pide Stardew Valley 1.6.14 o posterior; la última versión del juego en PC es la 1.6.15 (a octubre de 2026). Funciona en Windows, macOS, Linux y Steam Deck. En Android solo hay un port no oficial, y en iOS y consolas no hay mods.

Antes de empezar

  • Abre el juego una vez sin mods y ciérralo, para que termine su configuración inicial.
  • Comprueba la versión. SMAPI 4.5.2 necesita la 1.6.14 o posterior. Muchos mods actuales, como los de Pathoschild, piden ya la 1.6.15.
  • Crea una cuenta en Nexus Mods. Es donde se publican casi todos los mods y SMAPI, y hace falta una cuenta gratuita para descargar.
  • Descarga solo de la página oficial. En cada ficha de Holymod enlazamos a la del autor. Algunos mods también están en CurseForge o en GitHub; la guía oficial para jugadores de la wiki desaconseja ModDrop.

Cómo instalar SMAPI en Stardew Valley

El proceso de base es el mismo en todos los sistemas: descarga SMAPI, descomprime el .zip fuera de la carpeta del juego y ejecuta el instalador de tu sistema. Después, cada sistema tiene sus detalles.

Windows: Steam, GOG y app de Xbox

  1. Haz doble clic en install on Windows.bat y elige instalar.
  2. Steam: el instalador te muestra una línea para las opciones de lanzamiento. Cópiala en Propiedades > Opciones de lanzamiento del juego. Tiene este formato: "C:\Program Files (x86)\Steam\steamapps\common\Stardew Valley\StardewModdingAPI.exe" %command%.
  3. GOG Galaxy: crea un archivo start.bat con start "" "C:\Program Files (x86)\GOG Galaxy\Games\Stardew Valley\StardewModdingAPI.exe", añádelo como ejecutable personalizado (Configurar > Custom executables / arguments) y ponlo como ejecutable por defecto.
  4. App de Xbox o Game Pass para PC: al instalar, indica la ruta de la carpeta Content (la encuentras en Gestionar > Archivos). Después renombra Stardew Valley.exe, por ejemplo a Stardew Valley original.exe, y pon una copia de StardewModdingAPI.exe con el nombre Stardew Valley.exe. Tendrás que repetirlo tras cada actualización del juego.

Mac

  1. En Ajustes del Sistema > Privacidad y seguridad, activa Herramientas de desarrollo para Terminal. Si no aparece la opción, ejecuta spctl developer-mode enable-terminal en Terminal. Después, reinicia.
  2. Haz clic derecho en install on macOS.command y elige Abrir.
  3. Si Gatekeeper lo bloquea, ve a Privacidad y seguridad y pulsa Abrir igualmente.

En Mac no hace falta tocar las opciones de lanzamiento de Steam.

Linux

  1. Abre una terminal en la carpeta descomprimida y da permisos: chmod +x "./install on Linux.sh" "./internal/linux/SMAPI.Installer".
  2. Ejecuta ./install\ on\ Linux.sh desde la terminal. No lo abras con doble clic: hay un fallo relacionado con syslog.

En NixOS se usa steam-run. Si el instalador falla al abrir la terminal, instala xterm.

Steam Deck

  • Versión nativa de Linux: se instala igual que en Linux, con install on Linux.sh.
  • Versión de Windows con Proton: usa SMAPI para Windows con la instalación manual que explica su README (no basta con copiar el instalador a la carpeta), añade StardewModdingAPI como juego no de Steam y fuerza Proton. Ojo: con Proton, la nube de Steam no guarda las partidas con mods.

La wiki avisa de que en la Deck los mods pueden aumentar el consumo de batería.

Cuando arranques el juego con SMAPI se abrirá junto a él una ventana de consola. Ahí verás qué mods se han cargado y cuáles han fallado.

La carpeta Mods: dónde está y cómo poner los mods

El instalador crea la carpeta Mods dentro de la carpeta del juego. Estas son las rutas habituales del juego:

  • Steam (Windows): C:\Program Files (x86)\Steam\steamapps\common\Stardew Valley
  • GOG (Windows): C:\Program Files (x86)\GOG Galaxy\Games\Stardew Valley o C:\GOG Games\Stardew Valley
  • App de Xbox: C:\XboxGames\Stardew Valley
  • Linux (Steam): ~/.local/share/Steam/steamapps/common/Stardew Valley
  • Linux (GOG): ~/GOGGames/StardewValley/game
  • macOS (Steam): ~/Library/Application Support/Steam/SteamApps/common/Stardew Valley/Contents/MacOS
  • macOS (GOG): /Applications/Stardew Valley.app/Contents/MacOS

Si no la encuentras, escribe show_game_files en la consola de SMAPI y te abrirá la carpeta.

Instalar un mod paso a paso

  1. En la página del mod, abre la pestaña Files y pulsa Manual download en el archivo principal.
  2. Descomprime el .zip fuera de la carpeta del juego.
  3. Mueve la carpeta del mod a Mods. Cada mod va en su propia subcarpeta, con su archivo manifest.json. Puedes agruparlos en subcarpetas (por ejemplo, una para las expansiones), porque SMAPI busca dentro.
  4. Instala sus dependencias de la misma forma.
  5. Arranca el juego con SMAPI y comprueba en la consola que el mod aparece sin errores en rojo.

Para desactivar un mod sin borrarlo, pon un punto delante del nombre de su carpeta.

Content Patcher y las dependencias

Muchos mods no funcionan solos: necesitan otros mods, llamados frameworks, que hacen de base. El más importante es Content Patcher: por sí solo no cambia nada, pero carga los content packs, mods que cambian datos, imágenes y mapas del juego. Retratos, retexturas, NPC nuevos y expansiones dependen de él.

  • Las carpetas que empiezan por [CP] son packs de Content Patcher, y las que empiezan por [FTM], de Farm Type Manager. Se instalan igual, en Mods, y necesitan su framework.
  • SpaceCore es otra biblioteca muy pedida: según su página, la usan más de 780 mods.
  • Generic Mod Config Menu es opcional, pero te deja cambiar las opciones de los mods desde el juego, sin abrir archivos config.json.

Un ejemplo: Stardew Valley Expanded pide SMAPI, Content Patcher y Farm Type Manager, y Ridgeside Village pide además Custom Companions y SpaceCore. Cada ficha de Holymod indica las dependencias obligatorias y las opcionales. Si arrancas el juego y falta una, la consola de SMAPI te dirá cuál.

Mods en español

Los mods que admiten traducción tienen una carpeta i18n con un archivo por idioma; el del español es es.json. El mod usa solo el idioma del juego y, si falta una frase, la muestra en inglés. Además, en Nexus hay muchas traducciones al español publicadas como mods aparte: se instalan copiando su es.json en la carpeta i18n del mod o como indique cada traducción. Antes de instalarlas, comprueba que su versión coincide con la del mod. Una traducción desfasada deja textos en inglés o claves sin traducir.

Actualizar y desinstalar

Actualizar SMAPI

Descarga la versión nueva y ejecuta su instalador: elimina la anterior. Cuando sale una actualización del juego, algunos mods pueden dejar de funcionar hasta que sus autores los adaptan, así que no tengas prisa por actualizar si tu partida depende de muchos mods.

Actualizar mods

SMAPI te avisa en la consola cuando hay versiones nuevas de los mods que tienes instalados. Para actualizar uno tienes dos opciones:

  • Limpia: borras la carpeta del mod y copias la nueva. Pierdes tu config.json.
  • Combinada: sobrescribes los archivos y conservas tu config.json. Lee antes las instrucciones del mod, por si pide otra cosa.

Desinstalar

  • Un mod: borra su carpeta de Mods.
  • SMAPI: ejecuta el instalador y elige desinstalar. En Steam para Windows, vacía también el campo de opciones de lanzamiento.

Errores comunes y el log de SMAPI

  • Un mod no carga. Mira la consola de SMAPI: indica qué mod ha fallado y, si falta una dependencia, cuál es.
  • Un pack [CP] no hace nada. Comprueba que Content Patcher aparece entre los mods cargados.
  • El mod es para otra versión. Varios mods mantienen archivos para la 1.5.6 con requisitos distintos. En la 1.6 descarga siempre el archivo principal para la 1.6 y no mezcles versiones.
  • Tras actualizar el juego fallan mods. Espera a que sus autores los actualicen. En la app de Xbox, además, repite el cambio de nombre del ejecutable.
  • En Linux el instalador no hace nada. Ejecútalo desde una terminal, no con doble clic.
  • Textos en inglés o claves raras. Suele ser una traducción aparte que no coincide con la versión del mod.

Si no ves claro el problema, sube el registro de SMAPI a smapi.io/log, el analizador de registros de SMAPI. Te lo muestra ordenado y con los errores resaltados, y es lo que te pedirán en los foros de cualquier mod si pides ayuda.

Gestores de mods: Stardrop, Vortex o a mano

Te recomendamos empezar con la descarga manual (Manual download en Nexus y descomprimir en Mods), que funciona con todos los mods. Si tienes muchos, un gestor te ahorra trabajo:

  • Stardrop (de PeacefulEnd, código abierto, para Windows, macOS y Linux): versión 1.10.4 (a octubre de 2026). Usa SMAPI para gestionar los mods y comprobar actualizaciones, y tiene perfiles de mods, útiles para el multijugador. Con el botón Mod manager download de Nexus instala con un clic en Windows y macOS. Es el gestor que menciona la guía para jugadores de la wiki. Según su página, las actualizaciones automáticas desde Nexus requieren Premium; la descarga manual es gratuita.
  • Vortex: el gestor general de Nexus, compatible con Stardew Valley. Ojo: los autores de Ridgeside Village desaconsejan instalar su mod con Vortex u otros gestores; recomiendan hacerlo a mano.
  • Nexus Mods App: el gestor nuevo de Nexus, de código abierto y con versión para Linux y Steam Deck. Stardew Valley fue su primer juego con soporte completo, con diagnósticos de SMAPI, y Nexus la presenta como futura sustituta de Vortex.

Con SMAPI funcionando, el siguiente paso es elegir qué instalar: tienes nuestra selección de los mejores mods de Stardew Valley y el listado de mods compatibles con Stardew Valley 1.6. Si juegas con amigos, mira antes la guía de mods en multijugador, y si juegas en el móvil, la de mods en Android y consolas.

Preguntas frecuentes

¿Es obligatorio instalar SMAPI?

Para casi todos los mods, sí: sin SMAPI la mayoría ni siquiera se cargan. Content Patcher y los content packs también lo necesitan.

¿Pierdo mis partidas si instalo SMAPI?

No. SMAPI convive con el juego normal y se desinstala con el mismo instalador. Eso sí, una partida que use mods de contenido, como NPC, objetos o zonas nuevas, puede depender de ellos.

¿Puedo añadir mods a una partida empezada?

Los de interfaz, sin problema. Con las expansiones depende: Stardew Valley Expanded recomienda partida nueva, mientras que Ridgeside Village tiene un modo progresivo para partidas existentes desde su versión 2.2.5.

¿Dónde está la carpeta Mods?

Dentro de la carpeta del juego. En Steam para Windows está en C:\Program Files (x86)\Steam\steamapps\common\Stardew Valley\Mods. Si no la encuentras, usa el comando show_game_files en la consola de SMAPI.