Simple Voice Chat Discord Bridge

⚠️ Желаем обратной связи

Мне нужны отзывы о том, какую версию Minecraft и серверные платформы/загрузчики поддерживать. Пожалуйста, заполните эту короткую анонимную форму Google: https://docs.google.com/forms/d/e/1FAIpQLSfhQhD9tSZK__N1GYHki1t2Zezd6WOd1IuKVqtAxlTQkZf4CA/viewform

Простой голосовой чат Discord Bridge

⚠️ Внимание

Это не официальный аддон. Пожалуйста, не обращайтесь за поддержкой на сервер разногласий Simple Voice Chat! Вместо этого используйте GitHub Issues для поддержки. Я постараюсь предоставить поддержку как можно скорее, но нет никакой гарантии, сколько времени это займет.

Простой голосовой чат Discord Bridge — это дополнение к простому голосовому чату для Fabric and Paper/Purpur, которое создает мост между простым голосовым чатом и Discord, позволяя игрокам, у которых на клиенте не установлен простой голосовой чат, слышать и говорить. Например, этот аддон позволяет игрокам издания Bedrock, подключенным через Гейзер, использовать голосовой чат!

• Отчеты об ошибках, запросы функций и общая поддержка: 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 для получения дополнительной информации.

ℹ️ Примечание

Простой голосовой чат Discord Bridge требует версии 2.4.11 или более поздней версии Simple Voice Chat. Пожалуйста, убедитесь, что вы обновились!

Затем вам нужно загрузить последнюю версию Simple Voice Chat Discord Bridge, совместимую с вашей версией Minecraft.

ℹ️ Примечание

Если вы используете мод Fabric, для него требуется Fabric API.

Находим файл конфигурации

Обязательно запустите свой сервер один раз с установленными Simple Voice Chat и Simple Voice Chat Discord Bridge, чтобы создать файл конфигурации Simple Voice Chat Discord Bridge.

Ткань: Файл конфигурации 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, нажав 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 слева и скопируйте идентификатор приложения.

В браузере перейдите по адресу discord.com/api/oauth2/authorize?client_id=YOUR_APPLICATION_ID_HERE&permissions=36700160&scope=bot, но замените YOUR_APPLICATION_ID_HERE на только что скопированный идентификатор приложения. Выберите сервер, на который вы хотите пригласить своего бота. Обязательно не отключайте какие-либо разрешения.

Теперь следуйте инструкциям на странице support.discord.com/articles/Where-can-I-find-my-User-Server-Message-ID, чтобы включить режим разработчика в Discord. Затем щелкните правой кнопкой мыши голосовой канал, который бот должен использовать в качестве моста между простым голосовым чатом и Discord, и нажмите Copy ID.

⚠️ Внимание

В голосовом канале одновременно не может говорить более одного человека, иначе возникнут странные сбои в звуке. Мы рекомендуем ограничить голосовые каналы ботов двумя пользователями, чтобы это не вызывало проблем.

Теперь снова откройте файл конфигурации в текстовом редакторе. Замените VOICE_CHANNEL_ID_HERE на скопированный вами идентификатор канала. Это должно выглядеть примерно так:

bots:
    - token: TheTokenYouJustPasted
      vc_id: TheChannelIDYouJustPasted

Вы можете повторить этот процесс для любого количества ботов, которое захотите. В файле конфигурации есть некоторая информация о наличии нескольких ботов.

ℹ️ Примечание

Количество ботов, которые у вас есть, эквивалентно количеству людей, которые могут одновременно подключиться к Простому голосовому чату через Discord. Таким образом, если у вас 3 бота, аддоном могут одновременно пользоваться до 3 человек.

Устранение неполадок

Если вы столкнулись с ошибками при попытке использовать бота, прочтите консоль. Ошибки всегда будут включать vc_id бота, который позволяет определить, какой бот вызвал ошибку.

Использование его в игре

⚠️ Внимание

В голосовом канале одновременно не может говорить более одного человека, иначе возникнут странные сбои в звуке. Мы рекомендуем ограничить голосовые каналы ботов двумя пользователями, чтобы это не вызывало проблем.

Большая часть функций Simple Voice Chat Discord Bridge доступна с помощью команды /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.

/dvc group info

Предоставляет вам информацию о вашей текущей группе.

/dvc group leave

Позволяет вам покинуть текущую группу.

/dvc group remove <ID>

Позволяет удалить постоянную группу без игроков, используя идентификатор из /dvc group list.

/dvc togglewhisper

Позволяет шептать.

/dvc reloadconfig

Если вы являетесь оператором (в частности, уровень разрешений 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 также записывается.)