> For the complete documentation index, see [llms.txt](https://docs.vanillasquad.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vanillasquad.com/igrovoi-kontent/mod-na-golosovoi-chat.md).

# Голосовой чат

На VanillaSquad доступен голосовой чат Plasmo Voice, который позволяет общаться с другими игроками непосредственно в Minecraft, без необходимости использовать сторонние программы.

Голосовой чат работает по принципу близости: вы слышите игроков, находящихся рядом с вами, а звук располагается в игровом пространстве. Это делает общение более естественным и помогает координировать совместные постройки, путешествия и другие активности.

{% hint style="info" %}
**Голосовой чат необязателен!**

Вы можете подключаться к VanillaSquad и играть без Plasmo Voice. Однако для использования голосового общения необходимо установить клиентский мод.
{% endhint %}

### Установка

#### Официальная сборка VanillaSquad

Самый простой способ — установить нашу готовую сборку. В ней уже присутствуют Plasmo Voice и дополнение для голосовых групп.

[Скачать сборку VanillaSquad](https://vanillasquad.com/modpack)

Инструкции по установке для разных лаунчеров доступны в разделе [Установка сборки сервера](https://docs.vanillasquad.com/osnovnye/ustanovka-sborki-servera).

#### Ручная установка

Если вы используете собственную сборку Minecraft:

1. Установите [Fabric Loader](https://fabricmc.net/use/installer/) для подходящей версии Minecraft.
2. Скачайте [Plasmo Voice](https://modrinth.com/mod/plasmo-voice) для вашей версии игры и загрузчика.
3. Установите [Fabric API](https://modrinth.com/mod/fabric-api), если используете Fabric.
4. Переместите скачанный файл `.jar` в папку `mods`.
5. Запустите Minecraft.

Дополнительно для использования графического интерфейса голосовых групп установите [pv-addon-groups](https://modrinth.com/plugin/pv-addon-groups).

{% hint style="warning" %}
Следите за совместимостью версий Minecraft, загрузчика и модификаций. Не устанавливайте файлы для других версий игры.
{% endhint %}

### Первоначальная настройка

После подключения к серверу откройте меню Plasmo Voice клавишей **V** (по умолчанию).

В меню доступны несколько основных разделов.

#### Устройства (Devices)

Здесь настраиваются устройства для голосового общения:

* **Microphone** — выбор микрофона.
* **Microphone Volume** — громкость микрофона.
* **Activation Threshold** — чувствительность активации микрофона.
* **Output Device** — устройство воспроизведения звука.

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

<figure><img src="https://1639357051-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Md61sIy9355-Dt4QFTm%2Fuploads%2FPmy0myU28P8bTNy3etig%2Fdevices-tab.png?alt=media&amp;token=69ef510c-4616-4f6c-bb01-eef5adc68d96" alt="Настройки устройств Plasmo Voice"><figcaption><p>Настройки микрофона и устройств воспроизведения</p></figcaption></figure>

#### Громкость (Volume)

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

Также предусмотрена возможность настраивать громкость каждого дополнения независимо от остальных.

#### Активация (Activation)

Здесь выбирается способ передачи голоса.

Доступны три режима:

* **Push-to-Talk** — микрофон передаёт голос только при удержании назначенной клавиши.
* **Voice Activation** — микрофон автоматически активируется, когда вы начинаете говорить.
* **Inherit** — использует режим активации основного голосового чата.

Для обычного общения рекомендуется Push-to-Talk, если вы не хотите постоянно передавать окружающие звуки.

<figure><img src="https://1639357051-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Md61sIy9355-Dt4QFTm%2Fuploads%2FYi7Fexoj5DPAofJvQS9d%2Factivation-tab.png?alt=media&amp;token=0170b4c7-4f59-4c71-8972-130fe9af721f" alt="Настройки активации голосового чата"><figcaption><p>Выбор режима передачи голоса и настройка клавиш</p></figcaption></figure>

#### Наложение (Overlay)

Позволяет настроить отображение элементов голосового чата:

* положение значка микрофона;
* отображение значков игроков;
* положение дополнительного интерфейса;
* внешний вид наложения;
* отображение источников звука, которые вы слышите.

Также доступно наложение в стиле Discord, показывающее игроков и источники звука, которые сейчас слышны вам.

<figure><img src="https://1639357051-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Md61sIy9355-Dt4QFTm%2Fuploads%2FFCDyBxbJccgrcFCY28xV%2Foverlay-tab.png?alt=media&amp;token=4433bc6b-0e34-42db-856c-3cb2d403ce22" alt="Настройки наложения Plasmo Voice"><figcaption><p>Настройки отображения голосового чата</p></figcaption></figure>

### Управление громкостью игроков

Вы можете индивидуально регулировать громкость конкретного игрока, не изменяя громкость остальных.

Для этого:

1. Наведитесь на нужного игрока.
2. Зажмите **ПКМ**.
3. Используйте колёсико мыши, чтобы изменить громкость его голоса.

Это удобно, если один игрок говорит слишком тихо или громко.

### Значки голосового чата

Plasmo Voice отображает специальные значки, которые помогают определить состояние голосового общения.

#### Значки игроков

<figure><img src="https://1639357051-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Md61sIy9355-Dt4QFTm%2Fuploads%2FYXkk2EfXCyq1U3NbpmX9%2Fplayer-icons.png?alt=media&amp;token=daa9aa9e-376a-4a7e-9360-055450a3453a" alt="Значки игроков Plasmo Voice"><figcaption><p>Обозначения состояний голосового чата над игроками</p></figcaption></figure>

Основные обозначения:

* **Player is Talking** — игрок сейчас говорит.
* **Client Muted** — микрофон игрока отключён на его клиенте.
* **Server Muted** — игрок отключён сервером.
* **Player Muted Audio** — игрок отключил воспроизведение голосового чата на своём клиенте.
* **No Mod Installed** — у игрока не установлен клиентский мод.

#### Значки интерфейса (HUD)

<figure><img src="https://1639357051-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Md61sIy9355-Dt4QFTm%2Fuploads%2Fqyt5IXtbwuQPh8XjsIpD%2Fhud-icons.png?alt=media&amp;token=8a6e8b2a-4256-4287-b2f0-288cf25d43db" alt="Значки HUD Plasmo Voice"><figcaption><p>Состояние микрофона и подключения в игровом интерфейсе</p></figcaption></figure>

* **You are Talking** — ваш микрофон передаёт голос.
* **Client Muted** — микрофон отключён на клиенте.
* **Server Muted** — сервер запретил передачу голоса.
* **Connection Problems** — возникли проблемы с подключением голосового чата.

***

### Голосовые группы

Помимо обычного голосового общения, на VanillaSquad доступен отдельный групповой голосовой чат благодаря дополнению **pv-addon-groups**.

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

#### Создание группы

Создать голосовую группу можно двумя способами: через графический интерфейс или команду.

**Через меню:**

1. Нажмите **V**, чтобы открыть настройки Plasmo Voice.
2. Перейдите во вкладку **Groups**.
3. Нажмите **Create**.
4. Настройте группу и подтвердите создание.

<figure><img src="https://1639357051-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Md61sIy9355-Dt4QFTm%2Fuploads%2FzAD9MZYCXVqnIO8F3gPV%2Finvites.png?alt=media&amp;token=e5076d3f-a2cf-49c5-be8a-a5093bec64c5" alt="Интерфейс голосовых групп"><figcaption><p>Просмотр доступных групп и приглашений</p></figcaption></figure>

**Через команду:**

`/groups create`

#### Приглашение игроков

Чтобы пригласить другого игрока в свою группу, используйте:

`/groups invite <ник>`

Игрок получит приглашение, которое можно принять через интерфейс голосовых групп.

#### Общение в группе

После вступления в группу необходимо настроить передачу голоса:

1. Откройте меню **V**.
2. Перейдите во вкладку **Activation**.
3. Найдите раздел **Groups**.
4. Выберите Push-to-Talk или Voice Activation.
5. Назначьте удобную клавишу.

Теперь вы сможете общаться с участниками группы через отдельный голосовой канал.

<figure><img src="https://1639357051-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Md61sIy9355-Dt4QFTm%2Fuploads%2Fltvsm603iEm2spCjtfmr%2Fgroup.png?alt=media&amp;token=7178c336-0923-4313-ad9c-c5f3c2028928" alt="Участники голосовой группы"><figcaption><p>Управление участниками и настройками голосовой группы</p></figcaption></figure>

#### Команды голосовых групп

| Команда                | Назначение                  |
| ---------------------- | --------------------------- |
| `/groups`              | Просмотр доступных групп    |
| `/groups browse`       | Просмотр публичных групп    |
| `/groups create`       | Создать группу              |
| `/groups invite <ник>` | Пригласить игрока           |
| `/groups info`         | Информация о текущей группе |
| `/groups leave`        | Покинуть группу             |
| `/groups delete`       | Удалить свою группу         |

Группы могут быть публичными или защищёнными паролем. Также предусмотрена возможность ограничивать доступ к ним.

***

### Если голосовой чат не работает

Если вы не слышите игроков или ваш микрофон не работает, проверьте несколько моментов:

1. Откройте меню Plasmo Voice клавишей **V**.
2. В разделе **Devices** убедитесь, что выбран правильный микрофон и устройство воспроизведения.
3. Проверьте, не отключён ли микрофон.
4. Убедитесь, что операционная система разрешает Minecraft использовать микрофон.
5. Проверьте, что установлена актуальная версия сборки VanillaSquad.

{% hint style="warning" %}
**Пользователям macOS**

Если используемый лаунчер не может самостоятельно запросить доступ к микрофону, Plasmo Voice использует вспомогательное приложение **Plasmo Voice Microphone**.

Разрешите этому приложению доступ к микрофону в настройках конфиденциальности macOS.
{% endhint %}

Если проблема сохраняется, обратитесь в [поддержку VanillaSquad в Discord](https://discord.com/channels/660357711174696970/918216928076632135).

***

Голосовой чат — это ещё один способ сделать общение на VanillaSquad живее. Собирайтесь с друзьями, создавайте группы и общайтесь прямо во время игры!
