Mutualzz Voice

Mutualzz 语音（客户端模组）

在《我的世界》游戏内收听和进行 Mutualzz 语音对话。

这是一个用于 PC 的 Fabric 客户端模组。服务器需要官方 Mutualzz Bridge 插件，它连接到 Mutualzz 的托管中心。

没有这个模组，你仍然可以通过 /mzvoice join 在 Mutualzz 应用中显示在线状态——只是无法获得游戏内音频。

---

许可与再分发

源代码公开以供透明和社区贡献。这不意味着允许再分发构建产物。

你可以：

• 安装官方构建版本，并在连接到 Mutualzz 的服务器上配合 Mutualzz Bridge 使用。
• 复刻（Fork）仓库并提交拉取请求——贡献者将获得署名（参见 CONTRIBUTING）。

未经 Mutualzz 书面许可，你不得：

• 重新上传或分享通用 jar 包 / 非官方构建版本。
• 将其发布到 Modrinth、CurseForge、GitHub Releases 等平台供他人安装。
• 未经许可将其打包到公开整合包中。

参见 LICENSE。有关合作权利，请联系 mutualzz.com。

---

你需要准备什么

Minecraft	26.1.x（与服务器版本一致）
加载器	Fabric Loader 0.19.3+
必需模组	Fabric API 和 Amecs
服务器	官方 Mutualzz Bridge，你的账户已关联，并在 Mutualzz 中绑定了语音房间

---

安装（玩家）

1. 为 Minecraft 26.1.x 安装一个 Fabric 配置（使用 Fabric 安装器或支持 Fabric 的启动器）。
2. 下载以下 jar 包（匹配你的 Minecraft 版本）：
   • Fabric API — Modrinth
   • Amecs — Modrinth
   • Mutualzz Voice — 来自 Mutualzz GitHub Release 的官方 jar 包 Mutualzz Minecraft v…（标签 minecraft-v…；与 Bridge 插件同版本——不要使用第三方镜像）
3. 将所有三个 jar 包放入你的 Minecraft mods 文件夹。
   • Prism / MultiMC / CurseForge：打开实例 → Mods 文件夹
   • 官方启动器：.minecraft/mods
4. 使用 Fabric 配置启动 Minecraft。
5. 加入装有 Mutualzz Bridge 的服务器。
6. 如果你尚未关联账户：/mzlink（按照 Mutualzz 设置中的代码操作）。
7. 加入语音：/mzvoice join
   可选房间名称：/mzvoice join lobby（Tab 补全会显示该服务器上绑定的房间）。
   离开使用 /mzvoice leave。

连接成功后，屏幕左上角会出现一个绿色的 Mutualzz Voice 标签。

---

控制

随时按 Ctrl+O 打开设置界面（音量、麦克风、按键说话、静音、按用户设置）。

你还可以使用快捷键（可在 选项 → 控制 → Mutualzz Voice 中重新绑定）：

按键	功能
Ctrl+O	语音设置
Ctrl+M	静音麦克风
Ctrl+D	关闭听觉（Deafen）
Ctrl+H	显示 / 隐藏谁在说话
Ctrl+I	切换语音活动 ↔ 按键说话
V（按住）	在按键说话模式下发言
Ctrl+= / Ctrl+-	输出音量增大 / 减小
Ctrl+Shift+= / Ctrl+Shift+-	麦克风灵敏度提高 / 降低
Ctrl+[ / Ctrl+]	选择上一个 / 下一个用户
Ctrl+↑ / Ctrl+↓	该用户的音量
Ctrl+U	在本地静音该用户

设置保存在 config/mutualzz_voice.json 中。

---

故障排除

• 执行 /mzvoice join 后没有绿色 HUD — 确认 Fabric API 和 Amecs 已加载，并且服务器上的 Mutualzz Bridge 在线。
• 已加入但听不到任何人说话 — 在 Ctrl+O 中检查输出音量，并确认你没有被关闭听觉（Ctrl+D）。
• 没有人能听到你说话 — 取消静音（Ctrl+M），提高麦克风灵敏度，或切换到按键说话并按住 V。
• 被踢出 / 离开后仍不断重连 — 更新到最新的官方模组；当你被移出频道后，会话会正常结束。
• Minecraft 版本错误 — 此模组仅支持 26.1.x。