🧭 VelocityConnect

VelocityConnect — это лёгкий плагин для Velocity Proxy (Minecraft 1.21.8),
который позволяет подключать игроков к нужным серверам через плагиновые сообщения.

⚙️ Основная идея

Плагин прослушивает плагиновый канал velocity:player и обрабатывает сообщения формата:

subChannel: Connect
serverName: <имя_сервера>

После получения команды Connect, плагин автоматически подключает игрока к указанному серверу,
если сервер существует и игрок ещё не находится на нём.

---

🚀 Установка

1. Скачайте последний релиз из раздела Releases
2. и поместите файл VelocityConnect.jar в папку plugins/ вашего прокси.
3. После перезапуска Velocity плагин будет активен.

После запуска вы увидите в консоли сообщение:

VelocityConnect плагин включен и прослушивает канал: velocity:player

---

🧩 Использование

Со стороны любого backend-сервера (например, Paper, Spigot и т.п.)
нужно отправить плагиновое сообщение на канал velocity:player с содержимым:

Поле	Тип	Пример
subChannel	String	Connect
serverName	String	lobby

Пример на стороне Spigot (отправка команды на переключение):

ByteArrayOutputStream outBytes = new ByteArrayOutputStream();
DataOutputStream out = new DataOutputStream(outBytes);

out.writeUTF("Connect");
out.writeUTF("lobby");

player.sendPluginMessage(plugin, "velocity:player", outBytes.toByteArray());

💡 Важно: убедись, что канал velocity:player зарегистрирован на стороне сервера,
и что у игрока есть активное подключение через Velocity.

---

📜 Логика работы

• При инициализации VelocityConnect регистрирует канал velocity:player.
• При получении сообщения PluginMessageEvent с подканалом Connect,
  плагин:
  1. Проверяет, существует ли указанный сервер в конфигурации Velocity.
  2. Проверяет, не находится ли игрок уже на этом сервере.
  3. Подключает игрока и логирует результат в консоль.
  4. В случае ошибки — уведомляет игрока в чате.

---

🧰 Требования

• Velocity 1.21.8
• Java 21
• Любой сервер, поддерживающий Plugin Messaging API (Spigot/Paper, Folia и т.п.)

---

🪵 Пример логов

[INFO] VelocityConnect плагин включен и прослушивает канал: velocity:player
[INFO] Подключаем игрока Steve к серверу lobby
[INFO] Игрок Steve успешно подключен к серверу lobby

---

💬 Ошибки и уведомления

Ситуация	Сообщение игроку
Сервер не найден	Сервер <имя> не найден или недоступен!
Игрок уже на сервере	Вы уже находитесь на этом сервере!
Ошибка подключения	Ошибка подключения к серверу: <текст>

---

📄 Лицензия

Этот проект распространяется под лицензией MIT.
Свободно используйте, модифицируйте и интегрируйте в свои проекты.