Neocortex Logo

Mod AI per Stardew Valley: abitanti parlanti e comandi vocali

Costruisci una mod AI per gli abitanti di Stardew Valley con SMAPI e Neocortex: abitanti che ti ricordano, tappe narrative delle feste, quiz agricoli e comandi vocali.

Neocortex TeamThe team behind Neocortex

· 6 min di lettura

Costruisci una mod AI per gli abitanti di Stardew Valley con SMAPI e Neocortex: abitanti che ti ricordano, tappe narrative delle feste, quiz agricoli e comandi vocali.

Entra nel saloon e chiedi ad Abigail com'è andata la sua settimana. Con due cuori è gentile e sbrigativa; con otto tira fuori la grotta che avete esplorato insieme e ti prende in giro per l'ametista che le hai regalato tre giorni di fila. È questo che può fare una mod AI per gli abitanti di Stardew Valley.

I dialoghi scritti a mano del gioco sono amati, e già al secondo anno i giocatori ne vedono la fine. La conversazione aperta fa parlare quei personaggi, e ricorda i tuoi cuori, i tuoi regali e la volta che hai dimenticato un compleanno. Neocortex dà alla tua mod SMAPI i personaggi AI, le Conversation Flow per le scene delle feste, un motore di quiz e comandi vocali sul dispositivo.

Schermata di gioco di Stardew Valley Schermata: Stardew Valley © ConcernedApe

Cuori, regali e memoria

La risposta di Abigail dipende dai fatti che la tua mod invia con ogni messaggio: livello di cuori, regali della settimana, stagione e giorno, il tempo, e eventi recenti come «il giocatore ha vinto l'Egg Festival». Il personaggio mantiene la sessione, quindi la conversazione prosegue da dove si era interrotta. Ogni risposta torna con il testo, un tag di emozione per il ritratto e a volte un'azione che la tua mod esegue, come { "name": "GIVE_ITEM", "targetId": "coffee" }.

Nulla di tutto questo sostituisce i dialoghi scritti a mano. Quelli restano; la conversazione aperta riempie gli spazi tra l'uno e l'altro.

I personaggi si costruiscono in un editor visuale a nodi con nodi di personalità, emozione, conoscenza e voce, così puoi dare a Linus un file di testo sulla sua tenda e sul suo passato. Fino a sei personaggi possono condividere una conversazione nei piani Pro e Team, il che si adatta a una serata al saloon con Pam, Gus ed Emily.

Un mod SMAPI può chiamare un'API web?

Sì. Quasi ogni mod di Stardew Valley gira su SMAPI (GitHub), la Stardew Modding API. La release attuale è la linea 4.5, per Stardew Valley 1.6.14 o successivo. La versione 1.7 del gioco è stata annunciata senza data di uscita.

Le mod SMAPI sono progetti C# su .NET 6 con un manifest.json. La tua classe di ingresso si iscrive agli eventi di gioco (giorno iniziato, menu cambiato, pulsante premuto, renderizzato) e legge direttamente lo stato del gioco. Essendo semplice .NET, una mod può chiamare un'API web con HttpClient, mostrare le risposte nella casella di dialogo del gioco o in un menu personalizzato, e riprodurre una clip WAV restituita tramite l'audio MonoGame del gioco. SMAPI legge anche un config.json per ogni mod, ed è lì che va la chiave API del giocatore.

E Content Patcher (GitHub)? Carica content pack che modificano dati, immagini e mappe di gioco senza cambiare i file del gioco. Usalo per nuovi ritratti, uno stand della festa o battute di riserva scritte a mano, e tieni la logica AI nella tua mod SMAPI. Le pagine sul modding della Stardew Valley Wiki coprono entrambi in profondità.

Un metodo TalkTo per la tua mod

Ecco una chiamata minima di chat da una mod SMAPI. Invia stagione, giorno e livello di cuori come evento, e restituisce il primo messaggio con le sue battute, azioni e flowState:

private static readonly HttpClient Http = new() { BaseAddress = new Uri("https://api.neocortex.link/v3/") };

private async Task<JsonElement> TalkTo(string characterId, string npcName, string text)
{
    var body = new {
        characterIds = new[] { characterId },
        message = text,
        playerId = Game1.player.UniqueMultiplayerID.ToString(),
        sessionId = this.sessionId,
        events = new[] { new { priority = 1, content = $"{Game1.currentSeason} {Game1.dayOfMonth}, hearts: {Game1.player.getFriendHeartLevelForNPC(npcName)}" } }
    };
    using var req = new HttpRequestMessage(HttpMethod.Post, "chat") { Content = JsonContent.Create(body) };
    req.Headers.Add("x-api-key", this.Config.ApiKey);
    using var res = await Http.SendAsync(req);
    var json = await res.Content.ReadFromJsonAsync<JsonElement>();
    this.sessionId = json.GetProperty("sessionId").GetString();
    return json.GetProperty("messages")[0]; // lines, actions, flowState
}

Questo copre /v3/chat. La tua mod mostra le battute come dialogo, riproduce la voce da /v3/audio/generate o /v3/audio/stream, ed esegue le azioni che il personaggio restituisce.

Schermata di gioco di Stardew Valley Schermata: Stardew Valley © ConcernedApe

Giorni di festa

Il Luau, guidato da una Conversation Flow

Il Luau è una scelta naturale. Il sindaco Lewis ti saluta, ti chiede cosa aggiungi alla zuppa del banchetto, e ti accompagna nell'assaggio del Governatore. Una Conversation Flow guida la scena attraverso checkpoint e restituisce parole chiave come INGREDIENT_ADDED, GOVERNOR_TASTED e VERDICT_GOOD. La tua mod reagisce a ciascuna: un aumento d'amicizia per tutto il paese con un buon verdetto, un silenzio imbarazzato e un Lewis di malumore con uno cattivo.

Uno stand di quiz alla Fiera

Aggiungi uno stand di quiz alla Stardew Valley Fair. Un presentatore chiede «Quale di questi ricresce dopo il raccolto: i mirtilli o i meloni?» e «Quanti giorni ci vogliono perché una pastinaca cresca?» Il motore dei quiz (piano Team) gestisce domande, punteggi e una classifica tramite /v3/quiz, e la tua mod paga gettoni stella ai giocatori che conoscono le loro colture.

Coltivare con la voce

Progetta un set di comandi con attori («bracciante», «me»), azioni («annaffia», «raccogli», «accarezza», «pianta», «equipaggia») e oggetti («colture», «mucche», «semi di pastinaca», «annaffiatoio»). «Annaffia le colture e accarezza le mucche» arriva come due comandi; «pianta venti semi di pastinaca» arriva con la quantità allegata. La tua mod li esegue su un NPC di supporto o sugli strumenti del giocatore. La libreria Neocortex Voice Commands fa il riconoscimento sul computer del giocatore, senza un giro nel cloud. Per il lato vocale in modo più approfondito, leggi comandi vocali sul dispositivo per mod di gioco.

Voice Commands è un SDK con licenza: contattaci per una licenza Voice Commands.

Crea una mod AI per abitanti di Stardew Valley, passo dopo passo

  1. Installa SMAPI e configura un progetto mod in C# dalla guida per modder della wiki.
  2. Progetta i tuoi abitanti nella dashboard Neocortex, più un flusso per il Luau e un set di domande sull'agricoltura. Provali nel browser.
  3. Progetta un set di comandi per le attività della fattoria, con alcune frasi di esempio per ogni azione.
  4. Collegati dalla mod. Chiama /v3/chat senza bloccare il game loop, riusa il sessionId, e mappa le azioni sul codice di gioco.
  5. Tieni la chiave API in config.json, compilata dal giocatore, mai scritta nel codice di una mod condivisa.
  6. Testa su un salvataggio single player con push-to-talk prima di ogni altra cosa.

Co-op, Nexus Mods e fair play

Tieni la mod gratuita e non commerciale, e segui le regole del sito su cui la pubblichi, come Nexus Mods o ModDrop. Costruiscila per i salvataggi single player; in co-op, usala solo con amici che hanno la mod e sono d'accordo. Ogni giocatore usa la propria chiave API Neocortex.

Da dove iniziare

Un abitante, una stagione. Scegli il personaggio con cui parli di più, costruiscilo in Neocortex, prova la conversazione nel browser, poi lascia che il Luau e la Fiera vengano dopo. Vedi la nostra pagina di confronto per capire come Neocortex differisce da altre piattaforme di personaggi AI. Stai costruendo per una colonia diversa? Vedi le guide mod di dialogo AI per coloni di RimWorld e mod NPC AI per Minecraft, oppure l'indice completo mod NPC AI e comandi vocali.

Versioni degli strumenti e link verificati a ottobre 2026. Gli strumenti per le mod cambiano spesso; controlla la pagina di ogni progetto per l'ultima release.

Domande frequenti

Si possono aggiungere dialoghi AI agli abitanti di Stardew Valley?

Sì. Le mod SMAPI sono codice C# che può leggere amicizia, regali e calendario, chiamare un'API web e mostrare testo nella casella di dialogo del gioco. Un personaggio Neocortex può poi rispondere come l'abitante, nel suo ruolo, tenendo conto del rapporto.

Le mod AI di Stardew Valley richiedono SMAPI o Content Patcher?

Serve SMAPI, perché solo il codice C# può fare chiamate di rete e reagire alle risposte. Content Patcher serve per i content pack che modificano dati, immagini e mappe, quindi si abbina bene a ritratti o battute scritte a mano, ma la parte AI gira nella tua mod SMAPI.

Gli abitanti AI ricorderanno il mio rapporto con loro?

Sì. La tua mod invia livelli di cuori, regali recenti ed eventi con ogni messaggio, e Neocortex mantiene la sessione di conversazione. L'abitante reagisce a ciò che è accaduto davvero nella tua fattoria.

Posso coltivare con comandi vocali in Stardew Valley?

Una mod può trasformare il parlato in azioni agricole. Neocortex Voice Commands gira sul PC del giocatore, riconosce offline frasi come "annaffia le colture e accarezza le mucche" e passa alla tua mod ciascun comando. È un SDK con licenza, quindi contattaci per una licenza.

Articoli simili

Continua a leggere