Nova Quantum

模组

· 作者 NovaAI

适用于 Fabric 1.21.11 的辅助模组,为你的世界添加一个语音控制的 AI 角色。语音功能需要你自己提供 OpenAI API 密钥。

0 本站下载 0 关注 更新于 4 个月前

需要前置:Fabric API

最新 0.8.176 · 1.21.11 · Fabric

一键开服(送7天)

Nova Quantum

由 Seidr Labs 开发 —— 一款 Fabric 模组,为你的 Minecraft 世界增添一位语音控制的 AI 同伴。

Quantum 是一款适用于 Minecraft 1.21.11 的 Fabric 模组。她以真实实体的形式加入你的世界,聆听语音指令,并在你身边游玩——挖矿、制作、建造和防御——同时遵循与你相同的原版规则。

Quantum 是原始 Nova AI Minecraft Friend 模组的进行中的继任者(约 30k 行代码,已于 2026-05-11 归档)。这是从该项目经验中进行的彻底重建——更小的表面面积、严格的模块化架构、完全符合原版规则,并旨在适应 Minecraft 的版本更新。

必需:你自己的 OpenAI API 密钥

Quantum 的语音和 AI 功能使用 你提供的密钥 调用 OpenAI 的 API。没有密钥时模组仍可启动和加载,但在你提供密钥之前,同伴将保持沉默且无法理解语音指令。

首次启动时,模组会在 config/quantum/secrets.json 中创建一个包含占位符的文件。请将 REPLACE_WITH_YOUR_KEY 替换为来自 的密钥。

你直接向 OpenAI 支付使用费用。不存在 Seidr Labs 的中转服务器、代理或共享密钥。成本取决于你的对话量——典型的语音密集型玩法每次会话仅需几美分。

网络与隐私

当使用 AI 功能时,模组仅与一个外部服务通信:

端点 用途 触发条件
https://api.openai.com/v1/audio/transcriptions 语音转文本 (Whisper) 当你按下通话键时
https://api.openai.com/v1/chat/completions 意图分类 + 回复文本 转录完成后
https://api.openai.com/v1/audio/speech 文本转语音 当 Quantum 大声回复时
https://api.openai.com/v1/embeddings 语义记忆 可选,仅在启用记忆功能时

这就是完整的外出网络范围。

  • 无 Seidr Labs 遥测数据。 不会向 seidrlabs.online 或任何 Seidr 控制的服务器发送任何内容。模组不会“回家”报告。
  • 无第三方分析工具。 无 Sentry、无 Google Analytics、无崩溃报告器。
  • 你的音频和提示词会发送至 OpenAI。 这是使用其 API 的固有特性。你在向他们付费,并向他们发送数据——这与你直接使用 ChatGPT 的情况相同。
  • 对话记忆保存在本地。 最近几次对话轮次存储在你的 Minecraft 存档文件夹中,而非云端。
  • API 密钥绝不会离开你的机器,除了在上述调用的 Authorization: Bearer ... 头信息内部。

功能

语音控制

默认情况下,按键通话捕获绑定到一个可配置的按键。录制的音频(≥500 毫秒)由 OpenAI Whisper 转录,转录结果通过一组快速模组内意图规则路由,任何未在本地处理的内容都会发送给聊天补全模型以进行自然语言理解。置信度阈值防止她执行模糊指令。目前可用的示例包括:

  • "find me ten diamonds" → 她前往地下,沿楼梯模式安全下降,并开始挖矿
  • "follow me through this cave" → 她使用原版导航路径跟随在你身后
  • "defend me" → 切换至剑/弓装备配置,并攻击你附近的敌对生物
  • "open inventory" / "hold this" → 打开她的菜单,以便你给她工具、食物或方块

挖矿与资源收集

用于安全垂直移动的楼梯下降路径规划。识别经过策划的原版方块和生物目录(从 JSON 加载;无硬编码逻辑)。挖掘隧道,绕过障碍物,并在请求满足或背包满时停止。

战斗

  • 自动切换为她携带的最佳武器进行交战(近战 → 剑,远程 → 弓)
  • 盾牌格挡具有真实的耐久度消耗
  • 苦力怕风筝行为:当苦力怕开始融合时后退
  • 优先攻击最近的可信威胁,若出现更近的威胁则切换目标
  • 无自瞄,无穿墙打击,无其他违反原版规则的行为

安全链

一系列“安全链”行为库,当发生危险情况时会中断她当前的任务:

  • FoodChain (已附带) — 饥饿时从背包中进食
  • FallSafetyChain (v0.8.112 版本附带) — 如果她从超过三格的高度落下且手中有水桶,则在撞击点下方放置水桶。行为类似于玩家的极限跳下(MLG)。
  • LowHpFleeChain (开发中) — 当生命值低于阈值时脱离战斗并恢复生命
  • MobDefenseChain (开发中) — 在非战斗任务期间主动应对附近的威胁
  • EmergencyUnstuckChain (开发中) — 当路径规划在地形上卡住时的恢复行为

每个安全链都存在于共享代码中,并使用平台侧辅助程序,因此相同的行为可以干净地移植到未来的 Minecraft 版本中。

对话记忆

Quantum 跨会话记住最近几轮对话。状态在你登出时持久保存,并在重新登录时恢复。存储在你的本地存档文件夹中,永不上传。

避免刷新的背包

当她消失(你登出、她死亡、区块卸载)时,她的背包会被保留并在重生时恢复。物品不会丢失。

音频

文本转语音回复由 OpenAI 的 /v1/audio/speech 端点生成,然后通过 Minecraft 现有的 OpenAL 上下文播放——因此她的声音通过你的游戏所使用的同一音频设备播放。

游戏内菜单

专用的 G 键菜单打开后显示 Quantum 的状态、背包和行为设置,无需离开当前世界。

安装

  1. 为 Minecraft 1.21.11 安装 Fabric Loader 0.18.1+
  2. 安装 Fabric API
  3. 将 quantum-X.X.X.jar 放入 .minecraft/mods/ 文件夹
  4. 启动一次 Minecraft 以生成 config/quantum/secrets.json
  5. 编辑该文件,将 REPLACE_WITH_YOUR_KEY 替换为你的 OpenAI API 密钥
  6. 再次启动 — Quantum 现已启用语音功能

模组在有无 API 密钥的情况下均可加载。若无密钥,你仍会看到实体和 G-menu,但语音/AI 功能将处于非活动状态。

要求

  • Minecraft 1.21.11 (Fabric)
  • Fabric Loader 0.18.1 或更高版本
  • Fabric API
  • Java 21+
  • 客户端和服务端均需安装(多人游戏时两侧都需要此模组)
  • 用于语音 / AI 功能的 OpenAI API 密钥

项目状态

Quantum 正处于 活跃预发布开发阶段(当前构建 v0.8.x)。主要系统——语音路由、导航、采矿、战斗、食物、坠落安全、重生恢复、对话记忆、音频、G-menu——已在持续游戏会话中工作并经过测试。剩余的安全链(LowHpFlee, MobDefense, EmergencyUnstuck)正从原始 Nova 代码库移植,并将陆续在 v0.8.x → v0.9.x 系列中上线。

它今天即可游玩且运行正常,但随着移植工作的完成,请预期会有版本号更新的节奏以及偶尔的行为变更。

关于 Seidr Labs

Seidr Labs 是一家小型工作室,专注于交付由单一开发者维护的专注型 Minecraft 工具。无需 Seidr 侧的服务。无遥测数据。合理的默认设置。公开发布前经过生产环境测试。

姐妹项目:NovaSync —— 面向 Paper 1.21+ 的服务端管理与网络骨干。

链接

  • 项目主页:
  • 工作室:
  • 社区 / Discord:
  • Patreon:
  • YouTube(开发日志 / 演示):@Nova_Ai_MC_Mods

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源