Minecraft plugin Geyser-Spigot

🔌 Про плагін Geyser-Spigot

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

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

Geyser-Spigot вирішує проблему сумісності між Bedrock і Java клієнтами: він перекладає мережеві пакети Bedrock у формат, який приймає Java‑сервер, і навпаки. Плагін потрібен, коли власник Java сервера хоче дозволити мобільним/консолям/Win10 Bedrock гравцям приєднатися без запуску окремого проксі‑сервера.

• Підтримує пряме підключення Bedrock клієнтів до Spigot/Paper серверів.
• Дозволяє зберегти існуючий Java‑сервер та додати Bedrock‑підтримку без міграції.

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

• Реалізація мережного перекладу Bedrock ↔ Java (протокол/пакети).
• Підтримка Geyser extensions (розширення) та команд.
• Інтеграція з Floodgate для дозволу Bedrock гравців без Java/Майн акаунту (опціонально).
• Налаштування портів Bedrock (звичайний порт 19132) та поведінки автентифікації через config.yml.
• Команди адміністратора для діагностики, списку підключених гравців, дампів відлагодження та перезавантаження конфігурації.

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

Geyser-Spigot підходить для:

• Власників Java (Spigot/Paper) серверів, що хочуть дозволити Bedrock клієнтам приєднуватися.
• Мереж, де бажано тримати логіку без окремого standalone‑проксі.
• Серверів, які хочуть просту інтеграцію без складного проксі‑шарa.

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

• Додавання підтримки мобільних/консольних гравців на існуючий Survival сервер.
• Приймання Bedrock гравців у мережі minigames і не змінюючи Java‑серверну інфраструктуру.
• Використання Floodgate разом із Geyser‑Spigot, щоб Bedrock гравці могли заходити без Mojang/Java акаунту.

⌨️ Команди

Примітка: список команд і permissions підтверджений у офіційній документації Geyser. Якщо Geyser запущено як Spigot‑плагін, ці команди реєструються локально. (Джерело: офіційна документація команд).

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

Примітка: офіційна документація перераховує вузли permissions; явні значення Default (true/op/false) для кожного вузла не наведені у відкритих документах, тому тут вони позначені як відсутні. Рекомендується призначати права через плагіни типу LuckPerms. ()

⚙ Інсталяція

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

• Завантажте Geyser‑Spigot .jar з офіційного джерела (офіційний сайт / сторінка завантаження).
• Помістіть JAR у папку plugins/ вашого Spigot/Paper сервера.
• Перезапустіть сервер повністю (не використовуйте внутрішній /reload).
• Після першого запуску зʼявиться папка plugins/Geyser-Spigot/ та config.yml. ()

📦 Залежності

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

Примітка: Geyser‑Spigot працює як плагін Spigot/Paper; додаткові залежності (Vault/PlaceholderAPI тощо) не є обовʼязковими для базової роботи. Інші плагіни можуть знадобитися в залежності від вашого набору функцій. ()

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

• Після першого запуску Geyser‑Spigot створює plugins/Geyser-Spigot/config.yml.
• У config.yml налаштовуються: секція bedrock (порт, адреса), метод автентифікації (online/offline/floodgate), resource‑packs (папка packs) та інші опції.
• Geyser‑Spigot не потребує бази даних для базової роботи — в офіційній документації немає згадки про MySQL/SQLite як необхідні для роботи плагіна. ()

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

Відомі конфлікти / обмеження

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

FAQ

Q1: Чи працює Geyser‑Spigot на Paper?
A1: Так — Geyser‑Spigot працює на Spigot, Paper та їхніх форках (Paper рекомендовано). ()

Q2: Чи потрібен Floodgate?
A2: Floodgate не є обовʼязковим, але потрібен якщо ви хочете дозволити Bedrock гравцям входити без Java/Mojang акаунтів. ()

Q3: Які версії Minecraft підтримуються?
A3: Офіційна сторінка підтримки/версій надає поточну інформацію; як плагін для Spigot/Paper Geyser‑Spigot зазвичай працює на сучасних серверах (див. розділ Supported Versions у документації). На момент останнього оновлення офіційних ресурсів Geyser рекомендує запуск на серверах з підтримкою відповідних версій Java і зазначає мінімальні вимоги/рекомендації у документації. ()

Q4: Чи збирає Geyser статистику (bStats)?
A4: Інформація про використання bStats не однозначно вказана у основних документах, тому офіційна документація не підтверджує наявність або відсутність bStats у Geyser‑Spigot. (Інформація відсутня в офіційних джерелах, перевірте release notes або репозиторій плагіна для деталізації). ()

Підтримка Discord

Geyser має офіційний Discord для підтримки спільноти та перекладів; посилання на Discord вказано у репозиторії і документації проекту. ()

Коли використовувати Geyser‑Spigot

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

(Джерела: офіційна документація Geyser — сторінки команд та підтримуваних версій, GitHub репозиторій та FAQ). ()