Niebla – Your AI Pet Companion

Niebla：你的AI宠物伙伴

你Minecraft世界中的活生生伙伴。 Niebla能与你交谈、记住你的冒险、对危险做出反应、听从自然语言指令，并以狗或猫的形态陪伴你。

Minecraft 1.20.1 • Fabric与Forge • 文字与语音 • 可选Doggy Talents Next支持

• 认识Niebla

  Niebla不只是一只会说话的宠物。她会留意你周围发生的事，记住有意义的时刻，并随着时间与你建立更紧密的羁绊。

  选择狗或猫，给你的伙伴取任意名字，并通过Minecraft聊天或按键说话语音自然地交流。Niebla会用简短、贴合情境的话语回应，并保持她忠诚、好奇、偶尔神秘的性格。

  Niebla能做什么

  • 通过Minecraft聊天或你的麦克风交谈。
  • 以动画对话气泡和本地系统语音回应。
  • 记住最近的对话和你冒险中的重要时刻。
  • 建立从0到100的关系羁绊。
  • 过来、跟随、停留、坐下、睡觉、拾取掉落物并守卫区域。
  • 理解英语、西班牙语和葡萄牙语中的安全自然语言指令。
  • 当敌对生物真正出现时做出一次反应，包括兼容的模组敌人。
  • 使用专为在光影下保持可读性而设计的实心、非自发光对话气泡。
  • 以狗或猫的形态工作，并可自定义名字。
  • 可选与Doggy Talents Next集成。

  ---

  1.2.0-beta.5新增内容

  • 对话记忆： 最近的交流让后续对话具有连贯性。
  • 重要记忆： 个人细节、明确请求和共同里程碑会按玩家和世界本地存储。
  • 关系进展： 对话、互动和冒险会逐渐加深你们的羁绊。
  • 真实行动： Niebla现在可以执行一组安全的、由服务端权威验证的指令。
  • 改进的拾取： 指向掉落的物品并让Niebla把它带回来。原物品会被携带而不会被复制。
  • 更好的移动： 拾取导航和短距离行走动画已得到打磨。
  • 有序对话： 语音和气泡会排队等待，而不是互相覆盖或同时说话。
  • 更智能的警告： 每个敌对实体只触发一次警告，直到它消失、卸载或变为隐形。
  • 光影友好气泡： 气泡不透明、非自发光，不再造成亮闪或泛光。
  • 完整Forge移植： Fabric和Forge版本现在共享相同的功能集。
  • 更新Groq模型： 使用已停用默认模型的安装会自动迁移，而自定义模型选择保持不变。

  ---

  自然交谈

  用她当前的名字称呼Niebla，或使用Niebla 作为永久别名。相同的短语在聊天和语音中都有效。

  Niebla, come here
  Niebla, follow me
  Niebla, stay here
  Niebla, sit down
  Niebla, go to sleep
  Niebla, bring that
  Niebla, guard this place

  自然行动检测刻意保持保守。Groq无法运行任意的Minecraft或操作系统命令；Niebla只能请求一份固定的安全行动允许列表，并由服务端验证。

  控制

  • V — 按一次开始录音，再按一次转写并发送。
  • F8 — 向Niebla发送一个快速的上下文对话提示。
  • 在普通聊天消息开头输入Niebla的名字即可与她交谈。

  伙伴指令

  /niebla summon
  /niebla name <name>
  /niebla pet
  /niebla pet dog
  /niebla pet cat
  /niebla come
  /niebla follow
  /niebla stay
  /niebla sit
  /niebla sleep
  /niebla fetch
  /niebla guard

  记忆与配置命令

  /nieblaconfig
  /nieblareload
  /nieblamemories
  /nieblaremember <memory>
  /nieblabond
  /nieblaforget confirm

安装

1. 安装 Minecraft 1.20.1，并使用 Fabric 或 Forge 47.x。
2. 若使用 Fabric，还需安装 Fabric API。
3. 下载适用于你所使用加载器的 Niebla 文件。请勿同时安装两个版本。
4. 将 JAR 放入你的 mods 文件夹，并启动游戏一次。
5. 打开 config/niebla_ai_pet.properties 并添加你的 Groq API 密钥。

若要进行多人游戏，请在客户端和服务端都安装 Niebla。每位玩家保留自己的客户端 Groq 密钥和本地记忆文件。

配置

Niebla 会自动创建以下文件：

config/niebla_ai_pet.properties

基本选项：

groq_api_key=YOUR_API_KEY
language=en

从 console.groq.com/keys 获取 Groq API 密钥。

单个 language 选项控制麦克风转录、AI 回复语言和语音口音。常见值包括：

language=en
language=es
language=pt

记忆与隐私

重要记忆和关系进度会本地存储在：

config/niebla_ai_pet/memories/

当 Niebla 回答时，模组会将你的消息、当前 Minecraft 情况的简要描述以及所有已启用的对话记忆发送给 Groq。按键说话音频会发送给 Groq 进行转录。记忆文件保留在你的电脑上，可随时禁用或清除。

Doggy Talents Next

Doggy Talents Next 完全可选。当安装了同一加载器的兼容版本时，Niebla 的狗形态可以使用 DTN 自带的狗转换，并对抚摸、拥抱、行为模式和受支持的动画做出反应。

Niebla 不捆绑 DTN 代码或资源，且在没有它时仍可正常加载。将已训练的 DTN 狗切换为猫形态不会转移 DTN 天赋、饰品或进度。

兼容性

• Minecraft： 1.20.1
• 加载器： Fabric 和 Forge 47.x
• 环境： 客户端和服务端
• Fabric 依赖： Fabric API
• 可选集成： Doggy Talents Next
• 内置反应语言： 英语、西班牙语和葡萄牙语

观看 Niebla 实际效果

由 Joseeet 创建。