GTA 5 AI NPC模组:会说话的路人与语音命令
用Neocortex制作GTA 5 AI NPC模组:会回答你的路人、评判你驾驶的乘客、语音命令,以及剧情模式中的电台问答。
Neocortex TeamThe team behind Neocortex
· 更新于 2026年10月23日 · 阅读约 6 分钟

凌晨3点,你走进一家24小时便利店,身上带着两颗通缉星,手里还拿着一把手枪,店员却对你说出他对每个人都会说的那句话。GTA 5 AI NPC模组正是为了解决这一刻:店员、陌生人和乘客会回答你真正说的话,并对你刚刚做的事作出反应。 Neocortex为你的Script Hook V模组提供带有声音、动作和情绪的AI角色,以及设备端语音命令,因此你可以在剧情模式中构建它,而无需运行自己的语言模型。
截图:Grand Theft Auto V Enhanced © Rockstar Games
GTA 5 AI NPC模组的技术栈一览
GTA 5单人模组以原生插件的形式运行,由Script Hook V加载。它会加载.asi插件,并让插件访问游戏的原生函数。其2026年7月的发布版列出了GTA V Legacy和GTA V Enhanced两个版本的受支持补丁。大多数脚本模组随后会在.NET层上以C#编写:
| 工具 | 提供的功能 | 版本 |
|---|---|---|
| ScriptHookVDotNet 3(SHVDN) | 标准的.NET脚本宿主。当前游戏补丁需要使用每日构建版,而非最新稳定版。 | Legacy |
| ScriptHookVDotNetEnhanced | 扩展版SHVDN,因此为Legacy编写的脚本可以原样在Enhanced上运行 | Legacy和Enhanced |
| LemonUI | 为SHVDN 3脚本提供NativeUI风格的菜单,适用于设置界面或“交谈”提示 | 两者皆可 |
请查看各项目的说明,确认你的脚本针对哪个构建版本。
脚本是放在scripts文件夹中的已编译C#类,其中包含每帧运行一次的Tick处理程序。在此基础上,你可以通过SHVDN的API读取玩家、附近行人、车辆和通缉等级,并可以执行.NET Framework能做的任何操作:使用HttpClient发送网络请求,使用NAudio等音频库播放语音,使用SHVDN的ScriptSettings读取.ini文件。字幕通过GTA.UI.Screen.ShowSubtitle显示在屏幕上,菜单则由LemonUI处理。
从游戏事件到语音回复
本文中的每项功能都运行在同一个循环上。脚本读取游戏状态,将其与玩家的话一起发送给Neocortex角色(/v3/chat),以字幕形式显示回复,通过/v3/audio/generate或/v3/audio/stream播放语音,并执行角色返回的任何动作。网络请求应在游戏线程之外运行,并将结果交回Tick,这样游戏就不会卡顿。
SHVDN脚本中一次最简单的聊天调用:
static readonly HttpClient Http = new HttpClient();
static async Task<string> AskCharacter(string apiKey, string characterId, string sessionId, string line, string gameEvent)
{
var body = JsonConvert.SerializeObject(new {
characterIds = new[] { characterId },
message = line,
playerId = "player-1",
sessionId = sessionId,
events = new[] { new { priority = 1, content = gameEvent } }
});
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,并在下一条消息中发送,角色就能记住这段对话。
在这个循环之上,还有三个部分:
- 对话流程(Conversation Flows) 通过你设计的节拍引导较长的遭遇,并返回你的脚本可以响应的检查点关键词(
flowState)。例如,当陌生人信任玩家后,就把一个路径点交给玩家。 - 问答引擎 通过
/v3/quiz运行题组、计分和排行榜。 - 设备端语音命令 无需经过云端往返,即可将语音短语转换为游戏动作。Neocortex Voice Commands运行在玩家的机器上,你可以在控制台中以参与者、动作和对象的形式设计命令集(例如参与者“dispatcher”、动作“send”、对象“taxi”)。支持按键说话或持续监听,并支持多种语言。
在洛圣都可以做什么
会注意到你的店员。 回到那家24小时便利店:你的脚本会把一个简短的事件列表(“玩家有2颗通缉星”“玩家手持手枪”“附近有警笛声”)连同玩家的话一起发送给店员角色。店员会以角色的身份作答,并附带一个情绪标签,你的模组可以将其转换为动画;他还可以返回一个动作,例如{ "name": "OPEN_REGISTER" }或{ "name": "CALL_POLICE" },由你的脚本执行。同样的模式也适用于韦斯普奇海滩上的街头小贩,或镜子公园里的慢跑者:每种类型的人物对应一个角色,各自拥有自己的性格,并对街区有各自的了解。
对你的驾驶有意见的乘客。 从驾驶过程中实时推送事件:险些相撞、闯红灯、在森纳高速上开到190 km/h、一分钟内第三次撞车。当你吓到他们时,这位同行者会评论、大笑、抱怨,并要求下车;CHANGE_STATION或GET_OUT等动作则让他们能够真正采取行动。在Pro和Team套餐中,群聊功能允许最多六个角色参与同一段对话,因此在你开车时,两位乘客可以为路线争论不休。
语音命令。 玩家只需说话:“帮我叫辆出租车”“呼叫增援”“下一个电台”“关掉收音机,并设置回家的路径点”。你的脚本会接收匹配到的命令并执行,如果一句话中有多个命令,也会逐一执行。
电台问答主持人。 长途驾驶时,可以打造一位原创电台主持人角色,通过问答引擎(Team套餐)主持洛圣都知识问答。玩家大声回答,语音转文字将其转换为文本,API负责计分。
截图:Grand Theft Auto V Enhanced © Rockstar Games
仅限剧情模式
Rockstar的PC单人模组政策称,Take-Two通常不会对尊重第三方知识产权的单人非商业模组采取行动,但不包括在线服务、新剧情、任务和地图。Rockstar较新的模组指南涵盖其所有游戏,并且规定更为严格:
- 不要改动Rockstar的剧情。 不要扩展或修改其故事线、任务或角色。不要为迈克尔、富兰克林或崔佛编写新的对白。
- 不要改动Rockstar的配音。 不要修改或重复使用其配音表演。每个AI角色都应使用根据文字描述设计的原创Neocortex声音,或你拥有权利的声音,绝不能是Rockstar配音演员的克隆。
- 多人游戏只能通过Rockstar的Creator Platform进行,在该平台之外的任何模组都必须严格保持非商业性质。
指南还表明,它们并不构成授权许可,因此它们描述的是Rockstar所容许的范围,而不是授予的权利。因此,请用原创角色构建环境对话、同伴、语音命令和问答,而不是新的剧情任务。GTA Online绝不能进行模组改动:请让模组保持在剧情模式中,保持免费,并让每位玩家使用自己的Neocortex API密钥。
后续步骤
- 为你的版本安装Script Hook V和.NET脚本宿主:Legacy使用SHVDN每日构建版,Enhanced使用ScriptHookVDotNetEnhanced。如果需要菜单,可以添加LemonUI。
- 在Neocortex可视化编辑器中设计角色:性格、对洛圣都的了解、声音,以及它可能返回的动作。在浏览器中测试。
- 如果你的创意需要,添加对话流程、问答或语音命令集。
- 通过
HttpClient从你的脚本连接,以字幕显示回复并播放音频。 - 将API密钥保存在
.ini文件中,由玩家自行填写,这样每位玩家都使用自己的密钥。 - 在分享之前,先在剧情模式中测试。
Voice Commands属于授权SDK:联系我们以获取Voice Commands许可。
同样的方法也适用于我们的其他Rockstar游戏指南:荒野大镖客2、GTA圣安地列斯与罪恶都市和GTA 4;我们的GTA 6模组文章则探讨了它未来可能的发展方向。关于语音部分,请阅读我们的游戏模组设备端语音命令一文,或在我们的对比页面中了解Neocortex的表现。从一家商店的一位店员开始,剩下的对话交给Neocortex处理即可。
工具版本和链接核查于2026年10月。模组工具更新频繁,请查看各项目页面以获取最新版本。
常见问题
你可以为GTA 5添加AI NPC吗?
可以,但仅限剧情模式。Script Hook V的.NET脚本可以读取玩家周围正在发生的事情,通过网络API将其发送给AI角色,并以字幕显示回复。Neocortex负责提供角色、角色的声音以及它返回的动作,因此你的模组只需处理游戏逻辑。
GTA 5 AI模组能在Enhanced版本上运行吗?
Script Hook V支持当前的Legacy和Enhanced补丁,ScriptHookVDotNetEnhanced可以在两个版本上运行.NET脚本。Neocortex模组只需要HTTP、文字和音频,因此同一个脚本可以同时面向Legacy和Enhanced。
我可以用语音命令控制GTA 5吗?
可以。脚本可以将语音短语映射为游戏动作,例如叫出租车或切换电台。Neocortex Voice Commands运行在玩家的电脑上,能够理解自然的表达方式,并即时返回匹配的命令,无需经过云端往返。
AI NPC模组会导致我在GTA 5中被封号吗?
Rockstar的PC模组政策容许非商业的单人模组,但GTA Online属于禁区,对其进行模组改动可能会导致账号被封。Rockstar 2026年的模组指南将多人模组限制在其Creator Platform内,并禁止为其角色编写新对白或重复使用其配音演员的声音。请让任何Neocortex模组保持在剧情模式中,使用原创角色和声音,并且绝不要在GTA Online中加载。
Neocortex对GTA 5模组制作者的费用是多少?
付费套餐起价为每月€9,包括AI角色、对话流程和API。你可以在编写任何模组代码之前,先在浏览器中测试角色。






