Stardew Valley e SMAPI: installazione, cartella Mods e come leggere il log quando qualcosa si rompe

Stardew Valley ha una delle comunità di modding più grandi tra i giochi indipendenti, e quasi tutto passa da un unico programma: SMAPI, la Stardew Modding API. Come spiega il suo README, senza SMAPI a caricarli, i mod che contengono codice non possono funzionare. Anche i “content pack”, che cambiano solo grafica e dati, di solito si appoggiano a framework che a loro volta richiedono SMAPI.

Questa guida segue la procedura su Windows con la versione di Steam o GOG. I percorsi dei file e i messaggi dell’installer che citiamo sono ricavati dal codice sorgente pubblico di SMAPI, così puoi verificarli.

Prima di iniziare: versioni compatibili

Al momento in cui scriviamo, la versione indicata su smapi.io è la 4.5.2. Le note di rilascio la descrivono come pubblicata il 14 marzo 2026 “per Stardew Valley 1.6.14 o successivo”. La serie 4.5 ha introdotto, tra l’altro, la configurazione di SMAPI dall’interno del gioco tramite il mod Generic Mod Config Menu e il rilevamento di file malevoli noti nella cartella Mods.

Controlla la versione del gioco nel menu principale, in basso a sinistra. Se il gioco è più vecchio della 1.6.14, aggiornalo prima di installare SMAPI. Se invece è appena arrivato un aggiornamento del gioco, aspetta che SMAPI venga aggiornato prima di avviare i mod.

Installazione passo per passo

1. Scarica SMAPI da smapi.io, che rimanda a Nexus Mods, CurseForge e GitHub. Evita copie caricate su siti diversi.
2. Estrai l’archivio in una cartella qualsiasi, per esempio sul desktop. Non estrarlo dentro la cartella del gioco.
3. Avvia install on Windows.bat. Si apre una finestra di testo: l’installer cerca la cartella del gioco e chiede conferma. Se il gioco è installato in un percorso non standard, ti chiede di indicarlo.
4. Scegli l’installazione: l’installer chiede di digitare 1 o 2 e premere Invio. A fine procedura l’installer mostra un messaggio di conferma.

Il README dell’installer sconsiglia l’installazione manuale “per la maggior parte dei giocatori”: richiede di estrarre file interni rinominati e copiare a mano un file di dipendenze. Usa lo script.

Avviare il gioco con SMAPI da Steam

Alla fine dell’installazione SMAPI stampa un messaggio preciso, che si legge nel codice dell’installer: se usi Steam, imposta le opzioni di avvio per abilitare achievement e overlay. La riga da usare ha questa forma:

"C:\Program Files (x86)\Steam\steamapps\common\Stardew Valley\StardewModdingAPI.exe" %command%

Il percorso tra virgolette è quello della tua installazione: l’installer stampa quello giusto, quindi conviene copiarlo direttamente dalla finestra. Per inserirlo:

1. Nella Libreria di Steam fai clic destro su Stardew Valley e scegli Proprietà.
2. Nella scheda Generali, incolla la riga nel campo Opzioni di avvio.
3. Chiudi la finestra e avvia il gioco normalmente da Steam. Insieme al gioco si apre una finestra della console di SMAPI.

Se non usi Steam, l’installer indica di avviare StardewModdingAPI.exe dalla cartella del gioco.

Dove mettere i mod

La cartella predefinita, secondo le costanti di SMAPI, è Mods dentro la cartella del gioco. Con Steam il percorso tipico è:

C:\Program Files (x86)\Steam\steamapps\common\Stardew Valley\Mods

Ogni mod scaricato è un archivio che contiene una cartella con un file manifest.json. Estrai l’archivio dentro Mods in modo che il risultato sia Mods\NomeDelMod\manifest.json. Un errore frequente è finire con una cartella in più, Mods\NomeDelMod\NomeDelMod\manifest.json: in quel caso SMAPI non trova il mod.

Prima di ogni mod nuovo leggi la sezione dei requisiti nella pagina di download: molti mod richiedono un framework come Content Patcher o librerie comuni. SMAPI segnala nella console le dipendenze mancanti, ma è più rapido scaricarle subito.

Cosa fa SMAPI per te, in automatico

Il README di SMAPI elenca le funzioni principali. Alcune lavorano in silenzio ed è utile conoscerle per interpretare quello che vedi nella console:

Quando qualcosa si rompe: il log

Il primo strumento di diagnosi è il file di log. Le costanti di SMAPI fissano i percorsi: la cartella dei dati è %AppData%\StardewValley, i log stanno nella sottocartella ErrorLogs e i salvataggi in Saves.

1. Premi Windows + R, scrivi %AppData%\StardewValley\ErrorLogs e premi Invio.
2. Se c’è un file SMAPI-crash.txt, è quello giusto: lo scrive SMAPI quando il gioco si chiude per un errore. Altrimenti apri SMAPI-latest.txt, il log dell’ultima sessione.
3. Vai su smapi.io/log e carica il file. Il parser ufficiale lo trasforma in una pagina leggibile, con i mod raggruppati e gli errori evidenziati, e ti dà un link da condividere se chiedi aiuto sui forum o su Discord.

Nel log cerca prima le righe in rosso con il nome di un mod accanto. Le cause più comuni sono una dipendenza mancante, un mod non aggiornato all’ultima versione del gioco o due mod che modificano la stessa cosa.

Salvataggi: backup automatici e manuali

I salvataggi si trovano in %AppData%\StardewValley\Saves, una sottocartella per ogni fattoria. Il backup giornaliero di SMAPI copre gli imprevisti più comuni, ma in due casi conviene fare anche una copia manuale dell’intera cartella Saves:

• prima di installare o rimuovere mod che aggiungono luoghi, personaggi o oggetti: il README di SMAPI spiega che in alcuni casi il programma ripara automaticamente i salvataggi, per esempio quando si rimuove un mod che aggiungeva un luogo, ma non è garantito per tutti i mod;
• prima di aggiornare il gioco a una nuova versione maggiore.

Per una strategia generale di backup, valida anche per altri giochi, vedi la nostra guida a salvataggi e aggiornamenti.