简易语音聊天Discord桥接

简易语音聊天Discord桥接

一个模组和插件，用于在简单语音聊天与Discord之间搭建桥梁，让未安装模组的玩家也能听见和说话。

冒险

⚠️ 征求意见

我正在征集关于应支持哪些 Minecraft 版本和服务器平台/加载器的反馈意见。请填写这份简短的匿名 Google 表单：https://docs.google.com/forms/d/e/1FAIpQLSfhQhD9tSZK__N1GYHki1t2Zezd6WOd1IuKVqtAxlTQkZf4CA/viewform

简易语音聊天 Discord 桥接

Modrinth 需要 Fabric API

⚠️ 警告

这不是官方附加组件。请勿前往简易语音聊天 Discord 服务器寻求支持！请改用 GitHub 问题 获取支持。 我会尽力尽快提供支持，但不保证需要多长时间。

简易语音聊天 Discord 桥接是简易语音聊天的一个附加组件，适用于 Fabric 和 Paper/Purpur，它在简易语音聊天和 Discord 之间建立桥梁，让未在客户端安装简易语音聊天的玩家也能听到和说话。例如，此附加组件允许通过 Geyser 连接的基岩版玩家使用语音聊天！

（有关此项目基础设施的更多信息，例如同时使用 GitHub 和 GitLab，请滚动到最后一节。）

安装与使用

首先，确保你已安装并正确配置 简易语音聊天。请参阅 简易语音聊天 Wiki 了解更多信息。

ℹ️ 注意

简易语音聊天 Discord 桥接需要简易语音聊天 2.4.11 或更高版本。请确保你已更新！

然后，你需要 下载 与你的 Minecraft 版本兼容的最新版简易语音聊天 Discord 桥接。

ℹ️ 注意

如果你使用 Fabric 模组，则需要 Fabric API。

查找配置文件

请确保在安装简易语音聊天和简易语音聊天 Discord 桥接的情况下运行一次服务器，以生成简易语音聊天 Discord 桥接的配置文件。

Fabric： 简易语音聊天 Discord 桥接的配置文件应位于 config/voicechat-discord.yml。

Paper/Purpur： 简易语音聊天 Discord 桥接的配置文件应位于 plugins/voicechat-discord/config.yml。

设置机器人

首先，访问 discord.com/developers/applications，点击右上角的 New Application 创建一个应用程序。为你的机器人选择想要的名称。

在左侧点击 Bot。通过点击 Reset Token 复制令牌。重置令牌后，应该会出现一个 Copy 按钮。

现在，用文本编辑器打开 配置文件。将 DISCORD_BOT_TOKEN_HERE 替换为你复制的令牌。它应该看起来像这样：

bots:
    - token: TheTokenYouJustPasted
      vc_id: VOICE_CHANNEL_ID_HERE

接下来，点击左侧的 Installation。将 Install Link 从 Discord Provided Link 改为 None。

接下来，点击左侧的 Bot。向下滚动并禁用 Public Bot。

最后，点击左侧的 General Information 并复制应用程序 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 的步骤在 Discord 中启用开发者模式。然后，右键单击你希望机器人用作简易语音聊天和 Discord 之间桥梁的语音频道，点击 Copy ID。

⚠️ 警告

语音频道中一次不能有超过一个人说话，否则会出现奇怪的音频故障。我们建议将机器人语音频道限制为 2 个用户，以确保不会造成问题。

现在，用文本编辑器重新打开 配置文件。将 VOICE_CHANNEL_ID_HERE 替换为你复制的频道 ID。它应该看起来像这样：

bots:
    - token: TheTokenYouJustPasted
      vc_id: TheChannelIDYouJustPasted

你可以根据需要重复此过程来添加任意数量的机器人。配置文件 中有一些关于拥有多个机器人的信息。

ℹ️ 注意

你拥有的机器人数量等同于可以同时通过 Discord 连接到简易语音聊天的人数。因此，如果你有 3 个机器人，则最多可以有 3 人同时使用该附加组件。

故障排除

如果在使用机器人时遇到错误，请阅读控制台。错误信息总会包含机器人的 vc_id，这让你能够识别是哪个机器人导致了错误。

在游戏中使用

⚠️ 警告

语音频道中一次不能有超过一个人说话，否则会出现奇怪的音频故障。我们建议将机器人语音频道限制为 2 个用户，以确保不会造成问题。

简易语音聊天 Discord 桥接的大部分功能通过 /dvc 命令暴露。本节将介绍其所有子命令。

对于接受字符串参数的命令，你可以用引号包裹它们来转义空格。

/dvc start

使用第一个可用机器人开始语音聊天会话。你可能需要等待几秒钟才能启动。启动后，按提示加入语音频道。你应该能听到其他玩家说话，其他玩家也应该能听到你说话。

如果你在语音聊天会话中遇到问题，可以尝试再次使用 /dvc start 重新启动。

/dvc stop

停止当前语音聊天会话并断开机器人。

/dvc group

允许你列出、创建、加入、离开和移除群组。

/dvc group list

提供所有群组的列表。

/dvc group create <name> [password] [type] [persistent]

允许你创建群组。

参数：

  • name（必需）：群组的名称。
  • password（可选，默认为 ""（无密码））：群组的密码。如果你不想要密码但想更改群组类型或持久性，只需传递空字符串：""
  • type（可选，默认为 normal）：可以是 normal、open 或 isolated。
    • normal：群组内的玩家可以听到附近不在群组中的玩家，但反之则不行
    • open：群组内的玩家可以听到附近的玩家，附近的玩家也可以听到群组内的玩家
    • isolated：群组内的玩家只能听到群组内的其他玩家
  • persistent（可选，默认为 false）：如果为 true，当所有玩家离开后群组不会被移除。相反，必须使用 /dvc group remove <ID> 来移除

/dvc group join <ID>

允许你使用来自 /dvc group list 的 ID 加入群组。

/dvc group info

提供你当前群组的信息。

/dvc group leave

允许你离开当前群组。

/dvc group remove <ID>

允许你使用来自 /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。

此外，由于我不想麻烦地迁移到 GitLab CI，GitHub Actions 被用来构建和发布附加组件。工作流文件位于 GitHub 仓库 https://github.com/amsam0/voicechat-discord，你可以在 https://github.com/amsam0/voicechat-discord/actions 查看工作流运行结果。（虽然使用 GitHub Actions 克隆 GitLab 仓库可以说会降低安全性，但 GitHub Actions 工作流会将用于构建发布的 Git 仓库作为工件上传，以便进行独立分析。所有文件的 sha256 哈希值以及 git log 的输出也会被记录。）