Introducción al sistema de carga de mods

SMAPI (Stardew Valley Modding API) actúa como intermediario entre los mods y el juego base, ofreciendo un entorno seguro y estable para ejecutar modificaciones. Este sistema maneja automáticamente la carga de componentes, resolución de conflictos y mantenimiento de comptaibilidades.

Configuración inicial multiplataforma

El proceso de instalación varía según el sistema operativo utilizado.

Entorno Windows

# Obtener archivos del instalador
git clone https://gitcode.com/gh_mirrors/smap/SMAPI

# Ejecutar script de configuración
cd SMAPI/src/SMAPI.Installer/assets
.\install_on_windows.bat

Sistemas basados en Unix

# Para macOS
cd SMAPI/src/SMAPI.Installer/assets
chmod +x "./install_on_macos.command"
./install_on_macos.command

# Para distribuciones Linux
cd SMAPI/src/SMAPI.Installer/assets
chmod +x "./install_on_linux.sh"
./install_on_linux.sh

Organización de configuraciones de mods

Es posible gestionar múltiples conjuntos de mods mediante carpetas separadas y parámetros de inicio personalizados.

# Estructura de directorios recomendada
MisMods_Granja/
MisMods_Aventura/
MisMods_Experimental/

Para especificar la ruta de mods al iniciar:

# En sistemas Windows (acceso directo modificado)
StardewModdingAPI.exe --mod-directory "MisMods_Granja"

# En sistemas Linux/macOS (variable de entorno)
export SMAPI_MODS_DIR="MisMods_Granja"

Optimización del rendimiento

El archivo de configuración principal permite ajustar parámetros de rendimiento:

{
  "CargaRapida": true,
  "VerificarActualizaciones": false,
  "ModulosPrioritarios": [
    "ContentPatcher",
    "SpaceCore"
  ],
  "DeshabilitarAnalisis": true
}

Diagnóstico de problemas comunes

Los archivos de registro se generan en ubicaciones específicas según el sistema:

# Ubicaciones de logs por sistema operativo
Windows: %AppData%/StardewValley/registros/
macOS: ~/.config/StardewValley/registros/
Linux: ~/.local/share/StardewValley/registros/

Los mensajes de registro se categorizan por nivel de severidad:

• [INFORMACIÓN]: Operaciones normales del sistema
• [ADVERTENCIA]: Problemas potenciales no críticos
• [ERROR]: Fallos que requieren intervención
• [CRÍTICO]: Estados que pueden causar cierre inesperado

Entorno de desarrollo integrado

El modo desarrollador proporciona herramienats de depuración avanzadas:

# Activación mediante parámetros de línea de comandos
StardewModdingAPI.exe --dev

# Alternativa mediante archivo de configuración
{
  "ModoDesarrollador": true,
  "NivelRegistro": "TRACE"
}

Comandos útiles en la consola de desarrollo:

Gestión automatizada de copias de seguridad

#!/bin/bash
# Script de respaldo para sistemas Linux/macOS
CARPETA_RESPALDO="respaldos_mods"
FECHA=$(date +%Y%m%d_%H%M%S)
tar -czf "${CARPETA_RESPALDO}/mods_${FECHA}.tar.gz" \
  Mods/ \
  --exclude="*.tmp" \
  --exclude="*.log" \
  --exclude="cache/"

Resolución de dependencias

El archivo manifiesto de cada mod define sus requisitos:

{
  "IdMod": "ejemplo_mod",
  "Version": "2.1.0",
  "DependenciasRequeridas": [
    {
      "IdMod": "FrameworkPrincipal",
      "VersionMinima": "3.0.0"
    }
  ],
  "DependenciasOpcionales": [
    {
      "IdMod": "PaqueteIdiomas",
      "VersionMinima": "1.2.0"
    }
  ]
}

Para verificar compatibilidades entre mods instalados, se puede utilizar el comando:

verificar_dependencias --todos

Prácticas de mantenimiento preventivo

1. Realizar verificaciones periódicas de actualizaciones
2. Crear puntos de restauración antes de pruebas con nuevos mods
3. Documentar la configuración funcional en archivos README
4. Implementar pruebas de integración tras actualizaciones importantes