Minecraft plugin floodgate

🔌 Про плагін Floodgate

Floodgate — це плагін для Minecraft серверів, який дозволяє Bedrock‑гравцям приєднуватися до Java‑серверів через Geyser, обробляючи автентифікацію та ідентифікацію користувачів без необхідності Java‑акаунта. Floodgate працює як доповнення до Geyser і не замінює його.

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

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

⚙ Основні можливості

• Дозволяє Bedrock‑гравцям підключатися до Java серверів (cross‑play). ()
• Інтеграція з Geyser: працює разом із Geyser (плагін або standalone). ()
• Генерація ключа (key.pem) та конфігурації (config.yml) для налаштування безпечної автентифікації Bedrock‑гравців. ()
• Параметр префікса імен користувачів (username‑prefix) для розрізнення Bedrock/Java гравців; можливість змінити або відключити префікс. ()
• Floodgate API / розширюваність (розробникам доступний Floodgate API). ()

🧩 Кому підійде

Floodgate підходить для адміністраторів і власників серверів, які хочуть увімкнути cross‑play між Bedrock і Java без примусового створення Java‑акаунтів. Підходить для Paper/Paper‑forks, Spigot, BungeeCord/Waterfall та Velocity середовищ, коли використовується Geyser. ()

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

• Додати Floodgate на проксі (Bungee/Velocity) і копіювати згенерований key.pem на бекенд‑сервери для безпечної автентифікації Bedrock гравців. ()
• Налаштувати Geyser config auth-type на floodgate і дозволити Bedrock гравцям приєднуватися без Java‑логіну. ()
• Використовувати Floodgate API у плагінах для визначення, чи гравець підключений з Bedrock клієнта (для окремих налаштувань прав або UI). ()

⚡ Особливості

• Floodgate не замінює Geyser; він працює у парі з Geyser. ()
• Floodgate підтримує кілька платформ: Spigot/Paper (floodgate‑spigot.jar), proxy‑варіанти (floodgate‑bungee.jar, floodgate‑velocity.jar) та інші збірки. ()

⌨️ Команди

Інформація про інші плагінні команди та їхні дозволи є в офіційній документації Floodgate / Geyser. Якщо команда відсутня у списку — інформація відсутня в офіційних джерелах, наведені переклади команд наведені лише за підтвердженими даними. ()

🔐 Права доступу (permissions)

Floodgate використовує окремі permission‑вузли для своїх команд; повний перелік permission‑вузлів наведено в офіційній документації Floodgate. Інформація про інші permission‑вузли відсутня у перевірених джерелах, тому в таблиці наведено лише підтверджений вузол. ()

⚙ Інсталяція

📥 Встановлення

• Завантажте відповідний .jar для вашої платформи (floodgate‑spigot.jar / floodgate‑bungee.jar / floodgate‑velocity.jar) з офіційного каналу розповсюдження. ()
• Помістіть .jar у папку plugins/ на відповідному сервері (фронтенді або бекенді залежно від установки). ()
• Запустіть або перезапустіть сервер (повний рестарт; не рекомендується використовувати /reload). ()
• Після першого запуску Floodgate згенерує config.yml та key.pem (ключ доступу). Скопіюйте key.pem на інші сервери, які повинні приймати Bedrock з'єднання, якщо встановлено на проксі‑інфраструктурі. ()

📦 Залежності

• Обов'язкова залежність: Geyser (Floodgate працює як доповнення до Geyser; не замінює його). ()
• PlaceholderAPI: опціонально для placeholder‑підтримки (як згадано у документації для Bukkit версії). ()
• Інші загальні плагіни (Vault тощо) — не обов'язкові для Floodgate; Floodgate не оголошує залежність від Vault у офіційних джерелах. Якщо плагін використовує інтеграції сторонніх плагінів, вказано це у їхній документації. ()

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

• Floodgate генерує config.yml і key.pem після першого запуску. Параметри конфігурації включають username-prefix, send-floodgate-data (для proxy/standalone) та інші опції, які описані в офіційній документації. ()
• Не потребує зовнішньої бази даних за замовчуванням (немає підтверджених офіційних вимог до MySQL/SQLite для базових функцій). Якщо якийсь додатковий плагін вимагає БД, це зазначається в його документації. (Інформація про налаштування БД для Floodgate відсутня в офіційних джерелах). ()

🧠 Додаткова інформація

Відомі конфлікти

• Деякі плагіни, які змінюють UUID або імена користувачів, можуть порушити роботу Floodgate (можливі конфлікти з плагінами, що змінюють автентифікацію або UUID). Рекомендується тестувати у staging‑середовищі. ()
• Потрібно обережно поводитись із key.pem: цей ключ дозволяє обходити Java‑auth для Bedrock користувачів; не розповсюджуйте його. ()

Обмеження

• Floodgate не замінює Geyser; працює лише разом із Geyser (плагін або standalone). ()
• Floodgate 2.0 несумісний з 1.0 — для переміщення між версіями потрібна міграція конфігів, що описана в офіційній документації. ()

FAQ

1. Чи потрібен гравцям Java‑акаунт для підключення через Floodgate? Ні — Floodgate дозволяє Bedrock‑гравцям підключатися без Java‑акаунта, якщо встановлено та налаштовано належним чином разом із Geyser. ()

2. Де ставити key.pem при використанні проксі? Key.pem повинен бути встановлений на proxy‑сервері (Bungee/Velocity) і скопійований на бекенд‑сервери, якщо вказано в інструкції. Захищайте цей файл. ()

3. Чи є підтримка PlaceholderAPI? Так — для Bukkit/Spigot версії можна використовувати Placeholder плагін разом із PlaceholderAPI; див. офіційну секцію документації. ()

4. Чи збирає Floodgate статистику (bStats)? Інформація про використання bStats або іншої телеметрії не знайдена в основних офіційних джерелах Floodgate/Geyser; офіційні сторінки не підтверджують наявність bStats. (Інформація відсутня в офіційних джерелах). ()

5. Де отримати підтримку? Офіційна документація Floodgate/Geyser та їхня спільнота (офіційні канали підтримки) згадані у репозиторії та документації проекту. Для технічної підтримки рекомендується звертатися до офіційної документації або спільноти GeyserMC. ()

Примітка: У цьому описі наведено лише перевірену інформацію з офіційного репозиторію та документації Floodgate / Geyser. Якщо якась секція здається неповною — відповідні дані відсутні в офіційних джерелах на момент перевірки. ()