Simple Voice Chat Discord Bridge

⚠️ Нужен ваш отзыв

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

Simple Voice Chat Discord Bridge

[](https://modrinth.com/plugin/simple-voice-chat-discord-bridge) [](https://modrinth.com/mod/fabric-api)

⚠️ Внимание

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

Simple Voice Chat Discord Bridge — это дополнение для Simple Voice Chat для Fabric и Paper/Purpur, которое создаёт мост между Simple Voice Chat и Discord, позволяя игрокам без установленного Simple Voice Chat на клиенте слышать и говорить. Например, это дополнение позволяет игрокам Bedrock edition, подключённым через 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. Подробнее смотрите в вики Simple Voice Chat.

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

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

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

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

Если вы используете мод для Fabric, ему требуется 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, нажав 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 слева и скопируй Application ID.

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

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

⚠️ Внимание

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

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

bots:
    - token: TheTokenYouJustPasted
      vc_id: TheChannelIDYouJustPasted

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

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

Количество ботов равно количеству людей, которые могут одновременно подключиться к Simple Voice Chat через Discord. То есть если у тебя 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 [password] [type] [persistent]`

Позволяет создать группу.

Аргументы:

• name (обязательно): Имя группы.
• password (необязательно, по умолчанию "" (без пароля)): Пароль группы. Если вы не хотите пароль, но хотите изменить тип группы или её постоянство, просто передайте пустую строку: ""

• type (необязательно, по умолчанию normal): Может быть normal, open или isolated.

  • normal: Игроки в группе слышат nearby-игроков, которые не в группе, но не наоборот
  • open: Игроки в группе слышат nearby-игроков, и nearby-игроки слышат игроков в группе
  • isolated: Игроки в группе слышат только других игроков в группе
• persistent (необязательно, по умолчанию false): Если true, группа не будет удалена после того, как все игроки выйдут из неё. Вместо этого её нужно удалить с помощью [`/dvc group remove `](#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 или выше на fabric) или у вас есть разрешение 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. Файлы workflow находятся в репозитории GitHub по адресу https://github.com/amsam0/voicechat-discord, и вы можете просмотреть результаты запусков workflow по адресу https://github.com/amsam0/voicechat-discord/actions. (Хотя использование GitHub Actions для клонирования репозитория GitLab, возможно, снижает безопасность, workflow-файлы GitHub Actions загружают Git-репозиторий, использованный для сборки релиза, в качестве артефакта, чтобы обеспечить возможность независимого анализа. Хэши sha256 всех файлов и вывод git log также логируются.)