Настройка PlasmoVoice на Minecraft сервере - полный гайд

Голосовой чат в Minecraft - это то, что меняет атмосферу на сервере. Игроки перестают печатать в чат и начинают разговаривать. PlasmoVoice - один из лучших вариантов для этого: open-source, активно поддерживается, работает на Paper, Fabric и Forge.

В этом гайде разберем всё: от установки до тонкой настройки прав и шифрования. Если у вас уже есть работающий Minecraft сервер - можно начинать.

Что такое PlasmoVoice

PlasmoVoice - это мод для голосовой связи в Minecraft. На сервере он работает как плагин (Paper/Spigot) или мод (Fabric/Forge), а на клиенте - как мод. Голосовой трафик передается по UDP, отдельно от основного TCP-трафика игры.

Основные возможности:

Proximity chat - голос слышен только в определенном радиусе
Push-to-talk и голосовая активация
Группы и каналы для общения
Шифрование голосового трафика
Гибкая система прав через permissions

Установка на сервере

Paper / Spigot / Purpur

Скачайте последнюю версию PlasmoVoice с Modrinth или GitHub
Положите .jar файл в папку plugins/ вашего сервера
Перезапустите сервер
Проверьте, что плагин загрузился:

/plugins

В списке должен быть PlasmoVoice зеленым цветом.

Fabric

Установите Fabric Loader, если еще не стоит
Установите Fabric API
Скачайте серверную версию PlasmoVoice для Fabric
Положите .jar в папку mods/
Перезапустите сервер

Forge

Аналогично Fabric - скачайте версию для Forge, положите в mods/, перезапустите.

Настройка UDP порта

Это самый важный этап. PlasmoVoice использует UDP для передачи голоса, и по умолчанию берет тот же порт, что и сервер Minecraft. Конфиг находится в plugins/PlasmoVoice/server.yml (Paper) или config/PlasmoVoice/server.yml (Fabric):

host:
  # IP для привязки UDP сервера. 0.0.0.0 = все интерфейсы
  ip: "0.0.0.0"
  # UDP порт. 0 = тот же порт, что у Minecraft сервера
  port: 0

Если ваш Minecraft сервер работает на порту 25565, PlasmoVoice по умолчанию откроет UDP 25565. Можно указать другой порт:

host:
  ip: "0.0.0.0"
  port: 25566

Открытие порта в файрволе

Частая ошибка - забыть открыть UDP порт. TCP порт для Minecraft уже открыт, но UDP нужно разрешить отдельно:

# iptables
iptables -A INPUT -p udp --dport 25565 -j ACCEPT

# ufw
ufw allow 25565/udp

# firewalld
firewall-cmd --permanent --add-port=25565/udp
firewall-cmd --reload

Настройка клиента

Игрокам нужно установить PlasmoVoice как мод на клиент. Работает с Fabric, Forge и Quilt. После установки и подключения к серверу в настройках появится меню PlasmoVoice (обычно по кнопке V).

Основные клиентские настройки:

Микрофон - выбор устройства ввода
Громкость захвата - чувствительность микрофона
Динамик - выбор устройства вывода
Громкость воспроизведения - общая громкость голосов
Режим активации - push-to-talk или голосовая активация

Режимы активации

Push-to-Talk (PTT)

Голос передается только пока зажата кнопка. По умолчанию это Left Alt. Настраивается в клиенте. Это предпочтительный режим - нет фоновых шумов, игроки контролируют, когда их слышно.

Голосовая активация (Voice Activation)

Микрофон включается автоматически, когда уровень звука превышает порог. Удобно, но может ловить фоновые шумы. Порог активации настраивается в клиенте через ползунок.

Права и permissions

PlasmoVoice использует стандартную систему permissions. Основные ноды:

# Основные права
voice.speak - разрешение говорить
voice.listen - разрешение слышать других
voice.mute - право мьютить других игроков
voice.mutelist - просмотр списка замьюченных

# Приоритетная речь (перекрывает остальных)
voice.priority - использование приоритетного режима

# Активация
voice.activation.voice - голосовая активация
voice.activation.ptt - push-to-talk
voice.activation.inherit - наследование режима

Пример настройки через LuckPerms:

# Разрешить всем говорить и слышать
/lp group default permission set voice.speak true
/lp group default permission set voice.listen true

# Дать модераторам право мьютить
/lp group moderator permission set voice.mute true

# Приоритетная речь только для админов
/lp group admin permission set voice.priority true

Proximity Chat

Proximity chat - ключевая фишка PlasmoVoice. Голос слышен только в определенном радиусе от игрока. Чем дальше - тем тише. Настройки в server.yml:

voice:
  # Дистанции proximity chat (в блоках)
  proximity:
    distances:
      - 8    # шепот
      - 16   # обычный разговор
      - 32   # крик
    default_distance: 16

Игроки переключают дистанцию кнопкой (по умолчанию - скролл колеса мыши в меню PlasmoVoice).

Группы и каналы

PlasmoVoice поддерживает аддоны для расширения функционала. С помощью pv-addon-groups можно создавать отдельные голосовые каналы:

Группы для кланов или команд
Отдельные каналы по ролям (стафф-чат, гильдии)
Возможность говорить одновременно в proximity и в группе

Шифрование

PlasmoVoice шифрует голосовой трафик по умолчанию с помощью AES. Это важно для приватности - никто не сможет перехватить разговоры, даже имея доступ к сетевому трафику. Настройки шифрования в server.yml:

voice:
  # Шифрование AES
  aes_encryption_key: ""  # Оставьте пустым для автогенерации

Ключ генерируется автоматически при первом запуске. Менять его вручную не нужно.

PlasmoVoice vs Simple Voice Chat

Оба мода решают одну задачу, но есть различия:

Параметр	PlasmoVoice	Simple Voice Chat
Платформы	Paper, Fabric, Forge, Quilt	Paper, Fabric, Forge, Quilt
Шифрование	AES (по умолчанию)	Нет
API для аддонов	Да, развитое API	Ограниченное
Proximity chat	Несколько дистанций	Одна фиксированная
Приоритетная речь	Есть	Нет
Производительность	Хорошая	Хорошая
Документация	Подробная	Базовая

PlasmoVoice выигрывает по функционалу: шифрование из коробки, гибкие дистанции, приоритетная речь, лучшее API для разработчиков аддонов. Simple Voice Chat проще в базовой настройке, но ограничен в возможностях.

Защита голосового трафика через MineGuard

Отдельная тема - защита UDP трафика PlasmoVoice от DDoS. Стандартная DDoS-защита фильтрует только TCP (игровой трафик Minecraft), а UDP порт голосового чата остается открытым для атак.

MineGuard решает эту проблему. В панели управления можно включить поддержку PlasmoVoice, и MineGuard начнет проксировать не только TCP, но и UDP трафик голосового чата через фильтр. Для игроков ничего не меняется - подключение к серверу работает как раньше, но теперь и игровой, и голосовой трафик защищены от атак.

Настройка занимает пару минут: включаете PlasmoVoice в панели MineGuard, указываете UDP порт, и готово. Фильтр автоматически начинает обрабатывать голосовой трафик.

Частые проблемы и решения

Игроки не слышат друг друга

Проверьте, что UDP порт открыт в файрволе
Убедитесь, что клиент-мод установлен у обоих игроков
Проверьте permissions - нужны voice.speak и voice.listen
Посмотрите лог сервера на ошибки PlasmoVoice

"Voice chat is not available" на клиенте

Обычно это значит, что клиент не может подключиться к UDP серверу. Причины:

UDP порт заблокирован файрволом на сервере
NAT не пропускает UDP пакеты
Хостинг блокирует нестандартные UDP порты

Решение - проверьте порт утилитой:

# На сервере - слушает ли PlasmoVoice
ss -ulnp | grep 25565

# С клиента - доходят ли пакеты
nmap -sU -p 25565 your-server-ip

Высокий пинг в голосовом чате

Убедитесь, что UDP трафик не идет через VPN или прокси с высокой задержкой
Проверьте, нет ли потери пакетов: mtr -u your-server-ip
Если сервер за DDoS-защитой - убедитесь, что она поддерживает проксирование UDP (MineGuard поддерживает это из коробки)

Конфликт портов

Если на сервере несколько Minecraft серверов, каждому PlasmoVoice нужен свой UDP порт. Не оставляйте port: 0 - задайте уникальные порты вручную:

# Сервер 1 (порт 25565)
host:
  port: 25565

# Сервер 2 (порт 25566)
host:
  port: 25566

PlasmoVoice не запускается на Fabric

Проверьте совместимость версий:

Fabric Loader должен быть актуальной версии
Fabric API обязательно должен быть установлен
Версия PlasmoVoice должна соответствовать версии Minecraft

Как настроить PlasmoVoice на Minecraft сервере