Smiley's Better Voice

🗣️ 给 Verity 一副值得聆听的好嗓音


这是一个 VarmiteYT 的 Verity JE 的附属模组，旨在提供更具表现力的 TTS 语音——以及语音模仿功能。将内置的 TTS 替换为 Fish Audio 或 Cartesia AI——自然、富有表现力且完全可自定义。Verity 的 思考 方式不变，本模组只改变他的 声音。

---

✨ 功能概览

• 🐟 Fish Audio（默认）— 最佳音质和情感表现，支持丰富的内联 [emotion] 标签
• ⚡ Cartesia AI — 响应速度最快，发音精准
• 🎭 超过 64 种 Fish 情感 — 基础、高级、语调、音效和特殊传达标签
• 👤 语音模仿 — Verity 偶尔会用 你的 声音说话（Fish，私有模型，服务器存储）
• 🎛️ 为每种 TTS 单独设置 API 密钥、语音、语速和音量 — 随时切换，无需重新输入
• 🎭 自动情感 — Cartesia 从语音中检测情绪；Fish 使用回复中丰富的 [emotion] 标签
• 🎒 手持 Verity 时也可对话（可开关）
• 🤕 本地跌落音效 — Verity 受到跌落伤害时不调用 API
• 😱 投掷尖叫 — 经典的“AAAAAAAAHHH”带有 [screaming] 标签（使用你配置的语音）
• 💬 当密钥或语音 ID 缺失/被拒绝时，屏幕上的错误信息更友好

选择你的服务提供商：

目标	使用
音质与情感	Fish Audio
速度与准确性	Cartesia

支持的 Cartesia 情感：

😐 中性 😌 平静 ☺️ 满足 😊 兴奋 😢 悲伤 😡 愤怒 😬 恐惧

---

✅ 开始之前

请确保你已经安装了：

要求	版本
🟩 Minecraft	1.20.1
⚒️ Forge	47+
😁 Verity JE	5.0+
⬜ Cloth Config & GeckoLib	最新版

⚠️ 注意 — 本模组不会替代 Verity JE，而是协同工作。你需要同时安装两者。

---

🚀 快速开始（Fish Audio — 推荐）

1. 将两个模组 JAR 文件放入你的 mods 文件夹并启动 Minecraft
2. 在 fish.audio 创建一个免费账户
3. 从 fish.audio/app/api-keys 获取你的 API 密钥
4. 在 fish.audio/app/discovery 选择一个语音并复制其 语音/参考 ID
5. 在游戏中：模组 → Smiley's Better Voice → 配置
6. 打开 启用 Smiley's Better Voice 开关（TTS 提供商默认为 Fish Audio）
7. 打开 Fish Audio 选项卡，粘贴你的密钥和语音 ID，点击 完成
8. 打个招呼吧 👋

更喜欢 Cartesia？

1. 在 play.cartesia.ai 注册
2. 从 play.cartesia.ai/keys 获取密钥，从 play.cartesia.ai/voices 获取语音 ID
3. 在配置中：将 TTS 提供商 设置为 Cartesia，然后填写 Cartesia 选项卡

---

👤 语音模仿 (3.0+)

启用 让 Verity 模仿你的声音（Fish 选项卡）后：

1. 像平常一样使用 Verity 的 按键通话 麦克风
2. 在捕获到 约 10 秒 清晰的语音后，模组会上传一个 私有 Fish 语音模型（服务器端）
3. Verity 在正常对话中有 1/20 的几率使用你模仿的声音
4. 模仿的语音是 私有的 — 只有你的 Fish 账户可以访问
5. 每位玩家每个世界只能有一个模仿语音；存储于服务器以供多人游戏使用

管理员命令： /verityvoice clear <玩家名> 可移除该玩家在此世界中存储的模仿语音。

🎙️ 投掷尖叫（AAAAAAAAHHH）始终使用你配置的 Fish 语音 ID，而非模仿的语音。

---

🎨 选择语音

Fish Audio

🔹 浏览 语音发现 → 选择一个语音 → 复制其 参考 ID → 粘贴到 Fish Audio 选项卡中。

Cartesia

🔹 现成语音： 浏览 语音库 → 点击三个点 → 复制 语音 ID → 粘贴到 Cartesia 选项卡中。

🔸 克隆你自己的声音： 即时克隆 → 上传约 10 秒的清晰样本 → 复制 语音 ID → 粘贴到 Cartesia 选项卡中。

---

⚙️ 配置选项

位于 模组 → Smiley's Better Voice → 配置：

通用

设置	作用
🟢 启用 Smiley's Better Voice	总开关
🔀 TTS 提供商	Fish Audio 或 Cartesia
🎒 物品栏中对话	手持 Verity 物品时与他聊天

Fish Audio 选项卡

设置	作用	范围
🔑 Fish API 密钥	来自 api-keys 的密钥	—
🎙️ Fish 语音 ID	来自 discovery 的参考 ID	—
⚡ Fish 语速	他说话的速度	0.5 – 2.0
🔊 Fish 音量	他说话的音量	0.5 – 2.0
👤 让 Verity 模仿你的声音	捕获语音转文字音频以构建私有 Fish 模仿模型（服务器存储）	开 / 关

Cartesia 选项卡

设置	作用	范围
🔑 Cartesia API 密钥	来自 play.cartesia.ai/keys 的密钥	—
🎙️ Cartesia 语音 ID	来自 play.cartesia.ai/voices 的语音 ID	—
⚡ Cartesia 语速	他说话的速度	0.6 – 1.5
🔊 Cartesia 音量	他说话的音量	0.5 – 2.0

保存至 config/verity_cartesia-common.toml（兼容服务器）。

---

🎭 情感系统如何运作

Fish Audio — Verity 的回复可以包含 Fish 用于传达情感的 [emotion] 标签。本模组教会 Verity 完整的 Fish S2 标签集：基础情感、高级情感、语调标记（[screaming]， [whispering]）、音效（[laughing]， [sighing]）和停顿（[break]）。标签会从聊天文本和记忆中剥离，因此永远不会干扰 HUD。

Cartesia — 无需手动调整。模组会读取：

• 💬 Verity 说的话（用词、标点、语气）
• 😈 Verity 的表情（邪恶、开心、严肃、疯狂等）

---

🛠️ 故障排除

🔴 与 Verity 对话时提示“无效 API 密钥” — 这通常是 Verity JE 自身配置中的 Groq/Ollama 密钥问题，而非 TTS 密钥。请仔细检查两个密钥是否都放对了位置。

🟠 Verity 静音 — 确认已启用 Better Voice，Verity JE 中 使用文本转语音 已开启，你的提供商选项卡中有有效的密钥和语音 ID，并且你已联网。

🟡 提供商错误提示 — 按照屏幕上的提示操作（缺失密钥、语音 ID 无效、速率限制、计费问题）。Fish 密钥：api-keys。Cartesia 密钥：play.cartesia.ai/keys。

🟣 语音模仿失败 — 聊天信息会包含 Fish 的错误文本。常见解决方法：有效的 Fish API 密钥、足够的 Fish 积分，以及约 10 秒清晰的按键通话语音。

🔁 落地后投掷尖叫重复播放 — 已在 3.0.0 中修复。如果仍看到旧行为，请同时更新 Better Voice 和 Verity JE。

---

📌 注意事项

• 🌐 云 TTS 激活时需要联网（跌落音效为本地）
• 📊 使用限制取决于你的 Fish / Cartesia 账户套餐（语音模仿会消耗 Fish 模型创建积分）
• 🖥️ 模仿的语音存储在 服务器 上 — 在客户端和服务器同时安装时可用于多人游戏
• 🛠️ 非官方附属模组 — 并非由 Verity JE 团队制作

---

KreekCraft 也在玩！

嵌入视频

---

🔗 链接

---

法律声明：Smiley's Better Voice 是一个非官方的、独立编写的附属模组，与 Verity JE 或其创作者无任何关联。它要求单独安装主模组，且不会复制或重新分发其任何内容。Smiley's Better Voice 的创作者不对在训练可公开访问的 AI 语音模型时使用受版权保护的材料负责。Verity JE 的所有权利归其各自所有者所有。本声明不构成法律建议。