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 个令牌，仅使用此模组不会达到这一上限。

💰 付费选项——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（使用 Windows Speech API 进行 TTS，使用 Vosk 原生库进行语音识别）
⚠ 仅在单人游戏中测试过 —— 当服务端和客户端都安装时应该可以在服务器上运行，但完整的多人游戏优化仍在进行中。
⚠ 需要 Java 21。Minecraft 1.20.x 用户必须在启动器设置中手动将 Java 可执行文件指向 Java 21（javaw.exe），否则默认使用 Java 17，游戏可能在启动时崩溃。

📚 需要帮助？查看 wiki！

☕ 想支持这个项目？请我喝杯咖啡 ：）

🎮 现在去和你的村民聊天，玩得开心！

未来更新的计划功能

• 完整的多人游戏兼容性
• 支持其他 TTS API，例如 ElevenLabs —— 这将为更多操作系统、更多声音和语言带来 TTS 支持。
• GUI 和视觉改进
• 将设置翻译成更多语言