Установка сервера Minecraft с Geyser (Java и Bedrock) в панели Pterodactyl

Материал из ARK-HOSTER.RU | Документация хостинга
Перейти к навигации Перейти к поиску

Инструкция, как установить и запустить сервер 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: