Guía Completa de SMAPI para Stardew Valley

Stardew Valley es un juego que ha capturado los corazones de millones de jugadores con su encanto rústico y su jugabilidad relajante. Pero, ¿y si te dijéramos que puedes llevar tu experiencia agrícola a un nivel completamente nuevo? Aquí es donde entra en juego el modding. Modificar el juego te permite añadir desde simples cambios estéticos hasta expansiones de contenido masivas con nuevos personajes, lugares e historias. La puerta de entrada a este increíble mundo es una herramienta esencial llamada SMAPI. Esta guía completa te enseñará todo lo que necesitas saber para instalar, usar y solucionar problemas con SMAPI, convirtiéndote en un experto en el modding de Stardew Valley.

¿Qué es SMAPI y por qué es indispensable?

SMAPI, que significa "Stardew Modding API", es un lanzador de mods para Stardew Valley. Piénsalo como un intermediario entre los mods que descargas y el juego principal. En lugar de alterar permanentemente los archivos del juego (lo que podría causar problemas irreversibles), SMAPI carga los mods de forma segura cada vez que inicias el juego a través de él. Esto no solo protege tu instalación original, sino que también ofrece una serie de ventajas:

• Seguridad: Los mods se ejecutan en un entorno controlado, lo que minimiza el riesgo de corromper tus partidas guardadas.
• Gestión Sencilla: Instalar o desinstalar mods es tan fácil como añadir o quitar una carpeta.
• Detección de Errores: SMAPI incluye una consola que te informa si los mods son incompatibles, están desactualizados o tienen algún problema, facilitando enormemente la solución de errores.
• Compatibilidad: Se actualiza constantemente para ser compatible con las últimas versiones de Stardew Valley y asegura que la mayoría de los mods funcionen en armonía.

En resumen, si quieres usar mods en Stardew Valley, necesitas SMAPI. Es la herramienta estándar de la comunidad y la base sobre la que se construyen casi todos los mods populares.

Instalación de SMAPI: Tu Primer Paso al Modding

Instalar SMAPI es un proceso sencillo. Sigue estos pasos cuidadosamente para tenerlo funcionando en pocos minutos.

Paso 1: Descargar el Archivo

La única fuente segura y oficial para descargar SMAPI es su web: smapi.io. La página detectará automáticamente tu sistema operativo (Windows, macOS o Linux) y te ofrecerá la descarga correcta. Evita descargar SMAPI de otros sitios para garantizar que obtienes la versión más reciente y libre de software malicioso.

Paso 2: Descomprimir y Ejecutar el Instalador

Una vez descargado, encontrarás un archivo .zip. Descomprímelo en una carpeta de tu elección. Dentro, verás varios archivos. Ejecuta el que corresponda a tu sistema:

• Windows:install on Windows.bat
• macOS:install on Mac.command
• Linux:install on Linux.sh

Al ejecutarlo, se abrirá una ventana de terminal o consola que te guiará en el proceso. Normalmente, detectará automáticamente la carpeta de tu juego. Si no es así, te pedirá que le indiques la ruta. Simplemente sigue las instrucciones en pantalla (generalmente, presionar la tecla '1' y luego 'Enter') para completar la instalación.

Paso 3: Configurar tu Lanzador de Juegos

Este es el paso más importante para asegurar que el juego se inicie con SMAPI. El método varía dependiendo de dónde compraste el juego.

Para usuarios de Steam:

1. Abre tu biblioteca de Steam.
2. Haz clic derecho en Stardew Valley y selecciona 'Propiedades'.
3. En la pestaña 'General', busca la sección 'Parámetros de lanzamiento'.
4. Copia y pega el siguiente texto exacto en el cuadro: "C:\Program Files (x86)\Steam\steamapps\common\Stardew Valley\StardewModdingAPI.exe" %command%
5. Importante: La ruta entre comillas debe coincidir exactamente con la ubicación de tu juego. Si instalaste Steam en otro disco, ajústala. Puedes encontrar la ruta correcta en la ventana del instalador de SMAPI.

Para usuarios de GOG Galaxy y otros:

La forma más sencilla es crear un acceso directo al archivo StardewModdingAPI.exe que ahora se encuentra en la carpeta de tu juego. Usa ese acceso directo para lanzar el juego a partir de ahora, en lugar del ejecutable original.

¡Y listo! La próxima vez que inicies Stardew Valley, deberías ver una ventana de consola de SMAPI aparecer primero, seguida del juego. Si es así, ¡felicidades, has instalado SMAPI correctamente!

Añadiendo Mods a tu Juego

Ahora viene la parte divertida. Con SMAPI instalado, añadir mods es increíblemente fácil.

1. Encuentra tus Mods: El lugar más popular y seguro para descargar mods de Stardew Valley es Nexus Mods.
2. Descarga el Mod: Busca un mod que te interese y descárgalo. Normalmente vendrá en un archivo .zip.
3. Localiza tu Carpeta 'Mods': Después de instalar SMAPI, se habrá creado una nueva carpeta llamada Mods dentro del directorio principal de Stardew Valley (la misma carpeta donde está StardewModdingAPI.exe).
4. Descomprime y Copia: Descomprime el archivo .zip del mod que descargaste. Dentro habrá una carpeta con el nombre del mod. Copia esa carpeta completa y pégala dentro de tu carpeta Mods.

Eso es todo. La próxima vez que inicies el juego a través de SMAPI, la consola te mostrará que el nuevo mod ha sido cargado. ¡Así de simple!

Resolviendo Problemas: Cómo Leer la Consola de SMAPI

A veces, las cosas no salen como se planean. Los mods pueden entrar en conflicto o causar errores. Afortunadamente, la consola de SMAPI es una herramienta de diagnóstico muy poderosa. A continuación, desglosamos los mensajes más comunes que podrías encontrar, usando un ejemplo real de un log de errores.

Error Común 1: "Access to the path is denied" (Acceso denegado)

Este es, con diferencia, el problema más frecuente para los nuevos usuarios. En la consola, podrías ver algo como:
UnauthorizedAccessException: Access to the path 'C:\Program Files (x86)\Steam\steamapps\common\Stardew Valley\Mods\ContentPatcher\config.json' is denied.

¿Qué significa? Esto ocurre porque Windows protege la carpeta Program Files. SMAPI y sus mods necesitan crear y modificar archivos de configuración, pero el sistema operativo se lo impide.

Soluciones:

• Solución Rápida: Ejecuta Steam (o el juego directamente) como administrador. Haz clic derecho en el icono y selecciona "Ejecutar como administrador".
• Solución Recomendada: Mueve tu instalación de Stardew Valley fuera de la carpeta Program Files. Puedes crear una nueva biblioteca de Steam en una ruta como C:\Games y mover el juego allí. Esto evita todos los problemas de permisos a largo plazo.

Error Común 2: Mods Omitidos por Dependencias Faltantes

A veces, la consola te dirá que un mod no se pudo cargar:
- (CM) Community Kitchen 1.0.0 because it requires mods which aren't installed (Platonymous.CustomMusic).

¿Qué significa? Muchos mods grandes dependen de otros mods más pequeños, conocidos como "frameworks" o APIs, para funcionar. En este ejemplo, el mod "Community Kitchen" necesita otro mod llamado "CustomMusic" para poder ejecutarse.

Solución: Lee siempre la descripción de los mods que descargas en Nexus Mods. La sección de "Requirements" (Requisitos) te dirá exactamente qué otros mods necesitas instalar primero. A continuación, una tabla con los frameworks más comunes que casi seguro necesitarás.

Entendiendo las Advertencias de SMAPI

No todos los mensajes en la consola son errores críticos. SMAPI también te da advertencias útiles.

• Advertencias de Actualización:You can update 1 mod: seguido de un enlace. SMAPI comprueba automáticamente si tus mods tienen versiones nuevas. Mantenerlos actualizados es clave para la estabilidad.
• Advertencias de Serializador:These mods change the save serializer... they may corrupt your save files. Mods como PyTK o SpaceCore alteran la forma en que se guardan los datos del juego. No es un error, pero es una advertencia de que si desinstalas estos mods, tu partida podría volverse ilegible. ¡Haz siempre copias de seguridad! Afortunadamente, SMAPI crea copias de seguridad automáticas en la carpeta StardewValley/Saves_Backup.
• Advertencias de Código Parcheado:These mods directly change the game code.... Esto es normal para mods grandes como Stardew Valley Expanded. Simplemente te informa que estos mods son más complejos y, si encuentras un bug, son los primeros que deberías considerar desactivar para hacer pruebas.

Preguntas Frecuentes (FAQ)

¿Usar SMAPI y mods me puede banear de Steam o afectar mis logros?

No. Stardew Valley es un juego amigable con los mods y su creador, ConcernedApe, apoya a la comunidad. No serás baneado. Los logros de Steam se desactivan por defecto, pero puedes volver a activarlos editando el archivo config.json de SMAPI si lo deseas.

¿Puedo jugar en modo multijugador con mods?

Sí, pero es crucial que todos los jugadores tengan instalados exactamente los mismos mods y las mismas versiones de esos mods para evitar problemas de sincronización y crasheos.

¿Cómo desinstalo SMAPI?

Simplemente vuelve a ejecutar el instalador de SMAPI y elige la opción de desinstalar. Esto restaurará el ejecutable original del juego.

Mi juego no inicia o se cierra solo, ¿qué hago?

El primer paso es mirar la consola de SMAPI. Lee los mensajes en rojo. Si no entiendes el error, una buena estrategia es quitar la mitad de tus mods. Si el juego funciona, el problema está en la mitad que quitaste. Repite el proceso hasta que aísles el mod problemático.

El mundo del modding de Stardew Valley es vasto y emocionante. Con esta guía, ya tienes todo el conocimiento necesario para usar SMAPI con confianza. No tengas miedo de experimentar, de probar nuevos mods y de transformar tu granja en la experiencia de tus sueños. ¡Feliz agricultura!