Установка сервера Minecraft со сборкой модов Modrinth в панели Pterodactyl
Инструкция, как установить и запустить сервер Minecraft со сборкой модов Modrinth в панели управления Pterodactyl. Сама панель уже должна быть установлена — это описано в статье Как установить и настроить панель управления игровым сервером Pterodactyl. Все снимки экрана сняты с настоящей панели: инструкция проверена 19 ноября 2026 года на Pterodactyl 1.15.2 и Wings 1.13.5 со сборкой Cobblemon Official Modpack [Fabric] 1.8.4 (Minecraft 1.21.1).
Modrinth — каталог модов и готовых сборок модов (modpack) для Minecraft Java Edition. Шаблон «Modrinth Generic» ставит сервер сразу со сборкой: вы указываете её идентификатор, а панель сама скачивает нужную версию игры, загрузчик модов и серверные моды. Шаблон понимает сборки на Fabric, Forge и Quilt; сборки на NeoForge он не ставит. Игрокам нужна та же сборка той же версии — её ставят через Modrinth App или другой лаунчер с поддержкой Modrinth.
Что понадобится
- VDS с установленной панелью Pterodactyl и узлом Wings; вход в панель под учётной записью администратора.
- Память: сервер со сборкой из примера занимает около 2 ГБ без игроков; крупным сборкам нужно больше. Серверу в панели отведите от 6 ГБ; если панель стоит на том же VDS, берите VDS от 8 ГБ, для больших сборок — от 16 ГБ.
- Диск: сервер со сборкой из примера и новым миром занимает около 600 МБ, образ Docker с Java — около 1 ГБ. Серверу в панели отведите 15 ГБ.
Подобрать сервер можно на странице тарифов VDS.
1. Добавьте шаблон игры
Игру в Pterodactyl описывает шаблон — «яйцо» (egg): в нём записано, какой образ Docker использовать, как скачать сервер и какой командой его запустить. Шаблона Minecraft со сборкой модов Modrinth в панели изначально нет — его берут из общего хранилища шаблонов, которое ведёт сообщество.
1. Скачайте файл шаблона на свой компьютер: откройте ссылку egg-pterodactyl-modrinth-generic.json и сохраните страницу (Ctrl+S) под именем egg-pterodactyl-modrinth-generic.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 со сборкой модов Modrinth нужны порты:
| Порт | Протокол | Зачем |
|---|---|---|
| 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 —
6144(в мегабайтах), Disk Space —15000, Swap —0, CPU Limit —0, то есть без ограничения.
3. В блоке «Nest Configuration» выберите гнездо Minecraft и шаблон Modrinth Generic. Образ Docker и команда запуска подставятся сами, менять их не нужно:
4. В блоке «Service Variables» задайте настройки игры. Что стоит изменить:
| Поле | Что вписать |
|---|---|
| Modpack Project ID | Идентификатор сборки — обязательное поле. Откройте страницу сборки на modrinth.com, нажмите кнопку с тремя точками рядом с кнопкой «Download» и выберите «Copy ID» — в буфере окажется идентификатор из восьми знаков. Например, у сборки Cobblemon Official Modpack [Fabric] это 5FFgwNNP
|
| Modpack Version ID | latest — последняя версия сборки. Чтобы поставить определённую, откройте её страницу в разделе «Versions» сборки и скопируйте идентификатор версии тем же способом
|
| Docker Image (блок «Docker Configuration») | Выберите Java под версию игры в сборке — в списке образов первой стоит Java 8. Minecraft 1.20.5–1.21.x нужна Java 21 — с ней проверена сборка из примера; 1.18–1.20.4 — Java 17, 1.17 — Java 16, 1.16.5 и старше — Java 8, версиям 26.x — Java 25. Версия игры указана на странице сборки |
Остальные поля можно оставить как есть.
5. Нажмите Create Server внизу страницы.
4. Дождитесь установки
Панель создаст сервер, а Wings начнёт установку: скачает образ Docker и файлы игры. Установка занимает 10–15 минут и больше: шаблон скачивает моды сборки по одному. У сборки из примера на сервер ставится 36 файлов модов.
Выйдите из раздела администратора (значок выхода справа вверху) и щёлкните по серверу в списке — откроется его страница с консолью. Пока идёт установка, вверху страницы стоит надпись «This server is currently running its installation process and most actions are unavailable».
5. Запустите сервер
Когда установка закончится, сервер запустится сам: в форме создания была отмечена настройка «Start Server when Installed». Если вы её сняли, нажмите Start. Сервер с модами запускается дольше обычного: у сборки из примера загрузка модов заняла около трёх минут.
Лицензия Minecraft. Сервер не работает, пока не принято лицензионное соглашение Mojang (EULA). Спросить о нём сервер может одним из двух способов:
- вопрос в консоли — так было у сборки из примера: в консоли появляется строка «By answering 'true' to this prompt you are indicating your agreement to Minecraft's EULA» со ссылкой на соглашение, под ней —
EULA:, и сервер ждёт ответа. Прочитайте соглашение, введите в строку под консольюtrueи нажмите Enter — сервер ответит «EULA accepted» и продолжит запуск; - окно панели — если сервер остановился со строкой «You need to agree to the EULA in order to run the server», панель покажет окно «Accept Minecraft® EULA»: нажмите в нём I Accept. Если окно не появилось, нажмите Start ещё раз.
Сервер создаст мир и запустится. Он готов, когда в консоли появилась строка «Done (…)! For help, type "help"» — при проверке после ответа на вопрос это заняло около 40 секунд:
Кнопки Restart и Stop перезапускают и останавливают сервер; при остановке панель посылает ему штатную команду завершения, и он успевает сохранить мир. Команды сервера вводят в строку под консолью.
6. Откройте порты в файрволе
Если на VDS включён файрвол ufw, разрешите порты сервера. Выполните на VDS:
sudo ufw allow 25565/tcp
Проверить, включён ли файрвол, можно командой sudo ufw status: ответ «Status: inactive» означает, что он выключен и порты открывать не нужно.
При проверке сервер, созданный в панели, ответил на запрос снаружи, с другого компьютера: версия 1.21.1, 0 из 20 игроков.
7. Зайдите на сервер
Сначала игрок ставит себе ту же сборку: в Modrinth App находит её по названию, выбирает ту же версию, что на сервере, и нажимает «Install». Затем запускает сборку, открывает «Сетевая игра» → «Добавить сервер» и вводит адрес IP_СЕРВЕРА:25565. Обычной игрой без модов на такой сервер не зайти.
Чтобы выдать себе права оператора, введите в строке под консолью панели команду op ВАШ_НИК.
Настройки после установки
Всё, что вы задали в блоке «Service Variables», можно изменить позже — на вкладке Startup страницы сервера. Изменения вступают в силу после перезапуска сервера кнопкой Restart.
Настройки игры лежат в файле server.properties. На вкладке Files щёлкните по нему — файл откроется во встроенном редакторе. Измените нужные строки — например, motd (описание в списке серверов), max-players (число игроков), difficulty (сложность) — и нажмите Save Content, затем перезапустите сервер.
Память серверу задаётся не в файлах, а в панели: Java получает столько памяти, сколько указано в поле Memory при создании сервера. Изменить его может администратор: раздел администратора → Servers → сервер → вкладка Build Configuration.
Моды и их настройки. Моды сборки лежат в папке mods, их настройки — в папке config. Свой мод добавляют так же, как на обычном сервере с модами: загружают файл .jar в папку mods кнопкой Upload и перезапускают сервер; тот же мод должен стоять у игроков.
Другая версия сборки
Чтобы перейти на другую версию сборки, впишите её идентификатор в поле Modpack Version ID на вкладке Startup (или оставьте latest, чтобы получить последнюю), затем на вкладке Settings нажмите Reinstall Server — панель заново выполнит установку. Перед этим сделайте резервную копию на вкладке Backups: новая версия сборки не всегда совместима со старым миром. Игрокам после обновления сервера нужна та же версия сборки.
Если что-то пошло не так
| Что видите | Причина и решение |
|---|---|
| Установка сразу заканчивается, сервер не запускается, в файлах пусто | Не заполнено или неверно заполнено поле «Modpack Project ID». Проверьте идентификатор на вкладке Startup и нажмите Reinstall Server на вкладке Settings. |
| Установка обрывается на первых шагах | Установщик не смог скачать служебные пакеты или файлы сборки — так бывает при кратком сбое сети. Нажмите Reinstall Server ещё раз: при проверке повторная установка прошла. |
Сервер долго стоит на строке EULA: |
Он ждёт ответа: введите true в строку под консолью и нажмите Enter.
|
| В консоли «UnsupportedClassVersionError» или «has been compiled by a more recent version of the Java Runtime» | Версия Java не подходит к версии игры в сборке. На вкладке Startup выберите другую Java в списке «Docker Image» и перезапустите сервер. |
| Сервер останавливается при запуске, в консоли «OutOfMemoryError» | Сборке не хватает памяти. Увеличьте значение Memory: раздел администратора → Servers → сервер → вкладка Build Configuration. |
| Игрока отключает с сообщением о несовпадении модов | У игрока другая сборка или другая её версия. Поставьте ту же версию сборки, что на сервере. |
| При импорте шаблона панель сообщает об ошибке формата | Скачан файл для другой панели или вместо файла сохранилась веб-страница. Нужен файл 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:
- VPS/VDS серверы — для небольших и средних серверов
- Выделенные серверы — для высоконагруженных игровых серверов