Neocortex Logo

Stardew Valley AI村民模组:开放对话与语音命令

用SMAPI和Neocortex制作Stardew Valley AI村民模组:会记住你的村民、节日剧情节点、农业问答和语音命令。

Neocortex TeamThe team behind Neocortex

· 阅读约 6 分钟

用SMAPI和Neocortex制作Stardew Valley AI村民模组:会记住你的村民、节日剧情节点、农业问答和语音命令。

走进酒馆,问阿比盖尔这一周过得怎么样。当你们的好感度只有两颗心时,她礼貌而简短;到八颗心时,她会提起你们一起探索过的洞穴,还会调侃你连续三天送给她的紫水晶。这就是Stardew Valley AI村民模组能做到的事情。

游戏里手写的对话深受喜爱,但玩家到了第二年就会把它们听腻。开放式对话能让这些角色持续说话,并记住你的好感度、你送过的礼物,以及你忘记生日的那一次。 Neocortex为你的SMAPI模组提供AI角色、用于节日场景的对话流程、问答引擎以及设备端语音命令。

Stardew Valley游戏内截图 截图:Stardew Valley © ConcernedApe

好感、礼物与记忆

阿比盖尔的回答取决于你的模组随每条消息发送的信息:好感等级、本周收到的礼物、季节和日期、天气,以及"玩家赢得了彩蛋节"这类近期事件。 角色会保留会话,因此对话能从上次停下的地方继续。每条回复都会返回文字、用于头像的情绪标签,有时还会返回一个动作,由你的模组执行,例如{ "name": "GIVE_ITEM", "targetId": "coffee" }。

这些都不能取代手写对话。手写对话依然保留,开放式对话只是填补它们之间的空白。

角色在可视化节点编辑器中构建,包含个性、情绪、知识和声音节点,因此你可以给Linus提供一份关于他的帐篷和过去的文本文件。在Pro和Team方案中,最多六个角色可以共享一段对话,适合与Pam、Gus和Emily一起在酒馆度过的夜晚。

SMAPI模组能调用Web API吗?

可以。几乎所有Stardew Valley模组都运行在**SMAPI**(GitHub)上,也就是Stardew Modding API。当前版本为4.5系列,适用于Stardew Valley 1.6.14或更高版本。游戏1.7版本已经宣布,但尚未确定发布日期。

SMAPI模组是基于.NET 6的C#项目,并带有一个manifest.json。你的入口类会订阅游戏事件(新的一天开始、菜单切换、按键按下、渲染),并直接读取游戏状态。 由于它就是普通的.NET,模组可以使用HttpClient调用Web API,在游戏自己的对话框或自定义菜单中显示回复,并通过游戏的MonoGame音频播放返回的WAV片段。SMAPI还会为每个模组读取一个config.json,玩家的API密钥应当放在这里。

那么**Content Patcher**(GitHub)又是什么呢?它加载的内容包可以在不修改游戏文件的前提下,编辑游戏数据、图像和地图。可以用它来添加新的头像、节日摊位或手写的备用台词,并把AI逻辑保留在你的SMAPI模组中。 Stardew Valley Wiki的模组页面对两者都有详细介绍。

模组的TalkTo方法

下面是SMAPI模组中一个最简的聊天调用示例。它把季节、日期和好感等级作为事件发送,并返回第一条消息,包括台词、行为和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
}

以上是/v3/chat的调用。你的模组把台词显示为对话,从/v3/audio/generate或/v3/audio/stream播放语音,并执行角色返回的行为。

Stardew Valley游戏内截图 截图:Stardew Valley © ConcernedApe

节日

由对话流程引导的Luau

Luau非常适合这种设计。市长Lewis会向你问好,问你要往大锅汤里加什么,并带你完成州长的品尝环节。 对话流程会通过检查点引导场景,并返回INGREDIENT_ADDED、GOVERNOR_TASTED和VERDICT_GOOD等关键词。 你的模组会对每个关键词作出反应:评价好时,全镇的友好度提升;评价差时,则出现尴尬的沉默和一个脾气暴躁的Lewis。

集市上的问答摊位

在Stardew Valley Fair上增加一个问答摊位。主持人会问"以下哪种作物收获后会再生:蓝莓还是甜瓜?"以及"防风草需要生长多少天?" 问答引擎(Team方案)通过/v3/quiz负责出题、计分和排行榜,你的模组则向熟悉作物的玩家发放星星代币奖励。

用语音种田

设计一套命令集,包括角色("农场帮手"、"我")、动作("浇水"、"收获"、"抚摸"、"种植"、"装备")和对象("作物"、"奶牛"、"防风草种子"、"洒水壶")。 "浇灌作物并抚摸奶牛"会作为两条命令到达;"种下二十颗防风草种子"则会带上数量信息。你的模组可以让一个辅助NPC执行这些命令,也可以让玩家自己的工具来执行。 Neocortex语音命令库在玩家的电脑上完成匹配,无需经过云端往返。如果想更深入地了解语音部分,请阅读游戏模组的设备端语音命令。

语音命令是一款授权SDK:联系我们获取语音命令许可。

按顺序制作Stardew Valley AI村民模组

  1. 安装SMAPI,并按照Wiki上的模组制作指南设置C#模组项目。
  2. 在Neocortex控制台中设计你的村民,并添加Luau对话流程和农业问答题集。在浏览器中测试它们。
  3. 为农场任务设计命令集,每个动作附上几个示例短语。
  4. 从模组中连接。 调用/v3/chat时不要阻塞游戏主循环,复用sessionId,并将行为映射到游戏代码。
  5. 把API密钥保存在config.json中,由玩家自行填写,切勿硬编码在共享模组里。
  6. 先在单人存档中使用按键说话进行测试,然后再做其他事情。

合作模式、Nexus Mods与公平游戏

请保持模组免费且非商业化,并遵守你发布模组的网站规则,例如Nexus Mods或ModDrop。 为单人存档而制作;在合作模式中,只与安装了该模组并同意使用的朋友一起使用。每位玩家都使用自己的Neocortex API密钥。

从哪里开始

先做一位村民、一个季节。挑选你最常对话的角色,在Neocortex中构建,在浏览器中测试对话,然后再慢慢加入Luau和集市。想了解Neocortex与其他AI角色平台有何不同,请参阅我们的对比页面。如果你要为其他殖民地制作模组,请参阅我们的RimWorld AI殖民者对话模组和Minecraft AI NPC模组指南,或者查看完整的AI NPC与语音命令模组索引。

工具版本和链接检查于2026年10月。模组工具更新频繁,请查看各项目页面以获取最新版本。

常见问题

能为Stardew Valley村民添加AI对话吗?

可以。SMAPI模组是C#代码,可以读取好感度、礼物和日历,调用Web API,并在游戏的对话框中显示文字。Neocortex角色随后可以以村民的身份、按角色设定并考虑与你的关系来回复。

Stardew Valley的AI模组需要SMAPI还是Content Patcher?

需要SMAPI,因为只有C#代码能够发起网络请求并对回复作出反应。Content Patcher用于编辑数据、图像和地图的内容包,适合用来制作头像或手写台词,但AI部分运行在你的SMAPI模组中。

AI村民会记住我与他们的关系吗?

可以。你的模组会随每条消息发送好感等级、近期礼物和事件,而Neocortex会保留对话会话。村民会对你农场里真正发生过的事情作出反应。

我能在Stardew Valley中用语音种田吗?

模组可以把语音转换为农场动作。Neocortex语音命令在玩家的电脑上运行,能离线匹配"浇灌作物并抚摸奶牛"这类短语,并把每条命令交给你的模组。它是一款授权SDK,请联系我们获取许可。

相关文章

继续阅读