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 的状态、背包和行为设置,无需离开当前世界。
安装
- 为 Minecraft 1.21.11 安装 Fabric Loader 0.18.1+
- 安装 Fabric API
- 将
quantum-X.X.X.jar 放入 .minecraft/mods/ 文件夹
- 启动一次 Minecraft 以生成
config/quantum/secrets.json
- 编辑该文件,将
REPLACE_WITH_YOUR_KEY 替换为你的 OpenAI API 密钥
- 再次启动 — 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
Nova Quantum
By Seidr Labs — a Fabric mod that adds a voice-controlled AI companion to your Minecraft world.
Quantum is a Fabric mod for Minecraft 1.21.11. She joins your world as a real entity, listens for spoken commands, and plays beside you — mining, crafting, building, and defending — while following the same vanilla rules you do.
Quantum is the in-progress successor to the original Nova AI Minecraft Friend mod (~30k lines, archived 2026-05-11). This is a clean rebuild from the lessons of that project — smaller surface area, strict modular architecture, vanilla-rule-correct, and built to survive Minecraft version changes.
Required: your own OpenAI API key
Quantum's voice and AI features call OpenAI's API using a key you provide. The mod boots and loads without one, but the companion will be silent and unable to understand spoken commands until you supply a key.
On first launch the mod creates config/quantum/secrets.json with a placeholder. Replace REPLACE_WITH_YOUR_KEY with a key from .
You pay OpenAI directly for usage. There is no Seidr Labs middle-server, no proxy, no shared key. Costs depend on how much you talk — typical voice-heavy play is a few cents per session.
Network and privacy
The mod talks to exactly one external service when AI features are in use:
| Endpoint |
Used for |
Trigger |
https://api.openai.com/v1/audio/transcriptions |
Speech-to-text (Whisper) |
When you push-to-talk |
https://api.openai.com/v1/chat/completions |
Intent classification + reply text |
After transcription |
https://api.openai.com/v1/audio/speech |
Text-to-speech |
When Quantum replies aloud |
https://api.openai.com/v1/embeddings |
Semantic memory |
Optional, only if memory feature enabled |
That's the complete outbound network surface.
- No Seidr Labs telemetry. Nothing is sent to seidrlabs.online or any Seidr-controlled server. The mod does not phone home.
- No third-party analytics. No Sentry, no Google Analytics, no crash reporters.
- Your audio and prompts go to OpenAI. That's intrinsic to using their API. You're paying them, you're sending them data — same as if you were using ChatGPT directly.
- Conversation memory lives locally. The last several turns are stored in your Minecraft save folder, not in any cloud.
- API key never leaves your machine except inside the
Authorization: Bearer ... header on the calls above.
Features
Voice control
Push-to-talk capture is bound to a configurable key by default. Recorded audio (≥500 ms) is transcribed by OpenAI Whisper, the transcript is routed through a small set of fast in-mod intent rules, and anything not handled locally is sent to a chat-completions model for natural-language understanding. Confidence thresholds prevent her from acting on ambiguous instructions. Examples that work today:
- "find me ten diamonds" → she heads underground, descends safely on a stair pattern, and starts mining
- "follow me through this cave" → she paths behind you using vanilla navigation
- "defend me" → switches to a sword/bow loadout and engages hostile mobs near you
- "open inventory" / "hold this" → opens her menu so you can give her tools, food, blocks
Mining and resource gathering
Stairs-descent pathing for safe vertical travel. Recognises a curated catalogue of vanilla blocks and mobs (loaded from JSON; no hard-coded magic). Tunnels, navigates around obstacles, and stops when the request is satisfied or her inventory fills.
Combat
- Auto-swaps to the best weapon she's carrying for the engagement (melee → sword, ranged → bow)
- Shield blocking with realistic durability cost
- Kite-creeper behaviour: backs off when a creeper is fusing
- Targets the nearest credible threat first, switches if a closer one appears
- No aim-bot, no through-wall hits, no other vanilla-rule violations
Safety chains
A small library of "safety chain" behaviours that interrupt her current task when something dangerous is happening:
- FoodChain (shipped) — eats from her inventory when hungry
- FallSafetyChain (shipped v0.8.112) — places a water bucket under her at the impact point if she's falling more than three blocks and has a water bucket on hand. Behaves like a player MLG.
- LowHpFleeChain (in development) — disengages and regenerates when health drops below a threshold
- MobDefenseChain (in development) — proactive engagement of nearby threats during non-combat tasks
- EmergencyUnstuckChain (in development) — recovery behaviour when her pathing gets stuck on terrain
Each chain lives in shared code and uses platform-side helpers, so the same behaviours port cleanly to future Minecraft versions.
Conversation memory
Quantum remembers the last several turns of conversation across sessions. State persists when you log out and is restored when you log back in. Stored in your local save folder, never uploaded.
Despawn-safe inventory
When she despawns (you log out, she dies, the chunk unloads), her inventory is preserved and restored on respawn. No item loss.
Audio
Text-to-speech replies are generated by OpenAI's /v1/audio/speech endpoint, then played through Minecraft's existing OpenAL context — so her voice plays through the same audio device your game uses.
In-game menu
A dedicated G-key menu opens Quantum's status, inventory, and behaviour settings without leaving the world.
Installation
- Install Fabric Loader 0.18.1+ for Minecraft 1.21.11
- Install the Fabric API
- Drop
quantum-X.X.X.jar into your .minecraft/mods/ folder
- Launch Minecraft once to generate
config/quantum/secrets.json
- Edit that file and replace
REPLACE_WITH_YOUR_KEY with your OpenAI API key
- Launch again — Quantum is now voice-enabled
The mod loads with or without an API key. Without one, you'll still see the entity and the G-menu, but voice/AI features will be inactive.
Requirements
- Minecraft 1.21.11 (Fabric)
- Fabric Loader 0.18.1 or newer
- Fabric API
- Java 21+
- Both client and server (the mod is required on both sides for multiplayer)
- An OpenAI API key for voice / AI features
Project status
Quantum is in active pre-release development (current build v0.8.x). Major systems — voice routing, navigation, mining, combat, food, fall safety, despawn restore, conversation memory, audio, G-menu — are working and tested in continuous play sessions. Remaining safety chains (LowHpFlee, MobDefense, EmergencyUnstuck) are mid-port from the original Nova codebase and will land across the v0.8.x → v0.9.x series.
It's playable today, it works, but expect a version-bump cadence and the occasional behaviour change as the port completes.
About Seidr Labs
Seidr Labs is a small studio that ships focused, single-developer-maintained Minecraft tooling. No required Seidr-side services. No telemetry. Sane defaults. Production-tested before public release.
Sister project: NovaSync — server-side admin/networking backbone for Paper 1.21+.
Links
- Project home:
- Studio:
- Community / Discord:
- Patreon:
- YouTube (devlogs / demos): @Nova_Ai_MC_Mods
评论 0
登录后参与评分
还没有评论,来抢沙发吧