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

Материал из ARK-HOSTER.RU | Документация хостинга
Версия от 13:18, 19 ноября 2026; Maintenance script (обсуждение | вклад) (Новая статья: установка сервера 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: