Плагін Minecraft Geyser-Spigot

🔌 Про Geyser-Spigot

Geyser-Spigot — це збірка платформи Spigot/Paper для Geyser: транслятор протоколів, який дозволяє клієнтам Minecraft: Bedrock Edition підключатися до сервера Java Edition, запускаючи Geyser як плагін на стороні сервера. Він працює всередині сумісних зі Spigot серверних JAR-файлів і надає Bedrock listener, який перетворює трафік протоколу Bedrock на трафік протоколу Java для хост-сервера.

🎯 Призначення

Надавати можливість crossplay, щоб власники серверів могли приймати гравців Bedrock на сервері Java без окремого proxy-процесу. Це вирішує основну проблему несумісності протоколів між виданнями Bedrock і Java.

⚙️ Можливості

• Працює як плагін Spigot/Paper (покладіть JAR у plugins/ і перезапустіть).
• Перетворює трафік протоколу Bedrock на протокол Java, щоб клієнти Bedrock могли приєднуватися до серверів Java.
• Створює окрему конфігурацію для кожного сервера (папка плагіна та файл конфігурації створюються в plugins/Geyser-Spigot).
• Офіційно рекомендується поєднувати з Floodgate для автентифікації Bedrock, коли ви хочете, щоб гравці Bedrock приєднувалися без автентифікації через обліковий запис Java.
• Підтримується та супроводжується як частина проєкту GeyserMC (код доступний у репозиторії проєкту).

🧩 Для кого це

• Власники серверів, які хочуть crossplay Java/Bedrock на одному бекенді Spigot або Paper.
• Невеликі та великі Survival, SMP і спільнотні сервери, яким потрібна сумісність із клієнтами Bedrock.
• Адміністратори, які віддають перевагу запуску Geyser як плагіна замість окремого standalone proxy.

🏗️ Приклади використання

• Дозволити гравцям на мобільних пристроях і консолях (Bedrock) приєднуватися до сервера Spigot/Paper Java без запуску окремого proxy-сервера.
• Запустити публічний SMP-сервер, який приймає клієнтів Java і Bedrock, зберігаючи всю логіку гри на одному бекенді.

⚙️ Встановлення

📥 Налаштування

• Завантажте офіційний JAR Geyser-Spigot для платформи Spigot/Paper.
• Помістіть файл Geyser-Spigot.jar у каталог plugins/ вашого сервера.
• Запустіть або перезапустіть сервер і перевірте журнали сервера, щоб переконатися, що плагін увімкнувся і створив свою папку.

📦 Залежності

• Floodgate (необов’язково): рекомендується, коли ви хочете, щоб гравці Bedrock проходили автентифікацію/приєднувалися без автентифікації облікового запису Java; Floodgate зазначається як поширений супутній компонент для Geyser.

🧾 Конфігурація

• Geyser-Spigot створює каталог конфігурації в plugins/Geyser-Spigot і основний конфігураційний файл, де налаштовуються listener-и, параметри віддаленого сервера Java та інші опції. Відредагуйте ці файли за потреби й перезапустіть сервер, щоб застосувати зміни.

🧠 Технічні примітки

• Підтверджені підтримувані серверні платформи: Spigot і Paper.
• Задокументовано підтримку сучасних версій серверів від 1.16.5 і вище, коли використовується як плагін Spigot/Paper.
• Вихідний код і відстеження проблем підтримуються в репозиторії проєкту GeyserMC у межах репозиторію вихідного коду проєкту.
• Ліцензовано за MIT License.

🤝 Коли цей плагін корисний

Якщо вам потрібно приймати гравців Bedrock на наявному сервері Java Spigot/Paper без запуску окремого proxy-процесу, Geyser-Spigot надає підтримуваний серверний шар трансляції протоколів, який зберігає підключення Bedrock на тому ж бекенді, що й гравці Java.