RDR2 AI NPC 模组:会说话的陌生人、营地闲聊与语音命令
用 Neocortex 制作 Red Dead Redemption 2 AI NPC 模组:会记住你的酒馆老板、营地对话、团队语音命令和篝火问答。
Neocortex TeamThe team behind Neocortex
· 阅读约 7 分钟

黄昏时分,你满身泥污,头上挂着赏金,骑着一匹已经不太年轻的马进入 Valentine。酒馆老板打量着你,问外面发生了什么。吧台边一个醉汉觉得你看起来很危险,直接说了出来。回到营地,你的两个同伙还在争论抢火车的那单值不值。
在原版游戏中,这些人只会从几句录制好的台词中选一句。Red Dead Redemption 2 AI NPC 模组让他们回应你真正说的话。Neocortex 为你的 ScriptHookRDR2 模组提供带有声音、记忆和动作的 AI 角色,以及在本地运行的语音命令,因此你无需自己运行语言模型,也能在故事模式中实现这一功能。
截图:Red Dead Redemption 2 © Rockstar Games
RDR2 模组技术栈一览
RDR2 于 2019 年 11 月登陆 PC,比主机晚一年,其单人模组生态与 GTA V 基于相同的思路:一个加载插件的原生钩子,以及其上用于脚本的 .NET 层。
| 工具 | 提供的功能 | 何时需要 |
|---|---|---|
| Script Hook RDR2 | 加载 .asi 插件,并开放游戏的原生函数。支持 1491.17 及以上版本,如果你进入 Red Dead Online,它会关闭游戏。 | 始终需要 |
| ScriptHookRDR2 V2 | 社区制作的钩子,API 相同,针对最新补丁构建 | 原版钩子跟不上游戏更新时 |
| ScriptHookRDR2DotNet V2 | .NET 脚本宿主,是原版 ScriptHookRDR2DotNet 的更新分支。需要 .NET Framework 4.8 或更高版本,以及 VC++ 2019 x64 运行库。 | 用于 C# 脚本 |
| Lenny's Mod Loader | 通过虚拟文件系统替换游戏文件 | 仅用于资源模组;脚本模组不需要 |
.asi 文件和 DLL 请使用同一个 ScriptHookRDR2DotNet 发行版本,并预计旧的 C# 脚本需要做少量修改。
脚本是 scripts 文件夹中的一个已编译 C# 类,带有每帧运行一次的 Tick 处理程序。在此基础上,你可以读取玩家、附近的行人、你的马、每个地区的赏金以及当前时间,还可以使用 .NET Framework 提供的任何功能:用 HttpClient 发送网络请求,用 NAudio 等音频库播放语音,并用 .ini 文件保存设置。字幕和提示则通过游戏自带的 UI 原生函数显示在屏幕上。
从游戏事件到语音回复
本文中的每个功能都基于同一个循环。脚本读取游戏状态,将其与玩家的话一起发送给 Neocortex 角色(/v3/chat),将回复显示为字幕,从 /v3/audio/stream 播放语音,并执行角色返回的任何动作。网络请求应在游戏主线程之外进行,并将结果交还给 Tick,这样游戏就不会卡顿。
一个来自 ScriptHookRDR2DotNet 脚本的最简聊天调用:
static readonly HttpClient Http = new HttpClient();
static async Task<string> AskCharacter(string apiKey, string characterId, string sessionId, string line, string[] gameEvents)
{
var body = JsonConvert.SerializeObject(new {
characterIds = new[] { characterId },
message = line,
playerId = "player-1",
sessionId = sessionId,
// e.g. "player has a $50 bounty in New Hanover", "player's horse is injured", "it is raining"
events = gameEvents.Select(e => new { priority = 1, content = e })
});
var req = new HttpRequestMessage(HttpMethod.Post, "https://api.neocortex.link/v3/chat");
req.Headers.Add("x-api-key", apiKey); // read from the mod's .ini, never hard-coded
req.Content = new StringContent(body, Encoding.UTF8, "application/json");
var res = await Http.SendAsync(req);
return await res.Content.ReadAsStringAsync(); // sessionId, messages[].lines, actions
}保存返回的 sessionId,并随下一条消息一起发送,这样你下次骑马进城时,角色还会记得你。
截图:Red Dead Redemption 2 © Rockstar Games
在边疆可以做什么
一个会记住你的酒馆老板。 你的脚本会把玩家的话和几个事件一起发给老板:赏金、身上的泥、你上周在这家酒馆大闹过一场。老板会以角色的口吻回答,带有一种情绪,你的模组可以把它转换为动画;老板还可以返回诸如 { "name": "POUR_WHISKEY" } 或 { "name": "CALL_SHERIFF" } 之类的动作,由你的脚本执行。同样的模式也适用于 Rhodes 的杂货店店员、Lannahechee 河上的摆渡人,或 Saint Denis 的医生:每种原型设计一个原创角色,各自拥有独特的性格和对该地区的了解。
路上遇到的陌生人。 Conversation Flows 可以让较长的遭遇经过你设计的节拍推进,并返回你的脚本可以响应的检查点关键词(flowState)。你在 Grizzlies 附近遇到的一个迷路的淘金者,起初会满怀戒心,如果你分给他水,他会慢慢放松,最后在你的地图上标出他废弃矿区的位置。请把这些内容保持为与原创角色的简短支线遭遇,而不是新的故事任务。
截图:Red Dead Redemption 2 © Rockstar Games
营地闲聊。 这是 RDR2 在 AI 对话方面最出彩的地方,因为游戏中有很多内容都发生在篝火周围。在一次 /v3/chat 调用中发送多个 characterIds,角色就会共享同一段对话。如果把 message 留空,导演会决定接下来几轮由谁发言,然后把场景交还给玩家;当你的脚本需要某个特定角色回答时,设置 speakerCharacterId。两个原创的帮派成员可以争论如何分赃,第三个人让他们两个都闭嘴,而你可以走过去选边站。群聊最多支持六个角色,属于 Pro 和 Team 套餐。
给你的队伍下达语音命令。 有些命令不应等待语言模型处理,例如“队伍,跟我来”“就在这里扎营”“拉住马”“掩护我”。Neocortex Voice Commands 在玩家的 PC 上运行,能理解自然的措辞,并在没有云端往返的情况下返回匹配的命令。你在控制台中以角色、动作和对象的形式设计命令集(角色“posse”,动作“follow”,对象“me”),玩家可以在一句话中叠加多个命令,可以使用按键说话或常开监听,并支持多种语言。你的脚本会把每条命令转换为行人任务。
篝火边的问答主持人。 在营地安静的夜晚,你可以打造一个原创的说书人,通过问答引擎(Team 套餐)主持一场边疆知识竞赛。玩家大声作答,语音转文字将其转换为文本,API 负责计分。
仅限故事模式
Rockstar 的PC 单人模组政策称,Take-Two 通常不会对尊重第三方知识产权的单人、非商业模组采取行动,并将在线服务、新故事、任务和地图排除在外。Rockstar 较新的模组指南适用于其所有游戏,要求更为严格:
- 不要改动 Rockstar 的故事。 不要扩展或修改其故事线、任务或角色。不要为 Arthur、Dutch 或 Sadie 添加新台词。
- 不要改动 Rockstar 的配音。 不要修改或复用其配音表演。请为每个 AI 角色在 Neocortex 中根据文字描述设计原创声音,或使用你拥有权利的声音,绝不要克隆 Rockstar 配音演员的声音。
- 多人游戏通过 Rockstar 的 Creator Platform 进行,对于本作而言即 RedM;任何不在该平台上的模组都必须严格保持非商业用途。
指南还声明,它们并不构成许可证。如果你进入 Red Dead Online,Script Hook RDR2 会关闭游戏,你的模组也绝不应试图绕过这一机制。请将其保持在故事模式中,保持免费发布,并让每位玩家使用自己的 Neocortex API 密钥。
后续步骤
- 从同一个发行版本安装 Script Hook RDR2 和 ScriptHookRDR2DotNet V2,并确认示例脚本可以在故事模式中加载。
- 在 Neocortex 可视化编辑器中设计角色:性格、他们对地图某一角落的了解、声音,以及允许返回的动作。在浏览器中测试。
- 如果你的创意需要,添加 Conversation Flow、群聊场景、问答或语音命令集。
- 通过
HttpClient从脚本连接,用字幕显示回复并播放音频。 - 将 API 密钥保存在
.ini文件中,由玩家自行填写,确保每位玩家都使用自己的密钥。 - 在分享任何内容之前,先在故事模式中测试。
Voice Commands 是一款授权 SDK:联系我们获取 Voice Commands 授权。
同样的方法也适用于 Rockstar 的其他游戏,请参阅我们的 GTA 5 AI NPC 模组指南;我们的 GTA 6 模组文章则探讨了接下来可能出现的情况。你可以在我们的 AI NPC 和语音命令模组指南中浏览所有游戏,或阅读游戏模组的本地语音命令的工作原理。从一个城镇里的一位酒馆老板开始,其余的对话交给 Neocortex 来处理。
工具版本和链接核对于 2026 年 10 月。模组工具更新频繁,请查看各项目页面以获取最新版本。Neocortex 与 Rockstar Games 或 Take-Two Interactive 没有关联。
常见问题
能在 RDR2 中加入 AI NPC 吗?
可以,在 PC 的故事模式中。一个 ScriptHookRDR2 .NET 脚本可以读取玩家周围发生的事情,通过网络 API 将其发送给 AI 角色,并以字幕形式显示回复。角色、它的声音以及它返回的动作由 Neocortex 提供,因此你的模组只需处理游戏逻辑。
Script Hook RDR2 能用于最新补丁吗?
Script Hook RDR2 支持 1491.17 及以上的游戏版本,ScriptHookRDR2 V2 等社区版本则针对最新补丁。Neocortex 模组只需要 HTTP、文字和音频,因此在不同版本的钩子之间都能正常工作。
我能用麦克风和 RDR2 中的 NPC 对话吗?
在原版游戏中不能,那里的 NPC 使用录制好的问候和挑衅台词。模组可以把玩家的语音转换为文字,发送给 Neocortex 角色,并播放配音回复;而“跟我来”之类的简短命令则通过本地语音命令执行。
在 Red Dead Online 中使用 RDR2 模组会被封号吗?
进入 Red Dead Online 时,Script Hook RDR2 会关闭游戏,而 Rockstar 将多人模组限制在 RedM 及其 Creator Platform 内。请将任何 Neocortex 模组保持在故事模式中,使用原创角色,这样它就不会涉及联机游戏。
Neocortex 对 RDR2 模组作者收费多少?
付费套餐每月 €9 起,包含 AI 角色、Conversation Flows 和 API。在编写任何模组代码之前,你就可以在浏览器中测试角色。






