Описание

Описание Server Redirect

утилитарный мод и плагин для администраторов Minecraft-серверов, которым нужно переводить игроков на другой адрес без полноценной прокси-инфраструктуры. Идея проста: сервер отправляет поддерживаемому клиенту пакет с адресом, клиент корректно отключается от текущего сервера и сам подключается к указанной цели, как если бы игрок использовал прямое подключение вручную. За счет этого можно строить переходы между отдельными серверами, не заставляя всю сеть работать только через BungeeCord, Waterfall или Velocity. Ресурс полезен там, где обычная прокси-схема создает больше проблем, чем решает. В описании отдельно упоминается ситуация с Forge-серверами 1.13+, где переключение через прокси может быть неудобным из-за особенностей модов и отсутствия привычного IP forwarding в нужном виде. Server Redirect не пытается заменить все функции прокси: он не делает общий чат, авторизацию, балансировку, список серверов или централизованные права. Его задача уже и точнее — дать командам сервера способ попросить клиента перейти на другой адрес, а также заранее указать fallback-сервер на случай принудительного отключения. Важная особенность проекта — необязательность установки. Игрок с модом может заходить на сервер без Server Redirect, а игрок без мода может оставаться на сервере, где Server Redirect установлен. Если клиент не поддерживает перенаправление, он просто не выполнит переход по transfer-пакету. Поэтому ресурс можно добавлять в модпаки или серверные сборки постепенно, не ломая вход для тех, кто еще не поставил клиентскую часть.

Что делает ресурс На практике Server Redirect дает администратору несколько командных инструментов. `/redirect` отправляет выбранных игроков на заданный адрес, `/fallback` назначает адрес, куда клиент попробует уйти при вынужденном отключении, а команды проверки позволяют запускать действия отдельно для игроков с установленным Server Redirect и без него. Источником команды может быть консоль, командный блок, игрок с правами или другой плагин, если он умеет выполнять серверные команды. Такой подход удобен для лобби, мини-игр, эвентов и модовых сеток, где серверы живут отдельно. Например, можно перевести группу игроков с подготовительного сервера на игровой, вернуть всех в запасное лобби перед перезапуском или показать подсказку тем, у кого клиентская часть отсутствует. Но адрес назначения должен быть достижим для игроков напрямую: если они не могут подключиться к этому адресу через Direct Connect, перенаправление тоже не станет магическим обходом сетевых ограничений. | Задача администратора | Команда или механизм | Что важно проверить | |---|---|---| | Перевести одного игрока | `/redirect имя адрес:порт` | Клиент игрока должен поддерживать Server Redirect, адрес должен быть доступен извне | | Перевести группу | target selector, ``, `r=N` или `s=ServerName` в зависимости от платформы | Не все типы целей работают на BungeeCord и Velocity | | Задать запасной сервер | `/fallback цель адрес:порт` | Команду обычно стоит выполнять заранее, например при входе игрока | | Реагировать на наличие мода | `/ifplayercanredirect` и `/ifplayercannotredirect` | Проверку лучше задерживать примерно на 20 тиков после входа игрока | > Server Redirect стоит воспринимать как точечный инструмент маршрутизации игроков, а не как полный заменитель прокси-сети со всеми ее дополнительными сервисами. Команды поддерживают разные форматы цели: имя или UUID конкретного игрока, стандартные селекторы Minecraft там, где они доступны, `` для всех игроков, радиусный выбор `r=N` в плагинной версии, а также `s=<ServerName>` для игроков на определенном сервере в BungeeCord и Velocity. Для команд проверки предусмотрены плейсхолдеры `%PlayerName` и `%PlayerId`, которые позволяют подставлять имя и UUID игрока в выполняемую команду.

Особенности

Работает как мод и как плагин: в метаданных указаны Forge, Fabric, Bukkit, Spigot, Sponge, BungeeCord, Waterfall и Velocity.
Установка необязательная с обеих сторон: клиенты и серверы могут подключаться в разных сочетаниях, просто функция перенаправления сработает только там, где есть поддержка.
Есть fallback-механика: игроку можно заранее назначить адрес, куда клиент перейдет при принудительном отключении от текущего сервера.
Команды рассчитаны на администрацию, консоль, командные блоки и плагины, а не на обычное использование игроками в чате.
Проверки наличия клиентской части помогают делать аккуратные сценарии: например, отправлять предупреждение игрокам без мода или запускать отдельную команду для поддерживаемых клиентов.
Гибкие варианты выбора цели позволяют работать с конкретным игроком, всеми игроками, радиусом или серверной группой там, где это поддерживает выбранная платформа. Отдельно стоит помнить о задержке при входе. Команды /ifplayercanredirect и /ifplayercannotredirect зависят от того, успел ли клиент отправить серверу пакет о наличии мода. Если выполнить проверку прямо в момент подключения, результат может быть неправильным. Исходное описание рекомендует подождать не меньше 20 тиков после входа игрока, и это лучше заложить в скрипт, командный блок или плагинную логику. Server Redirect также помогает снизить риск конфликтов с модами, которые плохо переносят скрытое переключение через прокси. Вместо того чтобы имитировать переход внутри прокси-слоя, клиент сначала отключается от текущего сервера, а затем подключается к новому адресу. Для части модовых связок это естественнее, потому что они ожидают полноценный цикл отключения и нового соединения.

Совместимость и установка Перед установкой выберите правильный файл под вашу платформу и версию Minecraft. В списке поддерживаемых версий есть как старые ветки вроде 1.7.10, 1.8.9 и 1.12.2, так и версии 1.16-1.21. При этом серверная платформа важна не меньше версии игры: файл для Fabric не заменяет Bukkit-плагин, а сборка для Velocity не является Forge-модом. Если вы ведете смешанную сеть, проверяйте каждую точку отдельно: клиентский мод, серверный мод, плагин или прокси-плагин должны соответствовать месту установки. Для Fabric или Forge мод кладется в папку `mods` соответствующего клиента или сервера. Для Bukkit/Spigot-подобных серверов используется папка `plugins`. Для BungeeCord, Waterfall и Velocity файл ставится в плагинную директорию прокси. После установки проверьте, что команда появилась и выполняется из консоли, затем протестируйте переход на тестовом игроке, прежде чем отправлять на него весь онлайн. `text Примеры административных команд: /redirect PlayerName play.example.net:25565 /fallback PlayerName lobby.example.net:25565 /redirect * event.example.net:25565 /ifplayercannotredirect * tell %PlayerName Установите Server Redirect для автоматического перехода между серверами.` Если вы используете fallback перед рискованным переходом, сначала назначьте надежный адрес, а уже потом отправляйте игрока на целевой сервер. Это полезно, когда целевой сервер может быть заполнен, выключен или временно недоступен. Если подключение к цели не получится, клиент сможет перейти к заранее заданному запасному адресу, если он поддерживает Server Redirect и получил команду fallback заранее. При работе с прокси учитывайте ограничения целей. Target selectors не доступны на BungeeCord и Velocity, зато там есть формат `s=<ServerName>` для выбора игроков на конкретном сервере. Радиус `r=N` относится к плагинной версии и зависит от контекста выполнения команды. Чем сложнее сеть, тем важнее тестировать каждую команду на небольшой группе, чтобы случайно не отправить всех игроков не туда.

Вопросы и ответы

Нужен ли Server Redirect каждому игроку?

Для обычного подключения — нет. Игрок без мода может оставаться на сервере, а игрок с модом может заходить и на серверы без него. Но автоматический переход по redirect или fallback сработает только у тех клиентов, которые поддерживают Server Redirect.

Может ли этот ресурс полностью заменить BungeeCord, Waterfall или Velocity?

Нет. Он решает другую задачу: переводит клиента на другой адрес и помогает назначать fallback. Прокси-серверы дают больше сетевых функций, но иногда конфликтуют с модовыми сборками или не подходят для конкретной архитектуры. Server Redirect можно использовать как легкую альтернативу для переходов или как дополнение к существующей схеме.

Почему проверка `/ifplayercanredirect` сработала неправильно сразу после входа?

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

Какой адрес можно указывать в `/redirect`?

Нужно указывать адрес, к которому игроки могут подключиться напрямую через Direct Connect. Если адрес закрыт сетевыми правилами, недоступен извне или требует другой порт, команда не исправит эту проблему. Сначала проверьте подключение вручную.

Что произойдет с игроками без клиентской части?

Они не будут автоматически перенаправлены transfer-пакетом и останутся на текущем сервере. Для таких игроков можно использовать /ifplayercannotredirect, чтобы вывести подсказку, выполнить отдельную команду или предложить установить нужный мод в клиентский профиль.