Mod de villageois IA pour Stardew Valley : dialogue et voix
Créez un mod de villageois IA pour Stardew Valley avec SMAPI et Neocortex : des villageois qui se souviennent de vous, des étapes d'histoire pour les fêtes, des quiz agricoles et des commandes vocales.
Neocortex TeamThe team behind Neocortex
· 6 min de lecture

Entrez au saloon et demandez à Abigail comment s'est passée sa semaine. À deux cœurs, elle est polie et brève ; à huit, elle évoque la grotte que vous avez explorée ensemble et vous taquine à propos de l'améthyste que vous lui avez offerte trois jours de suite. Voilà ce que peut faire un mod de villageois IA pour Stardew Valley.
Les dialogues écrits à la main du jeu sont appréciés, et les joueurs en viennent pourtant à en manquer dès la deuxième année. Une conversation libre fait parler ces personnages, et se souvient de vos cœurs, de vos cadeaux et du jour où vous avez oublié un anniversaire. Neocortex fournit à votre mod SMAPI les personnages IA, des Conversation Flows pour les scènes de fête, un moteur de quiz et des commandes vocales embarquées.
Capture d'écran : Stardew Valley © ConcernedApe
Cœurs, cadeaux et mémoire
La réponse d'Abigail dépend des faits que votre mod envoie avec chaque message : niveau de cœurs, cadeaux de la semaine, saison et jour, météo, et événements récents comme « le joueur a gagné la Fête de l'œuf ».
Le personnage garde la session, si bien que la conversation reprend là où elle s'était arrêtée. Chaque réponse revient avec du texte, une balise d'émotion pour le portrait, et parfois une action que votre mod exécute, comme { "name": "GIVE_ITEM", "targetId": "coffee" }.
Rien de cela ne remplace les dialogues écrits à la main. Ceux-ci restent ; la conversation libre comble les vides entre eux.
Les personnages se construisent dans un éditeur de nœuds visuel avec des nœuds de personnalité, d'émotion, de connaissances et de voix, si bien que vous pouvez donner à Linus un fichier texte sur sa tente et son passé. Jusqu'à six personnages peuvent partager une conversation avec les formules Pro et Team, ce qui convient à une soirée au saloon avec Pam, Gus et Emily.
Un mod SMAPI peut-il appeler une API Web ?
Oui. Presque tous les mods de Stardew Valley reposent sur SMAPI (GitHub), l'API de modding de Stardew. La version actuelle est la branche 4.5, pour Stardew Valley 1.6.14 ou ultérieur. La version 1.7 du jeu a été annoncée sans date de sortie.
Les mods SMAPI sont des projets C# sur .NET 6 avec un manifest.json. Votre classe d'entrée s'abonne aux événements du jeu (début de journée, changement de menu, bouton pressé, rendu) et lit directement l'état du jeu.
Comme il s'agit de .NET classique, un mod peut appeler une API Web avec HttpClient, afficher les réponses dans la boîte de dialogue du jeu ou dans un menu personnalisé, et jouer un clip WAV renvoyé via l'audio MonoGame du jeu. SMAPI lit aussi un config.json pour chaque mod, et c'est là que doit se trouver la clé d'API du joueur.
Et Content Patcher (GitHub) ? Il charge des packs de contenu qui modifient les données, les images et les cartes du jeu sans toucher aux fichiers du jeu. Utilisez-le pour de nouveaux portraits, un stand de fête ou des répliques de secours écrites à la main, et gardez la logique IA dans votre mod SMAPI. Les pages de modding du wiki de Stardew Valley couvrent les deux en détail.
Une méthode TalkTo pour votre mod
Voici un appel de chat minimal depuis un mod SMAPI. Il envoie la saison, le jour et le niveau de cœurs sous forme d'événement, et renvoie le premier message avec ses répliques, ses actions et son 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
}Cela couvre /v3/chat. Votre mod affiche les répliques comme dialogue, joue la voix depuis /v3/audio/generate ou /v3/audio/stream, et exécute les actions renvoyées par le personnage.
Capture d'écran : Stardew Valley © ConcernedApe
Jours de fête
Le Luau, guidé par un Conversation Flow
Le Luau s'y prête naturellement. Le maire Lewis vous accueille, vous demande ce que vous ajoutez à la soupe du repas partagé, et vous fait passer la dégustation du gouverneur.
Un Conversation Flow guide la scène de point de contrôle en point de contrôle et renvoie des mots-clés comme INGREDIENT_ADDED, GOVERNOR_TASTED et VERDICT_GOOD.
Votre mod réagit à chacun : un gain d'amitié pour toute la ville si le verdict est bon, un silence gêné et un Lewis grincheux s'il ne l'est pas.
Un stand de quiz à la Foire
Ajoutez un stand de quiz à la Foire de Stardew Valley. Un animateur demande « Parmi ceux-ci, lequel repousse après la récolte : les myrtilles ou les melons ? » et « Combien de jours une panais met-elle à pousser ? »
Le moteur de quiz (formule Team) gère les questions, le score et un classement via /v3/quiz, et votre mod verse des jetons étoile aux joueurs qui connaissent leurs cultures.
Cultiver à la voix
Concevez un jeu de commandes avec des acteurs (« ouvrier agricole », « moi »), des actions (« arrose », « récolte », « caresse », « plante », « équipe ») et des objets (« cultures », « vaches », « graines de panais », « arrosoir »). « Arrose les cultures et caresse les vaches » arrive sous forme de deux commandes ; « plante vingt graines de panais » arrive avec la quantité. Votre mod les exécute sur un PNJ auxiliaire ou avec les outils du joueur. La bibliothèque Neocortex Voice Commands fait la reconnaissance sur la machine du joueur, sans aller-retour dans le cloud. Pour la partie voix en détail, lisez les commandes vocales embarquées pour mods de jeux.
Voice Commands est un SDK sous licence : contactez-nous pour une licence Voice Commands.
Créer un mod de villageois IA pour Stardew Valley, étape par étape
- Installez SMAPI et créez un projet de mod C# à partir du guide du modder du wiki.
- Concevez vos villageois dans le tableau de bord Neocortex, ainsi qu'un flow de Luau et une série de questions agricoles. Testez-les dans le navigateur.
- Concevez un jeu de commandes pour les tâches de la ferme, avec quelques exemples de phrases par action.
- Connectez-vous depuis le mod. Appelez
/v3/chatsans bloquer la boucle du jeu, réutilisez lesessionId, et reliez les actions au code du jeu. - Gardez la clé d'API dans
config.json, renseignée par le joueur, jamais écrite en dur dans un mod partagé. - Testez sur une sauvegarde solo avec le push-to-talk avant tout le reste.
Coop, Nexus Mods et fair-play
Gardez le mod gratuit et non commercial, et respectez les règles du site où vous le publiez, comme Nexus Mods ou ModDrop. Concevez-le pour les sauvegardes solo ; en coop, utilisez-le seulement avec des amis qui ont le mod et l'acceptent. Chaque joueur utilise sa propre clé d'API Neocortex.
Par où commencer
Un villageois, une saison. Choisissez le personnage à qui vous parlez le plus, construisez-le dans Neocortex, testez la conversation dans le navigateur, puis laissez le Luau et la Foire pour plus tard. Consultez notre page de comparaison pour voir en quoi Neocortex diffère des autres plateformes de personnages IA. Vous construisez pour une autre colonie ? Voyez nos guides sur le mod de dialogue de colons IA pour RimWorld et le mod de NPC IA pour Minecraft, ou l'index complet des mods de NPC IA et de commandes vocales.
Versions des outils et liens vérifiés en octobre 2026. Les outils de modding changent souvent ; consultez la page de chaque projet pour la dernière version.
Questions fréquentes
Peut-on ajouter un dialogue IA aux villageois de Stardew Valley ?
Oui. Les mods SMAPI sont du code C# qui peut lire l'amitié, les cadeaux et le calendrier, appeler une API Web et afficher du texte dans la boîte de dialogue du jeu. Un personnage Neocortex peut alors répondre en tant que villageois, dans son rôle, en tenant compte de la relation.
Les mods IA de Stardew Valley ont-ils besoin de SMAPI ou de Content Patcher ?
Il faut SMAPI, car seul du code C# peut faire des appels réseau et réagir aux réponses. Content Patcher sert aux packs de contenu qui modifient les données, les images et les cartes ; il se combine bien avec des portraits ou des répliques écrites à la main, mais la partie IA tourne dans votre mod SMAPI.
Les villageois IA se souviendront-ils de ma relation avec eux ?
Oui. Votre mod envoie les niveaux de cœurs, les cadeaux récents et les événements avec chaque message, et Neocortex garde la session de conversation. Le villageois réagit à ce qui s'est vraiment passé sur votre ferme.
Peut-on cultiver à la voix dans Stardew Valley ?
Un mod peut transformer la parole en actions agricoles. Neocortex Voice Commands fonctionne sur le PC du joueur, reconnaît hors ligne des phrases comme « arrose les cultures et caresse les vaches », et transmet chaque commande à votre mod. C'est un SDK sous licence : contactez-nous pour obtenir une licence.






