Как настроить PlasmoVoice на сервере через туннель

PlasmoVoice добавляет в Minecraft голосовой чат с привязкой к расстоянию: слышно того, кто рядом. Сложность в том, что голос идёт не через порт игры, а отдельным UDP-потоком, и клиенту нужно сказать, по какому публичному адресу до него достучаться. Разберём, как настроить PlasmoVoice через туннель — без белого IP и проброса портов.

Почему одного туннеля не хватит

У сервера два независимых канала:

Канал	Протокол	Локальный порт
Игра	TCP	25565
Голос PlasmoVoice	UDP	свой, например 25566

Игра и голос — разные протоколы, значит и туннеля нужно два. В конфиге плагина по умолчанию стоит port = 0, то есть «тот же порт, что у Minecraft-сервера». Через туннель так не выйдет: туннель пробрасывает конкретный порт конкретного протокола, поэтому голосу нужно выдать свой явный порт.

Второй момент: плагин должен сообщить клиентам публичный адрес голосового сервера. Сам он его не знает — снаружи это адрес туннеля, а не твоей машины. Для этого в конфиге есть блок [host.public].

Что понадобится

• Сервер на ядре с поддержкой плагинов — Paper, Purpur или Spigot.
• Плагин PlasmoVoice на сервере.
• Мод PlasmoVoice у каждого игрока. Без клиентского мода голос не заработает — это не серверная фича, которая включается сама.
• ProximaClient и аккаунт ProximaMP.

Шаг 1. Сервер и туннель для игры

Если сервера ещё нет — создай его в ProximaClient на ядре Paper или Purpur и сразу включи переключатель «Создать публичный туннель для сервера»: TCP-туннель на 25565 поднимется автоматически. Пошагово — в гайде как создать игровой сервер.

Сервер уже есть без туннеля — не беда, TCP-туннель на 25565 можно создать вручную: как открыть TCP-порт через туннель.

Шаг 2. Поставь плагин PlasmoVoice

Скачай сборку под своё ядро со страницы Plasmo Voice на Modrinth и положи .jar в папку plugins/ сервера. Подробнее про установку — как установить плагины.

Шаг 3. Перезапусти сервер

Это обязательный шаг: при первом запуске плагин создаёт свои конфиги. До перезапуска папки plugins/PlasmoVoice/ просто не существует, и править будет нечего.

После запуска в ней появится config.toml — с ним и будем работать.

Шаг 4. Открой UDP-туннель для голоса

Перейди на экран «Туннели» (первая иконка в левом меню) и нажми +:

• Название — например «PlasmoVoice».
• Протокол — UDP. Голос идёт только по UDP, с TCP он не заработает.
• Локальный порт — 25566. Подойдёт любой свободный порт, главное — не занимать 25565, на нём игра.
• Локация — «Авто».

Жми «Создать туннель» и посмотри в карточке блок «Ваш адрес · UDP» — там будет что-то вроде archi.proximamp.com:30335. Запиши обе части: хост и порт — они сейчас пойдут в конфиг.

На скриншоте видно оба туннеля: игровой plasmotest на TCP и голосовой на UDP. Игровой здесь в состоянии «Резерв» — сервер выключен, но адрес ещё держится за владельцем.

Шаг 5. Пропиши порт в блоке [host]

Открой файл plugins/PlasmoVoice/config.toml. Редактировать его можно прямо в ProximaClient — на странице сервера есть вкладка с файлами, где лежит дерево папок и встроенный редактор с кнопкой сохранения.

Найди блок [host] и поставь локальный порт — тот самый, который открывал туннелем:

[host]
# IP address for the voice server to bind to
# 0.0.0.0 = bind to all available interfaces
ip = "0.0.0.0"
# UDP port for the voice server
# 0 = same port as Minecraft server
port = 25566

ip = "0.0.0.0" оставь как есть — это адрес, на котором голосовой сервер слушает у тебя на машине.

Шаг 6. Раскомментируй [host.public]

Ниже идёт блок [host.public] — по умолчанию он закомментирован. Убери # в начале его строк и впиши адрес туннеля из шага 4:

[host.public]
ip = "archi.proximamp.com"
port = 30335

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

Блок	Что означает	Откуда брать
[host]	где голосовой сервер слушает локально	порт, который ты открыл туннелем (25566)
[host.public]	куда подключаются игроки	адрес из карточки туннеля (archi.proximamp.com:30335)

Номера в них не совпадают — и так и должно быть: внешний порт туннеля назначается автоматически и почти никогда не равен локальному.

Сохрани файл.

Шаг 7. Перезапусти сервер ещё раз

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

Если голос не работает

• У игрока нет клиентского мода. Самая частая причина. PlasmoVoice нужен с обеих сторон.
• Туннель создан TCP вместо UDP. Проверь бейдж протокола у туннеля в списке.
• Порты перепутаны местами. В [host] — локальный (25566), в [host.public] — внешний из туннеля (30335). Наоборот работать не будет.
• [host.public] остался закомментированным. Тогда плагин отдаёт клиентам локальный адрес, и снаружи до него не достучаться.
• Сервер не перезапускали после правки. Конфиг подхватывается только при старте.
• В [host] остался port = 0. Это значит «порт Minecraft-сервера», через туннель такой вариант не работает — нужен явный порт.
• Порт 25566 занят другой программой. Тогда голосовой сервер не поднимется — разбор в статье Ошибка «Failed to bind to port».

Частые вопросы

Сколько туннелей нужно? Два: TCP для игры и UDP для голоса. Каждый занимает свой слот в лимите тарифа — счётчик в шапке экрана «Туннели», условия на странице ProximaTunnel.

Можно ли взять любой порт вместо 25566? Да, любой свободный. Главное — одно и то же число в [host] и в поле «Локальный порт» туннеля.

Почему в [host.public] порт другой? Это внешний порт туннеля, он выдаётся автоматически. Локальный и внешний порты совпадать не обязаны.

Адрес туннеля поменялся — что делать? Вписать новый в [host.public] и перезапустить сервер. Чтобы адрес не менялся, внешний порт можно закрепить — блок «Свой публичный порт» в окне создания туннеля.

Нужен ли игрокам ProximaClient? Нет. Им нужен только мод PlasmoVoice и адрес сервера.

Подними голосовой чат

Скачать ProximaClient для Windows → — стартовый тариф бесплатный, оба туннеля поднимаются за пару минут.

Ещё по теме: как открыть UDP-порт через туннель · как установить плагины · как открыть локальный порт в интернет