Simple Voice Chat Discord Bridge

Simple Voice Chat Discord Bridge - это аддон для Simple Voice Chat, который соединяет голосовой чат в Майнкрафт с Discord. Проще говоря, он позволяет игрокам без установленного мода на клиенте слышать и говорить с теми, у кого мод есть. Например, через этот аддон игроки на Bedrock-издании, подключенные через Geyser, могут полноценно пользоваться голосовым чатом. Крутая штука, если на сервере есть и Java, и Bedrock игроки.

Это не официальный аддон, так что за поддержкой лучше идти на GitHub, а не в Discord Simple Voice Chat. Баги, фичи и вопросы - туда же.

Установка и настройка

Сначала убедись, что у тебя стоит и правильно настроен Simple Voice Chat версии 2.4.11 или новее. Потом скачай последнюю версию аддона под твою версию Minecraft.

Если используешь Fabric-версию, понадобится ещё Fabric API.

Где лежит конфиг

Запусти сервер один раз с обоими модами, чтобы сгенерировался конфигурационный файл.

• Fabric: config/voicechat-discord.yml
• Paper/Purpur: plugins/voicechat-discord/config.yml

Настройка бота

1. Зайди на discord.com/developers/applications, нажми New Application, дай имя боту.
2. Слева выбери Bot, нажми Reset Token, скопируй токен.
3. Открой конфиг текстовым редактором, замени DISCORD_BOT_TOKEN_HERE на скопированный токен. Должно получиться так:

bots:
    - token: TheTokenYouJustPasted
      vc_id: VOICE_CHANNEL_ID_HERE

4. Слева нажми Installation, смени Install Link на None.
5. В разделе Bot отключи Public Bot.
6. В General Information скопируй Application ID.
7. В браузере открой discord.com/api/oauth2/authorize?client_id=YOUR_APPLICATION_ID_HERE&permissions=36700160&scope=bot, подставь свой ID. Пригласи бота на сервер, не отключай разрешения.
8. В Discord включи Developer Mode (настройки -> продвинутые), кликни правой кнопкой по голосовому каналу, который будет мостом, и скопируй ID.
9. Открой конфиг снова, замени VOICE_CHANNEL_ID_HERE на скопированный ID канала.

Важно: В голосовом канале не должно говорить больше одного человека одновременно, иначе будут глюки со звуком. Рекомендуется ограничить канал двумя пользователями.

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

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

Основные функции доступны через команду /dvc. Вот её подкоманды:

• /dvc start - запускает сессию голосового чата через первого доступного бота. Подожди пару секунд, зайди в голосовой канал - и ты слышишь игроков, они слышат тебя. Если что-то пошло не так, попробуй перезапустить той же командой.
• /dvc stop - останавливает сессию и отключает бота.
• /dvc group list - показывает список групп.
• /dvc group create <name> [password] [type] [persistent] - создаёт группу. Параметры:
  • name - название группы (обязательно)
  • password - пароль (необязательно, по умолчанию пусто)
  • type - тип: normal (игроки в группе слышат nearby-игроков вне группы, но не наоборот), open (все слышат всех), isolated (только внутри группы)
  • persistent - если true, группа не удалится, когда все выйдут
• /dvc group join <ID> - присоединиться к группе по ID.
• /dvc group info - информация о текущей группе.
• /dvc group leave - выйти из группы.
• /dvc group remove <ID> - удалить постоянную группу (в ней не должно быть игроков).
• /dvc togglewhisper - включить/выключить шёпот.
• /dvc reloadconfig - перезагрузить конфиг без перезапуска сервера (нужен уровень оператора 2+ на Fabric или permission voicechat-discord.reload-config). Останавливает всех ботов.

Если что-то пошло не так

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

Про инфраструктуру проекта

Исходники и разработка ведутся на GitLab, а баги и фичи принимают на GitHub - так удобнее, потому что у большинства пользователей есть аккаунты на GitHub. Сборки и релизы делаются через GitHub Actions.