velocit - плагин playit.gg для Velocity

velocit - небольшой плагин под Velocity, который избавляет админов от возни с пробросом портов. Он цепляет ваш Minecraft-сервер к туннельной сети playit.gg, и игроки подключаются через внешний адрес этого сервиса. По сути это мост между вашей прокси и туннелем.

Если вы когда-нибудь пытались поднять домашний сервер, но роутер не отдавал порт, а провайдер прятал вас за CGNAT - вы знаете, как это бесит. Тут ровно та же история решается в пару шагов. Скачали jar, закинули в папку plugins, запустили - и прокси сам предложит связаться с аккаунтом playit.gg по ссылке в консоли.

Зачем это вообще нужно

Velocity - это прокси для Майнкрафт, через который удобно держать сразу несколько серверов (лobby, выживание, минигеймы) и перекидывать игроков между ними без перезаходов. Но чтобы прокси работал, ему самому нужен публичный адрес. Вот тут и включается velocit: он открывает TCP-порт Velocity наружу через туннель playit.gg, а не напрямую.

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

Что поддерживается

Функция	Описание	Статус
Minecraft TCP	TCP-порт для Velocity	Да
UDP-порты	UDP (для Geyser и подобного)	Нет
Дополнительные TCP	Любые доп. TCP-порты для проброса	Да
IP Forwarding	Реальный IP-адрес клиента	Нет

Практически любой TCP-трафик сейчас уходит через плагин нормально. А вот всё, что живёт на UDP, - мимо. И это важный нюанс: если у вас стоит Geyser для Bedrock-игроков, он работать через velocit не будет, потому что там нужен именно UDP. То же самое с реальным IP клиентов - IP forwarding не поддерживается. Значит, в логах и плагинах вроде античитов или бан-систем вы увидите адрес туннеля, а не игрока. Некоторые админы обходят это сторонними прослойками на самом Velocity, но из коробки такого нет.

Всё из таблицы в планах, так что UDP и IP forwarding со временем могут подвезти.

Как подключить

1. Поднимите Velocity-сервер (прокси на Java Edition).
2. Установите последний релиз плагина в папку plugins.
3. Запустите прокси и кликните по ссылке в консоли, чтобы связать аккаунт playit.gg с сервером.
4. Готово - сервер доступен по адресу playit.gg.

Шагов немного, но именно третий пункт многие пропускают и потом удивляются, что адрес не выдался. Ссылка одноразовая и живёт ограниченное время, так что лучше не тянуть с привязкой.

Важно знать

Последний релиз на Modrinth - это 1.0-pre в статусе Alpha, то есть самый первый публичный билд. Автор прямо предупреждает о нестабильности. На продакшене в большой сети лучше сначала протестировать на отдельном сервере, потому что альфа может уронить прокси при обновлении playit-сессии.

Совместимость по версиям широкая: Java Edition от 1.7 до 1.21-1.21.1. Работает как платформенный плагин именно под Velocity, на Paper или Fabric это не поставить. Загрузчиков типа Forge или NeoForge тут нет - только Velocity.

Размер проекта скромный: около 1,3 тыс. загрузок и 8 подписчиков на Modrinth, обновлялся примерно два года назад. Это скорее аккуратная утилита, чем живой активный мод. Если вам нужен стабильный туннель с поддержкой UDP и реальных IP - смотрите в сторону платных вариантов или собственного VPS с ngrok-подобными решениями.

Сборка из исходников

Если хочется покопаться в коде или собрать свою версию:

1. Клонируйте репозиторий.
2. Откройте проект в любимой Java IDE.
3. Обновите Maven-зависимости.
4. Выполните mvn install.

Проект распространяется под лицензией MIT, так что форкать и допиливать можно свободно. Для владельцев Velocity-сетей, которые ищут простой способ публикации без проброса портов, velocit - рабочий вариант, если готовы мириться с альфа-статусом и отсутствием UDP. А если поднимаете целую сеть серверов на прокси - держите в уме BungeeHost, там подобные штуки ставятся в пару кликов.