Minecraft AI NPC 模组:会说话的村民与语音指令
用 Neocortex 在 Fabric 或 NeoForge 上制作 Minecraft AI NPC 模组:会说话和交易的村民、课堂测验,以及助手 NPC 的语音指令。
Neocortex TeamThe team behind Neocortex
· 阅读约 6 分钟

快速回答: 可以,仅限 Java 版。在 Fabric 或 NeoForge 上运行的 Minecraft AI NPC 模组,可以把村民看到和听到的内容发送给一个 Neocortex 角色,然后把回复转换为字幕、语音和交易。
多年来,Minecraft 村民只会哼哼、来回走动,并通过固定的菜单进行交易,模组制作者一直在尝试让他们开口说话。 借助 Neocortex,每个村民都能获得性格、对玩家的记忆和一种声音,并根据所听到的内容采取行动。再加上对话流程、测验引擎和设备端语音指令,同一个模组可以用来上一堂课,也可以做一个听从语音命令的助手。
截图:Minecraft © Mojang Studios
Fabric 与 NeoForge
Java 版模组是由模组加载器加载的 Java jar 文件。两种主流加载器都可以用于制作会说话的村民:
两者都紧跟新版本发布。Minecraft 26.1 及更新版本运行在 Java 25 上,并且自 26.1 起,游戏不再进行混淆,因此模组可以直接使用 Mojang 自己的名称。 模组通常发布在 Modrinth 或 CurseForge 上。社区模组已经为 Minecraft 添加了基于聊天的 AI 伙伴;接下来介绍的是一个 Neocortex 模组的样子。
服务端还是客户端?
代码在哪里运行,比选择哪种加载器更重要。
服务端负责村民、物品栏和交易,是调用网络 API 的自然位置。Java 内置的 HttpClient 负责网络调用,游戏本身已经自带用于 JSON 的 Gson。
客户端负责麦克风、字幕(聊天行或 HUD 覆盖层)以及音频播放,对于 WAV 格式的回复,可以使用 Java 自带的音频 API。
因此典型的分工是:服务端通过 /v3/chat 把每段村民对话发送给 Neocortex,并执行返回的动作;客户端则播放来自 /v3/audio/generate 或 /v3/audio/stream 的语音,并监听语音指令。
Java 中的一次聊天调用
下面是一段来自 Fabric 或 NeoForge 模组的最简聊天调用,在主线程之外发送:
JsonObject body = new JsonObject();
JsonArray ids = new JsonArray();
ids.add(config.characterId());
body.add("characterIds", ids);
body.addProperty("message", playerText);
body.addProperty("playerId", player.getStringUUID());
body.addProperty("sessionId", sessionId); // "" on the first call
HttpRequest req = HttpRequest.newBuilder(URI.create("https://api.neocortex.link/v3/chat"))
.header("x-api-key", config.apiKey())
.header("Content-Type", "application/json")
.POST(HttpRequest.BodyPublishers.ofString(body.toString()))
.build();
HTTP.sendAsync(req, HttpResponse.BodyHandlers.ofString()).thenAccept(res -> {
JsonObject reply = JsonParser.parseString(res.body()).getAsJsonObject();
sessionId = reply.get("sessionId").getAsString();
// messages[0].lines -> subtitles; actions -> run them back on the server thread
});这段调用背后的角色是在可视化节点编辑器中构建的,包括性格、情绪、知识、语言和语音节点。在 Pro 和 Team 套餐中,最多可以有六个角色共享同一段对话,足以组成一个村庄议会。 关于它与其他 AI 角色平台的对比,请参阅我们的对比页面。
截图:Minecraft © Mojang Studios
Minecraft AI NPC 模组的三种 NPC
图书管理员和农夫
图书管理员记得你曾经保卫过村庄,因此在那本附魔书上给你更优惠的价格。 农夫抱怨他的麦田被苦力怕炸出了一个坑,并要求你修好之后,才肯把胡萝卜卖给你。
你的模组会随每条消息发送相关事实:村民的职业、玩家的绿宝石数量、声望、附近的方块,以及"击退袭击"之类的近期事件。
角色会以文字、情绪标签和动作作出回应,例如 { "name": "OFFER_TRADE", "targetId": "enchanted_book" }。你的模组会打开带有该报价的交易界面,因此对话与经济系统保持相互关联。
讲台前的老师
在一个班级使用的 Java 服务器上,一个老师 NPC 站在建筑前方,用简单的语言讲解一个主题。把课堂笔记以 PDF 形式上传到角色的 Knowledge 节点,它就会根据这些内容回答。
然后它会出一套测验:红石逻辑门、生物群系与气候,或语言课的词汇,支持 20 多种语言。
测验引擎(Team 套餐)通过 /v3/quiz 处理题目、计分和排行榜,当学生通过测验时,你的模组可以发放奖励方块或打开一扇门。
对话流程同样适用于引导式课程:老师带领学生逐个经过检查点,你的模组则根据每个 flowState 关键词打开下一个房间。
Pip,会听话的助手
给你的模组配置一个名为 Pip 的助手 NPC,并设计一组指令,包括执行者("Pip"、"everyone")、动作("follow"、"wait"、"chop"、"mine"、"bring")和对象("me"、"oak logs"、"iron"、"that tree")。
"Bring me sixteen oak logs" 会作为一条带有数量的指令到达。"Chop that tree and then follow me" 则会作为两条指令到达。 Neocortex 语音指令库在玩家的电脑上匹配短语,无需经过云端往返,因此即使在战斗中,Pip 也会在你停止说话的瞬间作出反应。我们关于游戏模组的设备端语音指令的文章更深入地介绍了语音部分。
第一个村民检查清单
- 选择加载器。 使用官方生成器搭建 Fabric 或 NeoForge 模组项目。
- 在 Neocortex 控制台设计角色。 每种村民职业一个角色,一个带有课堂笔记的老师,一组用于测验的问题。在浏览器中测试它们。
- 为你的助手 NPC 设计指令集。 每个动作附带几个示例短语。
- 从模组连接。 异步调用
/v3/chat,复用sessionId,并将返回的动作映射到游戏代码。 - 把 API 密钥保存在配置文件中。 由玩家或服务器管理员自行填写,切勿硬编码在共享的模组里。
- 先在单人存档中测试。 使用按键说话功能测试通过后,再邀请班级加入。
Voice Commands 是一款授权 SDK:联系我们获取 Voice Commands 授权。
服务器、课堂与公平游戏
让模组保持免费,并遵守 Mojang 的 Minecraft 使用准则和最终用户许可协议。 请在单人存档或私人服务器上使用,且每位玩家都已同意;切勿在违反其规则的公共服务器上使用。对于课堂,在连接任何在线服务之前,请先确认学校关于学生数据的规定。 每位玩家或每个服务器都使用自己的 Neocortex API 密钥。
简要总结
选择一种加载器,把 API 调用放在服务端,并从一种村民职业开始。一旦图书管理员能通过 Neocortex 说话并交易,老师和 Pip 就可以复用同样的组件。
想做一个更温馨的游戏?请参阅我们的 Stardew Valley AI 村民模组指南,或浏览我们的 AI NPC 与语音指令模组索引,查看每一款游戏。
工具版本与链接核对于 2026 年 10 月。模组工具变化频繁;请查看每个项目的页面,以获取最新版本。
常见问题
可以在 Minecraft 中添加 AI NPC 吗?
可以,仅限 Java 版。Fabric 或 NeoForge 模组可以把村民看到和听到的内容发送给 AI 服务,并在游戏中显示回复。Neocortex 角色会以角色身份回答,并返回动作,例如打开一场交易,由你的模组执行。
Minecraft 村民可以用 AI 对话吗?
模组可以为每种村民职业分配一个独立的 Neocortex 角色,因此图书管理员、农夫和牧师的说话方式各不相同。模组会随每条消息发送玩家的绿宝石、声望和附近的方块,村民则通过动作作出回答并提供交易。
老师可以在 Minecraft 课堂中使用 AI NPC 吗?
在 Java 版服务器上可以。使用 Neocortex 构建的老师 NPC 可以根据上传的课堂笔记讲解主题,并运行带有排行榜的计分测验。Minecraft Education 是一个独立的版本,因此 Fabric 和 NeoForge 模组不适用于该版本。
我可以用声音控制 Minecraft 中的 NPC 吗?
可以。Neocortex Voice Commands 在玩家的电脑上运行,可离线匹配"bring me sixteen oak logs"之类的自然短语,并将指令和数量交给你的客户端模组。Voice Commands 是一款授权 SDK,请联系我们获取授权。






