Установка сервера Minecraft Forge в панели Pterodactyl

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

Инструкция, как установить и запустить сервер Minecraft Forge в панели управления Pterodactyl. Сама панель уже должна быть установлена — это описано в статье Как установить и настроить панель управления игровым сервером Pterodactyl. Все снимки экрана сняты с настоящей панели: инструкция проверена 19 ноября 2026 года на Pterodactyl 1.15.2 и Wings 1.13.5 с Forge 66.1.9 для Minecraft 26.3 и с Forge для Minecraft 1.20.1.

Forge — сервер Minecraft Java Edition для игры с модами. Моды Forge должны стоять и на сервере, и у каждого игрока.

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

  • VDS с установленной панелью Pterodactyl и узлом Wings; вход в панель под учётной записью администратора.
  • Память: пустой сервер Forge для 26.3 занимает около 900 МБ, для 1.20.1 — около 2 ГБ; каждый мод добавляет своё. Серверу в панели отведите от 4 ГБ, для сборок из десятков модов — 6–8 ГБ.
  • Диск: сервер без модов занимает около 200 МБ, образ Docker с Java — около 1 ГБ. Серверу в панели отведите 10 ГБ.

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

1. Шаблон игры

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

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

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

Порт Протокол Зачем
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 — 4096 (в мегабайтах), Disk Space — 10000, Swap — 0, CPU Limit — 0, то есть без ограничения.

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

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

Поле Что вписать
Docker Image (блок «Docker Configuration») Версия Java. По умолчанию выбрана Java 25 — с ней проверен Forge для 26.3; Forge для 1.20.1 проверен с Java 17. Старым версиям игры нужна своя 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.20.1
Build Type recommended — рекомендованная сборка Forge для выбранной версии игры, latest — самая новая
Forge Version Точный номер сборки Forge, если нужна определённая. Обычно поле оставляют пустым
Server Jar File Имя файла сервера. Оставьте server.jar — для свежих версий его придётся поправить после установки (шаг 5)

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

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

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

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

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

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

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

Свежие версии Forge: поправьте имя файла сервера. С Forge для Minecraft 26.3 сервер после установки не запускается: в консоли появляется строка «Error: Unable to access jarfile server.jar». Установщик свежего Forge называет файл сервера по-своему — forge-ВЕРСИЯ-shim.jar, а шаблон панели ждёт server.jar. Исправляется это за минуту:

  1. откройте вкладку Files и найдите файл с окончанием -shim.jar — при проверке это был forge-26.3-66.1.9-shim.jar;
  2. откройте вкладку Startup и впишите это имя в поле «Server Jar File»;
  3. вернитесь на вкладку Console и нажмите Start.

С Forge для Minecraft 1.20.1 этого делать не нужно: при проверке сервер запустился сразу.

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

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

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

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

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

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

sudo ufw allow 25565/tcp

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

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

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

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

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

У игрока должен стоять Forge той же версии и те же моды, что на сервере.

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

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

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

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

Моды. После первого запуска в файлах сервера появляется папка mods. На вкладке Files откройте её, нажмите Upload и выберите файлы модов (.jar), затем перезапустите сервер кнопкой Restart. Моды берите под свою версию игры и под Forge — моды для Fabric здесь не заработают.

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

Чтобы обновить Forge до свежей сборки, откройте на странице сервера вкладку Settings и нажмите Reinstall Server. Панель остановит сервер и скачает файл сервера заново; мир, настройки и принятая лицензия при этом сохраняются — при проверке так и было. После переустановки сервер остаётся выключенным: запустите его кнопкой Start.

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

Что видите Причина и решение
В консоли «Error: Unable to access jarfile server.jar» Файл сервера называется иначе. Найдите на вкладке Files файл forge-…-shim.jar и впишите его имя в поле «Server Jar File» на вкладке Startup.
Сервер останавливается сразу после запуска, в консоли «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».
После добавления мода сервер не запускается Мод не подходит к версии игры или Forge, либо ему нужен другой мод-библиотека. Причина написана в консоли ближе к концу; уберите мод из папки mods и запустите сервер снова.
В форме создания сервера нет нужного порта Порт не выделен или уже занят другим сервером. Проверьте вкладку Allocation узла.
Установка не заканчивается: надпись об установке висит часами Wings ждёт загрузки образа Docker не дольше 15 минут; если канал медленный, загрузка обрывается, а сервер остаётся в состоянии установки. Скачайте образ на VDS вручную: sudo docker pull ghcr.io/pterodactyl/yolks:java_25, затем на странице сервера откройте Settings и нажмите Reinstall Server.
Сервер запущен, но зайти не удаётся Проверьте, что порты открыты в файрволе VDS и что в игре указан верный адрес и порт.

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