Установка сервера Minecraft со сборкой модов FTB в панели Pterodactyl

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

Инструкция, как установить и запустить сервер Minecraft со сборкой модов FTB в панели управления Pterodactyl. Сама панель уже должна быть установлена — это описано в статье Как установить и настроить панель управления игровым сервером Pterodactyl. Все снимки экрана сняты с настоящей панели: инструкция проверена 19 ноября 2026 года на Pterodactyl 1.15.2 и Wings 1.13.5 со сборкой FTB StoneBlock 4 версии 1.24.1 (Minecraft 1.21.1, NeoForge).

FTB (Feed The Beast) — команда, которая выпускает большие сборки модов для Minecraft Java Edition: StoneBlock, Skies, OceanBlock, Direwolf20 и другие. Шаблон «FTB Server» ставит сервер сразу со сборкой: вы указываете её номер и номер версии, а официальный установщик FTB скачивает игру, загрузчик модов и все моды. Игрокам нужна та же сборка той же версии — её ставят через FTB App.

Что понадобится

  • VDS с установленной панелью Pterodactyl и узлом Wings; вход в панель под учётной записью администратора.
  • Память: сборки FTB тяжёлые: сервер со сборкой из примера занимает около 6 ГБ без игроков, а её авторы советуют 8 ГБ. Серверу в панели отведите от 8 ГБ и берите VDS от 12–16 ГБ. Сколько памяти нужно другой сборке, написано на её странице.
  • Диск: сервер со сборкой из примера занимает 1,2 ГБ, образ Docker с Java — около 1 ГБ. Серверу в панели отведите 20 ГБ.

Подобрать сервер можно на странице тарифов VDS.

1. Добавьте шаблон игры

Игру в Pterodactyl описывает шаблон — «яйцо» (egg): в нём записано, какой образ Docker использовать, как скачать сервер и какой командой его запустить. Шаблона Minecraft со сборкой модов FTB в панели изначально нет — его берут из общего хранилища шаблонов, которое ведёт сообщество.

1. Скачайте файл шаблона на свой компьютер: откройте ссылку egg-pterodactyl-f-t-b-server.json и сохраните страницу (Ctrl+S) под именем egg-pterodactyl-f-t-b-server.json. Нужен именно файл со словом pterodactyl в имени: соседний файл без него предназначен для другой панели и в Pterodactyl не загрузится.

2. В панели перейдите в раздел администратора (значок с шестерёнками справа вверху) и откройте Nests. Гнездо (nest) — это папка для шаблонов; новый шаблон положим в гнездо Minecraft — оно есть в панели изначально.

3. Нажмите Import Egg. В поле «Egg File» выберите скачанный файл, в поле «Associated Nest» — гнездо Minecraft и нажмите Import:

Панель откроет страницу шаблона с сообщением «Successfully imported this Egg and its associated variables».

4. Исправьте образ установки. Без этого шага установка не начнётся: шаблон запускает установочный скрипт в образе без прав администратора, и в журнале установки остаётся одна строка — «bash: /mnt/install/install.sh: Permission denied». На странице шаблона перейдите на вкладку Install Script, в поле «Script Container» замените значение на ghcr.io/pelican-eggs/installers:java_21 и нажмите Save:

2. Выделите порты

Адрес и порты сервер получает из списка «выделений» (allocations) узла. Серверу Minecraft со сборкой модов FTB нужны порты:

Порт Протокол Зачем
25565 TCP Игра

1. Откройте Nodes, щёлкните по своему узлу и перейдите на вкладку Allocation.

2. В блоке «Assign New Allocations» в поле «IP Address» выберите IP-адрес VDS, а в поле «Ports» введите 25565 — после каждого номера нажимайте Enter. Нажмите Submit:

IP-адрес на снимках заменён примером.

3. Создайте сервер

1. Откройте Servers и нажмите Create New.

2. Заполните верхнюю часть формы:

  • Server Name — название сервера в панели; игроки его не видят;
  • Server Owner — начните вводить почту своей учётной записи и выберите её из списка;
  • Node — ваш узел, Default Allocation — порт 25565;
  • Memory — 8192 (в мегабайтах), Disk Space — 20000, Swap — 0, CPU Limit — 0, то есть без ограничения.

3. В блоке «Nest Configuration» выберите гнездо Minecraft и шаблон FTB Server. Образ Docker и команда запуска подставятся сами, менять их не нужно:

4. В блоке «Service Variables» задайте настройки игры. Что стоит изменить:

Поле Что вписать
FTB modpack ID Номер сборки. Откройте страницу сборки на feed-the-beast.com и найдите в правой колонке блок «Developer / Server Admin» — номер стоит в строке «Pack ID». У FTB StoneBlock 4 это 130
FTB Pack Version ID Номер версии сборки — строка «Latest Version ID» в том же блоке. У версии 1.24.1 сборки из примера это 100574
FTB Pack search term и FTB Pack Version Оставьте пустыми: они нужны, только если номера сборки и версии неизвестны
Docker Image (блок «Docker Configuration») Java под версию игры в сборке. По умолчанию стоит Java 21 — она нужна сборкам на Minecraft 1.20.5–1.21.x, с ней проверена сборка из примера. Для 1.18–1.20.4 выберите Java 17, для 1.16.5 и старше — Java 8, для версий 26.x — Java 25. Версия игры и Java указаны на странице сборки

Остальные поля можно оставить как есть.

5. Нажмите Create Server внизу страницы.

4. Дождитесь установки

Панель создаст сервер, а Wings начнёт установку: скачает образ Docker и файлы игры. Установка сборки из примера заняла около четырёх минут: установщик FTB скачивает моды и ставит загрузчик модов.

Выйдите из раздела администратора (значок выхода справа вверху) и щёлкните по серверу в списке — откроется его страница с консолью. Пока идёт установка, вверху страницы стоит надпись «This server is currently running its installation process and most actions are unavailable».

5. Запустите сервер

Когда установка закончится, сервер запустится сам: в форме создания была отмечена настройка «Start Server when Installed». Если вы её сняли, нажмите Start.

Лицензия Minecraft. Первый запуск сразу остановится: сервер Minecraft не работает, пока не принято лицензионное соглашение Mojang (EULA). Панель покажет окно «Accept Minecraft® EULA». Прочитайте соглашение по ссылке в окне и нажмите I Accept — панель сама запишет согласие в файл eula.txt и запустит сервер заново:

Если окно не появилось, нажмите Start ещё раз.

Сервер загрузит моды, создаст мир и запустится. Он готов, когда в консоли появилась строка «Done (…)! For help, type "help"» — при проверке это заняло около трёх минут — большая сборка загружается долго:

Кнопки Restart и Stop перезапускают и останавливают сервер; при остановке панель посылает ему штатную команду завершения, и он успевает сохранить мир. Команды сервера вводят в строку под консолью.

6. Откройте порты в файрволе

Если на VDS включён файрвол ufw, разрешите порты сервера. Выполните на VDS:

sudo ufw allow 25565/tcp

Проверить, включён ли файрвол, можно командой sudo ufw status: ответ «Status: inactive» означает, что он выключен и порты открывать не нужно.

При проверке сервер, созданный в панели, ответил на запрос снаружи, с другого компьютера: версия 1.21.1, 0 из 20 игроков.

7. Зайдите на сервер

Сначала игрок ставит себе ту же сборку: в FTB App находит её по названию, выбирает ту же версию, что на сервере, и устанавливает. Затем запускает сборку, открывает «Сетевая игра» → «Добавить сервер» и вводит адрес IP_СЕРВЕРА:25565. Обычной игрой без модов на такой сервер не зайти.

Чтобы выдать себе права оператора, введите в строке под консолью панели команду op ВАШ_НИК.

Настройки после установки

Всё, что вы задали в блоке «Service Variables», можно изменить позже — на вкладке Startup страницы сервера. Изменения вступают в силу после перезапуска сервера кнопкой Restart.

Настройки игры лежат в файле server.properties. На вкладке Files щёлкните по нему — файл откроется во встроенном редакторе. Измените нужные строки — например, motd (описание в списке серверов), max-players (число игроков), difficulty (сложность) — и нажмите Save Content, затем перезапустите сервер.

Память серверу задаётся не в файлах, а в панели: Java получает 95 % от значения Memory, указанного при создании сервера. Изменить его может администратор: раздел администратора → Servers → сервер → вкладка Build Configuration.

Моды и их настройки. Моды сборки лежат в папке mods, их настройки — в папках config и defaultconfigs. Дополнительные параметры Java можно вписать в файл user_jvm_args.txt.

Обновление сборки

Кнопка Reinstall Server сборку FTB не обновит: установщик FTB отказывается работать в папке, где уже есть файлы, и пишет в журнал «Install directory is not empty, installing the modpack may cause issues». Чтобы перейти на новую версию сборки, создайте новый сервер с новым номером версии и перенесите в него папку world со старого: на вкладке Files старого сервера упакуйте её в архив (меню с тремя точками → Archive), скачайте и загрузите на новый сервер. Перед переносом сделайте резервную копию на вкладке Backups: новая версия сборки не всегда совместима со старым миром.

Если что-то пошло не так

Что видите Причина и решение
Установка заканчивается за секунды, сервер не запускается, в консоли «Error: Unable to access jarfile start-server.jar» Не исправлен образ установки — см. шаг 1, пункт 4. Исправьте поле «Script Container», затем удалите сервер и создайте его заново: в папке первого сервера уже остался файл настроек, а установщик FTB в непустую папку сборку не ставит.
Сервер останавливается сразу после запуска, в консоли «You need to agree to the EULA in order to run the server» Не принята лицензия Minecraft. Нажмите Start и в появившемся окне — I Accept.
В консоли «UnsupportedClassVersionError» или «has been compiled by a more recent version of the Java Runtime» Версия Java не подходит к версии игры в сборке. На вкладке Startup выберите другую Java в списке «Docker Image» и перезапустите сервер.
Сервер останавливается при запуске, в консоли «OutOfMemoryError» Сборке не хватает памяти. Увеличьте значение Memory: раздел администратора → Servers → сервер → вкладка Build Configuration.
Игрока отключает с сообщением о несовпадении модов У игрока другая сборка или другая её версия. Поставьте в FTB App ту же версию сборки, что на сервере.
При импорте шаблона панель сообщает об ошибке формата Скачан файл для другой панели или вместо файла сохранилась веб-страница. Нужен файл egg-pterodactyl-….json, сохранённый по ссылке из шага 1.
В форме создания сервера нет нужного порта Порт не выделен или уже занят другим сервером. Проверьте вкладку Allocation узла.
Установка не заканчивается: надпись об установке висит часами Wings ждёт загрузки образа Docker не дольше 15 минут; если канал медленный, загрузка обрывается, а сервер остаётся в состоянии установки. Скачайте образ на VDS вручную: sudo docker pull ghcr.io/pelican-eggs/yolks:java_21, затем на странице сервера откройте Settings и нажмите Reinstall Server.
Сервер запущен, но зайти не удаётся Проверьте, что порты открыты в файрволе VDS и что в игре указан верный адрес и порт.

Для размещения игровых серверов рекомендуем услуги ARK-HOSTER.RU: