Установка сервера Minecraft с Geyser (Java и Bedrock) в панели Pterodactyl
Инструкция, как установить и запустить сервер Minecraft с Geyser (Java и Bedrock) в панели управления Pterodactyl. Сама панель уже должна быть установлена — это описано в статье Как установить и настроить панель управления игровым сервером Pterodactyl. Все снимки экрана сняты с настоящей панели: инструкция проверена 19 ноября 2026 года на Pterodactyl 1.15.2 и Wings 1.13.5 с сервером Purpur 26.3, Geyser 2.12.1 и Floodgate 2.2.5.
Этот шаблон ставит сервер Minecraft Java Edition, на который могут заходить и игроки Bedrock Edition — с телефонов, планшетов и из версии для Windows. Сервер — Purpur, а с ним сразу два плагина: Geyser переводит соединение Bedrock на язык сервера Java, а Floodgate пускает игроков Bedrock по их учётной записи Xbox, без покупки Java Edition. Мир, плагины и настройки — как у обычного сервера Java.
Что понадобится
- VDS с установленной панелью Pterodactyl и узлом Wings; вход в панель под учётной записью администратора.
- Память: пустой сервер занимает около 1,2 ГБ; с игроками и дополнениями — больше. Серверу в панели отведите от 4 ГБ; если панель стоит на том же VDS, берите VDS от 8 ГБ.
- Диск: сервер с новым миром занимает около 290 МБ, образ Docker с Java — около 1 ГБ. Серверу в панели отведите 10 ГБ: мир растёт по мере того, как игроки его исследуют.
Подобрать сервер можно на странице тарифов VDS.
1. Добавьте шаблон игры
Игру в Pterodactyl описывает шаблон — «яйцо» (egg): в нём записано, какой образ Docker использовать, как скачать сервер и какой командой его запустить. Шаблона Minecraft с Geyser (Java и Bedrock) в панели изначально нет — его берут из общего хранилища шаблонов, которое ведёт сообщество.
1. Скачайте файл шаблона на свой компьютер: откройте ссылку egg-pterodactyl-purpur--geyser--floodgate.json и сохраните страницу (Ctrl+S) под именем egg-pterodactyl-purpur--geyser--floodgate.json. Нужен именно файл со словом pterodactyl в имени: соседний файл без него предназначен для другой панели и в Pterodactyl не загрузится.
2. В панели перейдите в раздел администратора (значок с шестерёнками справа вверху) и откройте Nests. Гнездо (nest) — это папка для шаблонов; новый шаблон положим в гнездо Minecraft — оно есть в панели изначально.
3. Нажмите Import Egg. В поле «Egg File» выберите скачанный файл, в поле «Associated Nest» — гнездо Minecraft и нажмите Import:
Панель откроет страницу шаблона с сообщением «Successfully imported this Egg and its associated variables».
2. Выделите порты
Адрес и порты сервер получает из списка «выделений» (allocations) узла. Серверу Minecraft с Geyser (Java и Bedrock) нужны порты:
| Порт | Протокол | Зачем |
|---|---|---|
| 25565 | TCP | Игроки Java Edition |
| 19132 | TCP и UDP | Игроки Bedrock Edition — на этом порту слушает Geyser. Панель открывает выделенный порт сразу для обоих протоколов |
1. Откройте Nodes, щёлкните по своему узлу и перейдите на вкладку Allocation.
2. В блоке «Assign New Allocations» в поле «IP Address» выберите IP-адрес VDS, а в поле «Ports» введите 25565 и 19132 — после каждого номера нажимайте Enter. Нажмите Submit:
IP-адрес на снимках заменён примером.
3. Создайте сервер
1. Откройте Servers и нажмите Create New.
2. Заполните верхнюю часть формы:
- Server Name — название сервера в панели; игроки его не видят;
- Server Owner — начните вводить почту своей учётной записи и выберите её из списка;
- Node — ваш узел, Default Allocation — порт
25565, в поле Additional Allocation(s) —19132; - Memory —
4096(в мегабайтах), Disk Space —10000, Swap —0, CPU Limit —0, то есть без ограничения.
3. В блоке «Nest Configuration» выберите гнездо Minecraft и шаблон Purpur-Geyser-Floodgate. Образ Docker и команда запуска подставятся сами, менять их не нужно:
4. В блоке «Service Variables» задайте настройки игры. Что стоит изменить:
| Поле | Что вписать |
|---|---|
| Docker Image (блок «Docker Configuration») | Выберите Java 25 — в списке образов этого шаблона первой стоит Java 8. С Java 25 проверен Purpur 26.3 с Geyser 2.12.1. Старым версиям игры нужна своя Java: 1.20.5–1.21.x — Java 21, 1.18–1.20.4 — Java 17, 1.17 — Java 16, 1.16.5 и старше — Java 8 |
| Minecraft Version | latest — последняя версия игры; чтобы поставить конкретную, впишите её номер, например 1.21.4
|
| Build Number | Номер сборки Purpur. latest — самая свежая для выбранной версии
|
| Server Jar File | Имя файла сервера. Оставьте server.jar
|
Остальные поля можно оставить как есть.
5. Нажмите Create Server внизу страницы.
4. Дождитесь установки
Панель создаст сервер, а Wings начнёт установку: скачает образ Docker и файлы игры. Установка занимает меньше минуты: скачиваются файл сервера и два плагина.
Выйдите из раздела администратора (значок выхода справа вверху) и щёлкните по серверу в списке — откроется его страница с консолью.
5. Запустите сервер
Когда установка закончится, сервер запустится сам: в форме создания была отмечена настройка «Start Server when Installed». Если вы её сняли, нажмите Start.
Лицензия Minecraft. Первый запуск сразу остановится: сервер Minecraft не работает, пока не принято лицензионное соглашение Mojang (EULA). Панель покажет окно «Accept Minecraft® EULA». Прочитайте соглашение по ссылке в окне и нажмите I Accept — панель сама запишет согласие в файл eula.txt и запустит сервер заново:
Если окно не появилось, нажмите Start ещё раз.
Сервер создаст мир и запустится. Он готов, когда в консоли появилась строка «Done (…)! For help, type "help"» — при проверке это заняло около 40 секунд:
Перед ней в консоли есть строка плагина «[Geyser-Spigot] Done (…)! Run /geyser help for help!» — значит, вход для игроков Bedrock тоже открыт.
Кнопки Restart и Stop перезапускают и останавливают сервер; при остановке панель посылает ему штатную команду завершения, и он успевает сохранить мир. Команды сервера вводят в строку под консолью.
6. Откройте порты в файрволе
Если на VDS включён файрвол ufw, разрешите порты сервера. Выполните на VDS:
sudo ufw allow 25565/tcp sudo ufw allow 19132/tcp sudo ufw allow 19132/udp
Проверить, включён ли файрвол, можно командой sudo ufw status: ответ «Status: inactive» означает, что он выключен и порты открывать не нужно.
При проверке сервер, созданный в панели, ответил на запрос снаружи, с другого компьютера: на порту 25565 — Purpur 26.3, 0 из 20 игроков; порт 19132, на котором слушает Geyser, тоже отвечал.
7. Зайдите на сервер
Игроки Java Edition заходят как обычно: «Сетевая игра» → «Добавить сервер» → IP_СЕРВЕРА:25565.
Игроки Bedrock Edition в игре на телефоне, планшете или Windows нажимают «Играть», открывают вкладку «Серверы», выбирают внизу списка «Добавить сервер» и вводят адрес — IP-адрес VDS — и порт 19132. Нужна только учётная запись Xbox, в которую игрок вошёл в игре. На консолях (Xbox, PlayStation, Nintendo Switch) кнопки добавления своего сервера в игре нет.
Имена игроков Bedrock на сервере начинаются с точки — например, .Steve: так Floodgate отличает их от игроков Java с тем же ником. С точкой имя пишут и в командах: op .Steve. Чтобы выдать права оператора игроку Java, введите в строке под консолью op НИК.
Настройки после установки
Всё, что вы задали в блоке «Service Variables», можно изменить позже — на вкладке Startup страницы сервера. Изменения вступают в силу после перезапуска сервера кнопкой Restart.
Настройки игры лежат в файле server.properties. На вкладке Files щёлкните по нему — файл откроется во встроенном редакторе. Измените нужные строки — например, motd (описание в списке серверов), max-players (число игроков), difficulty (сложность) — и нажмите Save Content, затем перезапустите сервер.
Память серверу задаётся не в файлах, а в панели: Java получает 95 % от значения Memory, указанного при создании сервера. Изменить его может администратор: раздел администратора → Servers → сервер → вкладка Build Configuration.
Плагины. На вкладке Files откройте папку plugins, нажмите Upload и выберите файл плагина (.jar). После загрузки перезапустите сервер кнопкой Restart — плагин включится при запуске. Плагины берите под свою версию игры.
Настройки Geyser лежат в файле plugins/Geyser-Spigot/config.yml, настройки Floodgate — в plugins/floodgate/config.yml; обе папки появляются после первого запуска:
| Параметр | Что задаёт |
|---|---|
bedrock → port (Geyser) |
Порт для игроков Bedrock — 19132. Он должен совпадать с портом, выделенным серверу в панели |
motd → passthrough-motd (Geyser) |
true — игроки Bedrock видят в списке серверов то же описание, что и игроки Java
|
java → auth-type (Geyser) |
Способ входа игроков Bedrock. С Floodgate менять не нужно |
username-prefix (Floodgate) |
Приставка к именам игроков Bedrock — по умолчанию точка |
Обновление сервера
Чтобы обновить Purpur до свежей сборки, откройте на странице сервера вкладку Settings и нажмите Reinstall Server. Панель остановит сервер и скачает заново файл сервера, а с ним — свежие Geyser и Floodgate; мир, настройки и принятая лицензия при этом сохраняются — при проверке так и было. После переустановки сервер остаётся выключенным: запустите его кнопкой Start.
Если что-то пошло не так
| Что видите | Причина и решение |
|---|---|
| Сервер останавливается сразу после запуска, в консоли «You need to agree to the EULA in order to run the server» | Не принята лицензия Minecraft. Нажмите Start и в появившемся окне — I Accept. |
| В консоли «Unsupported Java detected» или «has been compiled by a more recent version of the Java Runtime» | Версия Java не подходит к версии игры. На вкладке Startup выберите другую Java в списке «Docker Image» и перезапустите сервер. |
| Игрок видит «Outdated client» или «Outdated server» | Версии игры и сервера не совпадают. Зайдите той же версией, что у сервера, или пересоздайте сервер с нужным номером в поле «Minecraft Version». |
| Игрок Bedrock не видит сервер или не может подключиться, игроки Java заходят | Проверьте, что серверу выделен порт 19132, что в файрволе он открыт и по TCP, и по UDP, и что игрок вводит порт 19132, а не 25565. Если не помогло, впишите внешний IP-адрес VDS в строку advertise-addresses файла plugins/Geyser-Spigot/config.yml и перезапустите сервер.
|
| Игроку Bedrock сообщают, что его версия игры не поддерживается | Bedrock обновился, а Geyser ещё прежний. Обновите сервер кнопкой Reinstall Server — она скачивает и свежий Geyser. |
| При импорте шаблона панель сообщает об ошибке формата | Скачан файл для другой панели или вместо файла сохранилась веб-страница. Нужен файл egg-pterodactyl-….json, сохранённый по ссылке из шага 1.
|
| В форме создания сервера нет нужного порта | Порт не выделен или уже занят другим сервером. Проверьте вкладку Allocation узла. |
| Установка не заканчивается: надпись об установке висит часами | Wings ждёт загрузки образа Docker не дольше 15 минут; если канал медленный, загрузка обрывается, а сервер остаётся в состоянии установки. Скачайте образ на VDS вручную: sudo docker pull ghcr.io/pelican-eggs/yolks:java_25, затем на странице сервера откройте Settings и нажмите Reinstall Server.
|
| Сервер запущен, но зайти не удаётся | Проверьте, что порты открыты в файрволе VDS и что в игре указан верный адрес и порт. |
Для размещения игровых серверов рекомендуем услуги ARK-HOSTER.RU:
- VPS/VDS серверы — для небольших и средних серверов
- Выделенные серверы — для высоконагруженных игровых серверов