Speaking Villagers – ChatGPT and TTS

Speaking Villagers – AI对话、友谊与任务

在 Minecraft 中与村民交谈，体验 AI 生成的回复、建立友谊并接取动态任务！

现已支持 Mistral API！使用自己的 API 密钥即可免费体验 🎉 现已支持识别玩家语音！

阅读完整介绍，或查看游戏内的 ModMenu 获取设置说明！

_视频有点旧了，现在的模组比视频里展示的更好。_

概览

Speaking Villagers 通过加入 AI 生成的对话、动态的村民与玩家友谊系统，以及任务，丰富了 Minecraft 中与村民的互动。
村民现在能够识别周围环境、对你的行动做出反应，并记住过往互动。

每位村民都有 8000 多种独特个性中的一种，让每次互动都更加与众不同。

_部分功能（TTS 和语音识别）仅支持 Windows 电脑。_

_强烈建议搭配 ModMenu 使用！_

🆕 0.6 版本 – 又一次重大更新！

• 玩家语音输入：使用麦克风直接与村民交谈，需安装 speech-recognition。（设置说明见下文）
• 23 种独特语音：提供英语、德语和多语言语音，可通过 ModMenu 选择。
• 全面升级的任务系统：新增 176 种不同的收集任务和 210 种基于职业的奖励，并改进了平衡性和成长曲线。
• 扩展个性系统：村民现在拥有 8000 多种独特的个性组合。
• 改进礼物系统：村民死亡时现在会掉落收到的礼物，并且只会捡起玩家丢弃的物品。
• 实验性语言设置：村民可自动检测玩家使用的语言，也可使用指定的首选语言。
• 重新设计 ModMenu 配置：新增多种选项，可控制 TTS、记忆、语音模型、感知能力等。
• 不再需要环境变量，可直接通过 ModMenu 设置 API 密钥
• 重要错误修复：缺少 API 密钥时不再/speak崩溃，并提升了整体稳定性。

👉 完整更新日志见文件页面！

功能

✅ AI 对话 – 与村民交谈，获得智能且贴合情境的回复
✅ 情境感知 – 村民会根据以下信息做出回应：

• 玩家名称、盔甲、手持物品、快捷栏、生命值和饥饿值
• 生物群系、天气和时段
• 附近的生物、方块和建筑
• 当前药水效果和游戏模式
• 声望和友谊等级
• 村民是否在室内、床上、游泳或骑乘

✅ 友谊系统 – 与村民交朋友后，他们会跟随你
✅ 任务系统 – 村民会提供程序生成的任务
✅ 礼物系统 – 村民会捡起物品并对此发表评论（需在 ModMenu 中启用）
✅ 8000 多种不同个性 – 每位村民都独具特色
✅ Windows 语音支持 – 村民可通过 Windows Speech API大声说话
✅ 可与 Talking Mobs Mod

同时使用🛠️ 可通过 ModMenu 完全自定义：选择 AI 模型、设置限制、开关各项系统等！

API 设置（Mistral 或 OpenAI）

🎉 免费方案 – Mistral

• 在 mistral.ai
• 创建免费账户
• 生成 API 密钥——登录网站后，可在“La plateforme”中找到它。MISTRAL_API_KEY=your_api_key
• 从 0.6 版本起，不再需要将 API 密钥设置为环境变量；也可以选择通过 ModMenu 设置密钥！

Mistral 的用量上限为每月 1,000,000,000 个 token，只用这个模组的话不会达到上限

💰 付费方案 – OpenAI

• 需要OpenAI 账号和 API 密钥
• 将此内容添加到你的系统中：OPENAI_API_KEY=your_api_key
• 从 0.6 版本起，你不再需要将 API 密钥设置为环境变量，也可以现在通过 ModMenu 设置！
• 按 Token 计费

_没有 API 密钥 = 没有 AI 回复 = 不会产生费用。你可以通过 ModMenu 决定使用哪种方式。_

_设置环境变量后，请重启电脑使其生效。也可以通过 ModMenu 设置（无需重启）_

安装

1. 🧩 安装模组将.jar放入你的mods文件夹。

1. 🔊 安装 Natural Voice SAPI Adapter，以获得更自然的村民语音（仅适用于 Windows）不安装的话，语音听起来会很机械。👉 下载适配器

1. 🔐 设置 API 密钥选择OpenAI和/或Mistral——两者均受支持。从 0.6 版本起，你不再需要将 API 密钥设置为环境变量，也可以现在通过 ModMenu 设置！

1. 🎤 设置语音识别（可选）

• 运行一次模组并在 ModMenu 中启用语音识别。
• 尝试说话时，模组会显示所需的模型路径（通常位于./AppData/Local/SpeakingVillagers/vosk_model下）。
• 下载 Vosk 模型（例如，从alphacephei.com/vosk/models下载），并将其解压到显示的文件夹中。
• 重启游戏，再试着和村民说话。

👉 下载 Vosk 模型 （推荐：vosk-model-small-en-us-0.15）。

_较大的模型需要高端硬件。_

命令

• /speak <message>– 对附近的村民说点什么
• /befriend– 手动与最近的村民建立友谊
• /unfriend– 手动结束与最近村民的友谊
• /quests– 显示当前任务
• /villagertraits– 显示附近所有村民的性格特征
• /tokens– 显示已使用的 Token 数量，主要用于调试/查看信息，与游戏玩法无关

兼容性

✅ 兼容大多数其他模组
⚠ 部分功能需要 Windows（TTS 使用 Windows Speech API，语音识别使用 Vosk 原生库）
⚠ 仅在单人游戏中测试过——在服务器和客户端都安装后应该可以用于服务器，但多人游戏的全面优化仍在进行中。
⚠ 需要Java 21。Minecraft 1.20.x 用户必须在启动器设置中手动指定 Java 可执行文件，指向 Java 21（javaw.exe）；否则默认使用 Java 17，游戏可能会在启动时崩溃。

📚 需要帮助？查看Wiki！

☕ 想支持这个项目？请我喝杯咖啡吧 🙂

🎮 现在去和村民聊天，尽情享受吧！

未来更新计划

• 全面兼容多人游戏
• 支持其他 TTS API，例如 ElevenLabs——这将让更多操作系统支持 TTS，并提供更多语音和语言。
• 改进 GUI 和视觉效果
• 将设置翻译成更多语言