Neocortex Logo

Mod de aldeões com IA para Stardew Valley: diálogo e voz

Crie um mod de aldeões com IA para Stardew Valley com SMAPI e Neocortex: aldeões que lembram de você, marcos de história em festivais, quizzes de agricultura e comandos de voz.

Neocortex TeamThe team behind Neocortex

· 6 min de leitura

Crie um mod de aldeões com IA para Stardew Valley com SMAPI e Neocortex: aldeões que lembram de você, marcos de história em festivais, quizzes de agricultura e comandos de voz.

Entre no saloon e pergunte para a Abigail como foi a semana dela. Com dois corações, ela é educada e curta; com oito, ela lembra da caverna que vocês exploraram juntos e brinca com a ametista que você deu a ela três dias seguidos. É isso que um mod de aldeões com IA para Stardew Valley pode fazer.

Os diálogos escritos à mão do jogo são muito queridos, e os jogadores ainda assim ficam sem assunto no segundo ano. A conversa aberta mantém esses personagens falando e lembra dos seus corações, dos seus presentes e da vez em que você esqueceu um aniversário. A Neocortex dá ao seu mod SMAPI os personagens de IA, Conversation Flows para cenas de festival, um mecanismo de quiz e comandos de voz no dispositivo.

Captura de tela do jogo Stardew Valley Captura de tela: Stardew Valley © ConcernedApe

Corações, presentes e memória

A resposta da Abigail depende de fatos que o seu mod envia em cada mensagem: nível de coração, presentes da semana, estação e dia, o clima e eventos recentes como "o jogador venceu o Festival do Ovo". O personagem mantém a sessão, então a conversa continua de onde parou. Cada resposta volta com texto, uma tag de emoção para o retrato e, às vezes, uma ação que o seu mod executa, como { "name": "GIVE_ITEM", "targetId": "coffee" }.

Nada disso substitui os diálogos escritos à mão. Eles continuam; a conversa aberta preenche as lacunas entre eles.

Os personagens são criados em um editor visual de nós com nós de personalidade, emoção, conhecimento e voz, então você pode dar ao Linus um arquivo de texto sobre a barraca dele e o passado. Até seis personagens podem compartilhar uma conversa nos planos Pro e Team, o que combina com uma noite no saloon com Pam, Gus e Emily.

Um mod SMAPI pode chamar uma API web?

Sim. Quase todo mod de Stardew Valley roda sobre o SMAPI (GitHub), a Stardew Modding API. A versão atual é a linha 4.5, para o Stardew Valley 1.6.14 ou posterior. A versão 1.7 do jogo foi anunciada sem data de lançamento.

Os mods SMAPI são projetos C# em .NET 6 com um manifest.json. A sua classe de entrada assina eventos do jogo (dia iniciado, menu alterado, botão pressionado, renderizado) e lê o estado do jogo diretamente. Por ser .NET comum, um mod pode chamar uma API web com HttpClient, mostrar as respostas na caixa de diálogo do próprio jogo ou em um menu personalizado, e tocar um clipe WAV devolvido pelo MonoGame do jogo. O SMAPI também lê um config.json para cada mod, e é ali que fica a chave de API do jogador.

E o Content Patcher (GitHub)? Ele carrega pacotes de conteúdo que editam dados, imagens e mapas do jogo sem alterar os arquivos do jogo. Use-o para novos retratos, um estande de festival ou falas escritas à mão de reserva, e mantenha a lógica de IA no seu mod SMAPI. As páginas de modding da Wiki de Stardew Valley cobrem os dois em detalhes.

Um método TalkTo para o seu mod

Aqui está uma chamada de chat mínima a partir de um mod SMAPI. Ela envia a estação, o dia e o nível de coração como um evento, e devolve a primeira mensagem com as falas, ações e o 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
}

Isso cobre o /v3/chat. O seu mod mostra as falas como diálogo, toca a voz a partir de /v3/audio/generate ou /v3/audio/stream, e executa as ações que o personagem devolve.

Captura de tela do jogo Stardew Valley Captura de tela: Stardew Valley © ConcernedApe

Dias de festival

O Luau, guiado por um Conversation Flow

O Luau é um encaixe natural. O prefeito Lewis cumprimenta você, pergunta o que você está acrescentando à sopa do banquete e conduz você pela degustação do Governador. Um Conversation Flow conduz a cena por checkpoints e devolve palavras-chave como INGREDIENT_ADDED, GOVERNOR_TASTED e VERDICT_GOOD. Seu mod reage a cada uma: um aumento de amizade para toda a cidade em um bom veredito, um silêncio constrangedor e um Lewis mal-humorado em um veredito ruim.

Um estande de perguntas na Feira

Adicione um estande de perguntas na Feira de Stardew Valley. Um apresentador pergunta "Qual destes volta a crescer depois da colheita: mirtilos ou melões?" e "Quantos dias uma pastinaca leva para crescer?" O mecanismo de quiz (plano Team) executa as perguntas, a pontuação e um placar pelo /v3/quiz, e o seu mod paga fichas de estrela aos jogadores que conhecem suas plantações.

Agricultura por voz

Crie um conjunto de comandos com atores ("trabalhador", "eu"), ações ("regar", "colher", "acariciar", "plantar", "equipar") e objetos ("plantações", "vacas", "sementes de pastinaca", "regador"). "Regue as plantações e acaricie as vacas" chega como dois comandos; "plante vinte sementes de pastinaca" chega com a quantidade junto. O seu mod os executa com um NPC auxiliar ou com as ferramentas do próprio jogador. A biblioteca Voice Commands da Neocortex faz a correspondência no computador do jogador, sem passar pela nuvem. Para o lado da voz com mais profundidade, leia comandos de voz no dispositivo para mods de jogo.

O Voice Commands é um SDK licenciado: fale conosco para obter uma licença do Voice Commands.

Crie um mod de aldeões com IA para Stardew Valley, em ordem

  1. Instale o SMAPI e configure um projeto de mod em C# seguindo o guia do modder na wiki.
  2. Crie os seus aldeões no painel da Neocortex, além de um fluxo do Luau e um conjunto de perguntas sobre agricultura. Teste-os no navegador.
  3. Crie um conjunto de comandos para as tarefas da fazenda, com algumas frases de exemplo por ação.
  4. Conecte a partir do mod. Chame o /v3/chat sem bloquear o loop do jogo, reutilize o sessionId e mapeie as ações para o código do jogo.
  5. Guarde a chave de API em config.json, preenchida pelo jogador, nunca fixa em um mod compartilhado.
  6. Teste em um save single-player com push-to-talk antes de qualquer outra coisa.

Cooperativo, Nexus Mods e jogo justo

Mantenha o mod gratuito e não comercial, e siga as regras do site em que você publicar, como o Nexus Mods ou o ModDrop. Crie para saves single-player; em cooperativo, use apenas com amigos que tenham o mod e concordem com ele. Cada jogador usa a própria chave de API da Neocortex.

Por onde começar

Um aldeão, uma estação. Escolha o personagem com quem você mais conversa, crie-o na Neocortex, teste a conversa no navegador, e deixe o Luau e a Feira para depois. Veja nossa página de comparação para entender como a Neocortex se diferencia de outras plataformas de personagens com IA. Criando para outra colônia? Veja nossos guias sobre o mod de diálogo de colonos com IA para RimWorld e o mod de NPC com IA para Minecraft, ou o índice completo de mods de NPC com IA e comandos de voz.

Versões das ferramentas e links verificados em outubro de 2026. As ferramentas de modding mudam com frequência; confira a página de cada projeto para a versão mais recente.

Perguntas frequentes

Dá para adicionar diálogo com IA aos aldeões de Stardew Valley?

Sim. Os mods SMAPI são código C# que pode ler amizade, presentes e o calendário, chamar uma API web e mostrar texto na caixa de diálogo do jogo. Um personagem da Neocortex pode então responder como o aldeão, no personagem, levando em conta o relacionamento.

Mods de IA para Stardew Valley precisam de SMAPI ou Content Patcher?

Você precisa do SMAPI, porque só código C# pode fazer chamadas de rede e reagir às respostas. O Content Patcher serve para pacotes de conteúdo que editam dados, imagens e mapas, então combina bem com retratos ou falas escritas à mão, mas o lado da IA roda no seu mod SMAPI.

Os aldeões com IA vão lembrar do meu relacionamento com eles?

Podem. O seu mod envia os níveis de coração, os presentes recentes e os eventos a cada mensagem, e a Neocortex mantém a sessão da conversa. O aldeão reage ao que de fato aconteceu na sua fazenda.

Posso cuidar da fazenda com comandos de voz em Stardew Valley?

Um mod pode transformar fala em ações da fazenda. Os Voice Commands da Neocortex rodam no PC do jogador, reconhecem frases como "regue as plantações e acaricie as vacas" offline, e entregam cada comando ao seu mod. É um SDK licenciado, então fale conosco para obter uma licença.

Artigos semelhantes

Continue lendo