Simple Voice Chat Discord Bridge

> ⚠️ **征求反馈** > > 我正在收集关于支持哪些 Minecraft 版本和服务器平台/加载器的反馈。**请填写这份简短的匿名 Google 表单**：https://docs.google.com/forms/d/e/1FAIpQLSfhQhD9tSZK__N1GYHki1t2Zezd6WOd1IuKVqtAxlTQkZf4CA/viewform # Simple Voice Chat Discord 桥接 [](https://modrinth.com/plugin/simple-voice-chat-discord-bridge) [](https://modrinth.com/mod/fabric-api) > ⚠️ **警告** > > 这不是官方附加组件。**请不要前往 Simple Voice Chat 的 Discord 服务器寻求支持！请使用 [GitHub issues](https://github.com/amsam0/voicechat-discord/issues) 来获取支持。** 我会尽快提供支持，但无法保证响应时间。 Simple Voice Chat Discord Bridge 是一个适用于 Fabric 和 Paper/Purpur 的 Simple Voice Chat 附加组件，它在 Simple Voice Chat 和 Discord 之间建立了一座桥梁，允许未在客户端安装 Simple Voice Chat 的玩家听到和说话。例如，这个附加组件允许通过 Geyser 连接的基岩版玩家使用语音聊天！ - 错误报告、功能请求和一般支持：https://github.com/amsam0/voicechat-discord/issues - 更新日志：https://gitlab.com/amsam0/voicechat-discord/-/blob/main/CHANGELOG.md - 源代码：https://gitlab.com/amsam0/voicechat-discord （有关此项目基础设施的更多信息，例如同时使用 GitHub 和 GitLab，请滚动到最后一节。） # 安装与使用 首先，请确保你已经安装并正确配置了 [Simple Voice Chat](https://modrinth.com/mod/simple-voice-chat)。请参考 [Simple Voice Chat 维基](https://modrepo.de/minecraft/voicechat/wiki) 获取更多信息。 > ℹ️ **注意** > > Simple Voice Chat Discord Bridge 需要 Simple Voice Chat 版本 2.4.11 或更高。请确保你已更新！ 然后，你需要 [下载](https://modrinth.com/mod/simple-voice-chat-discord-bridge/versions) 与你的 Minecraft 版本兼容的最新版 Simple Voice Chat Discord Bridge。 > ℹ️ **注意** > > 如果你使用 Fabric 模组，它需要 [Fabric API](https://modrinth.com/mod/fabric-api)。 ## 查找配置文件 确保在安装 Simple Voice Chat 和 Simple Voice Chat Discord Bridge 后运行一次服务器，以生成 Simple Voice Chat Discord Bridge 的配置文件。 **Fabric：** Simple Voice Chat Discord Bridge 的配置文件应位于 `config/voicechat-discord.yml`。 **Paper/Purpur：** Simple Voice Chat Discord Bridge 的配置文件应位于 `plugins/voicechat-discord/config.yml`。 ## 设置机器人 首先，在 [discord.com/developers/applications](https://discord.com/developers/applications) 创建一个应用程序，点击右上角的 `New Application`。选择你希望机器人被称呼的名称。  在左侧，点击 `Bot`。点击 `Reset Token` 复制令牌。重置令牌后，应该会出现一个 `Copy` 按钮。  现在，用文本编辑器打开 [配置文件](#finding-the-configuration-file)。将 `DISCORD_BOT_TOKEN_HERE` 替换为你复制的令牌。它应该看起来像这样： ```yaml bots: - token: TheTokenYouJustPasted vc_id: VOICE_CHANNEL_ID_HERE ``` 接下来，点击左侧的 `Installation`。将 `Install Link` 从 `Discord Provided Link` 改为 `None`。  然后，点击左侧的 `Bot`。向下滚动并禁用 `Public Bot`。  最后，点击左侧的 `General Information` 并复制 Application ID。  在你的浏览器中，访问 `discord.com/api/oauth2/authorize?client_id=YOUR_APPLICATION_ID_HERE&permissions=36700160&scope=bot`，但将 `YOUR_APPLICATION_ID_HERE` 替换为你刚刚复制的应用程序 ID。选择你想要邀请机器人加入的服务器。**确保不要禁用它的任何权限。** 现在，按照 [support.discord.com/articles/Where-can-I-find-my-User-Server-Message-ID](https://support.discord.com/hc/en-us/articles/206346498-Where-can-I-find-my-User-Server-Message-ID-) 的步骤在 Discord 中启用开发者模式。然后，右键点击你希望机器人用作 Simple Voice Chat 和 Discord 之间桥梁的语音频道，点击 `Copy ID`。 > ⚠️ **警告** > > 语音频道中不能同时有多于一个人说话，否则会出现奇怪的音频故障。**我们建议将机器人语音频道限制为 2 个用户，以确保不会出现问题。** 现在，重新用文本编辑器打开 [配置文件](#finding-the-configuration-file)。将 `VOICE_CHANNEL_ID_HERE` 替换为你复制的频道 ID。它应该看起来像这样： ```yaml bots: - token: TheTokenYouJustPasted vc_id: TheChannelIDYouJustPasted ``` 你可以根据需要重复此过程来设置任意数量的机器人。关于拥有多个机器人的信息，[配置文件](#finding-the-configuration-file) 中有一些说明。 > ℹ️ **注意** > > 你拥有的机器人数量等同于可以同时通过 Discord 连接到 Simple Voice Chat 的人数。所以如果你有 3 个机器人，最多可以有 3 个人同时使用此附加组件。 ## 故障排除 如果在尝试使用机器人时遇到错误，请阅读控制台。错误信息总会包含导致错误的机器人的 vc_id，这可以帮助你识别是哪个机器人出了问题。 ## 在游戏中使用 > ⚠️ **警告** > > 语音频道中不能同时有多于一个人说话，否则会出现奇怪的音频故障。**我们建议将机器人语音频道限制为 2 个用户，以确保不会出现问题。** Simple Voice Chat Discord Bridge 的大部分功能都通过 `/dvc` 命令暴露。本节将介绍其所有子命令。 对于需要字符串参数的命令，你可以用引号将它们括起来以转义空格。 ### `/dvc start` 使用第一个可用的机器人启动语音聊天会话。你可能需要等待几秒钟才能开始。启动后，按照指示加入语音频道。你应该能听到玩家说话，其他玩家也应该能听到你说话。 如果在语音聊天会话中遇到问题，你可以尝试再次使用 `/dvc start` 来重新启动它。 ### `/dvc stop` 停止当前的语音聊天会话并断开机器人连接。 ### `/dvc group` 允许你列出、创建、加入、离开和移除群组。 #### `/dvc group list` 提供所有群组的列表。 #### `/dvc group create [密码] [类型] [持久性]` 允许你创建一个群组。 参数： - `名称`（必需）：群组的名称。 - `密码`（可选，默认为 `""`（无密码））：群组的密码。如果你不想要密码但想更改群组类型或持久性，只需传递一个空字符串：`""` - `类型`（可选，默认为 `normal`）：可以是 `normal`、`open` 或 `isolated`。 - `normal`：群组中的玩家可以听到附近不在群组中的玩家，但反之则不行 - `open`：群组中的玩家可以听到附近的玩家，附近的玩家也可以听到群组中的玩家 - `isolated`：群组中的玩家只能听到同一群组中的其他玩家 - `持久性`（可选，默认为 `false`）：如果为 `true`，群组在所有玩家离开后不会被移除。相反，必须使用 [`/dvc group remove `](#dvc-group-remove-id) 来移除它 #### `/dvc group join ` 允许你使用来自 [`/dvc group list`](#dvc-group-list) 的 ID 加入一个群组。 #### `/dvc group info` 提供你当前群组的信息。 #### `/dvc group leave` 允许你离开当前群组。 #### `/dvc group remove ` 允许你使用来自 [`/dvc group list`](#dvc-group-list) 的 ID 移除一个**没有玩家在其中的持久性**群组。 ### `/dvc togglewhisper` 允许你进行耳语。 ### `/dvc reloadconfig` 如果你是操作员（在 Fabric 上具体是权限等级 2 或更高）或者拥有 `voicechat-discord.reload-config` 权限，你可以使用 `/dvc reloadconfig` 子命令来重新加载配置，而无需重新加载/重启服务器。**使用此子命令将停止所有正在运行的机器人。** ## 项目基础设施 源代码和开发在 GitLab 上进行：https://gitlab.com/amsam0/voicechat-discord。 然而，由于拥有 GitHub 账户的用户比 GitLab 账户多得多，错误报告、功能请求和一般支持通过 GitHub 进行：https://github.com/amsam0/voicechat-discord/issues。 此外，使用 GitHub Actions 来构建和发布附加组件，因为我懒得迁移到 GitLab CI。工作流文件位于 GitHub 仓库：https://github.com/amsam0/voicechat-discord，你可以在 https://github.com/amsam0/voicechat-discord/actions 查看工作流运行结果。（虽然使用 GitHub Actions 克隆 GitLab 仓库可能会降低安全性，但 GitHub Actions 工作流会将用于构建发布的 Git 仓库作为工件上传，以便进行独立分析。所有文件的 sha256 哈希值和 `git log` 的输出也会被记录。）