新星量子

新星量子

一个Fabric 1.21.11的同伴模组，为你的世界添加一个语音控制的AI角色。语音功能需要你自备OpenAI API密钥。

游戏机制

Nova Quantum

由 Seidr Labs 出品 — 一款为你的 Minecraft 世界添加语音控制 AI 伙伴的 Fabric 模组。

Quantum 是一款适用于 Minecraft 1.21.11 的 Fabric 模组。她会作为一个真实实体加入你的世界，聆听语音指令，并陪伴你一同游玩——采矿、合成、建造和防御——同时遵循与你相同的原版规则。

Quantum 是原 Nova AI Minecraft Friend 模组（约 3 万行代码，归档于 2026-05-11）正在开发中的继任者。这是基于该项目经验教训的彻底重建——更小的体积、严格的模块化架构、符合原版规则，并能够在 Minecraft 版本更新中生存。

必需：你自己的 OpenAI API 密钥

Quantum 的语音和 AI 功能会调用 OpenAI 的 API，使用的是你自己提供的密钥。模组在没有密钥的情况下也能启动和加载，但在你提供密钥之前，伙伴将保持沉默，无法理解语音指令。

首次启动时，模组会创建 config/quantum/secrets.json 并包含一个占位符。将 REPLACE_WITH_YOUR_KEY 替换为来自 https://platform.openai.com/api-keys 的密钥。

你直接向 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 转写，转写文本通过模组内置的一组快速意图规则路由，任何未在本地处理的内容都会发送给聊天补全模型进行自然语言理解。置信度阈值防止她对模糊指令做出行动。目前可用的示例：

  • “帮我找十颗钻石” → 她会潜入地下，以阶梯模式安全下降，并开始采矿
  • “跟我穿过这个洞穴” → 她会使用原版导航在你身后寻路
  • “保护我” → 切换为剑/弓装备，并攻击你附近的敌对生物
  • “打开背包” / “拿住这个” → 打开她的菜单，以便你给她工具、食物和方块

采矿与资源收集

阶梯式下行寻路确保安全的垂直移动。能识别精选的原版方块和生物目录（从 JSON 加载，无硬编码魔法）。可挖掘隧道、绕过障碍物，并在请求完成或背包填满时停止。

战斗

  • 根据战斗情况自动切换到所携带的最佳武器（近战 → 剑，远程 → 弓）
  • 盾牌格挡，具有真实的耐久度消耗
  • 苦力怕风筝行为：当苦力怕即将爆炸时后退
  • 优先攻击最近的威胁目标，若出现更近的目标则切换
  • 没有自动瞄准、没有穿墙攻击、没有其他违反原版规则的行为

安全链

一个“安全链”行为小库，当发生危险情况时会中断她当前的任务：

  • 食物链 （已包含） — 饥饿时从背包中进食
  • 坠落安全链 （v0.8.112 已包含） — 当她坠落超过三格且手头有水桶时，会在落点上方放置水桶。行为类似玩家的 MLG 操作。
  • 低血量逃生链 （开发中） — 当生命值低于阈值时脱离战斗并恢复
  • 怪物防御链 （开发中） — 在非战斗任务中主动应对附近的威胁
  • 紧急脱困链 （开发中） — 当她的寻路被地形卡住时的恢复行为

每个链都位于共享代码中，并使用平台侧辅助，因此相同的行为可以干净地移植到未来的 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 键菜单，但语音/AI 功能将处于非活动状态。

配置要求

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

项目状态

Quantum 处于活跃的预发布开发阶段（当前版本 v0.8.x）。主要系统——语音路由、导航、采矿、战斗、食物、坠落安全、消失恢复、对话记忆、音频、G 键菜单——均已在持续游玩会话中正常工作和测试。其余安全链（低血量逃生、怪物防御、紧急脱困）正在从原始 Nova 代码库中移植，将在 v0.8.x → v0.9.x 系列中陆续推出。

目前即可游玩，功能可用，但随着移植工作的完成，预计会有版本号更新节奏和偶尔的行为变化。

关于 Seidr Labs

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

姊妹项目：NovaSync — Paper 1.21+ 的服务端管理/网络核心。

链接