Установка сервера Terraria с модами (tModLoader) в панели Pterodactyl

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

Инструкция, как установить и запустить сервер Terraria с модами (tModLoader) в панели управления Pterodactyl. Сама панель уже должна быть установлена — это описано в статье Как установить и настроить панель управления игровым сервером Pterodactyl. Все снимки экрана сняты с настоящей панели: инструкция проверена 21 ноября 2026 года на Pterodactyl 1.15.2 и Wings 1.13.5 с сервером tModLoader 2026.9 (Terraria 1.4.4.9).

tModLoader — версия Terraria с поддержкой модов: Calamity, Thorium и тысячи других ставятся именно на неё. Шаблон «tModloader» скачивает последний выпуск сервера со страницы разработчиков на GitHub. Сервер бесплатный, учётная запись Steam для его установки не нужна. Игрокам нужна Terraria и бесплатная программа tModLoader из Steam: с обычной Terraria на такой сервер зайти нельзя. Сервер без модов описан в статье Установка сервера Terraria в панели Pterodactyl.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Поле Что вписать
World Name Имя мира — так будет называться файл мира. Если мира с таким именем ещё нет, сервер создаст новый
World Size Размер нового мира: 1 — маленький, 2 — средний, 3 — большой
Difficulty Режим нового мира: 0 — классика, 1 — эксперт, 2 — мастер, 3 — путешествие
Max Players Число мест на сервере. По умолчанию 8
Server Password Пароль для входа. Пустое поле — вход без пароля
MOTD Проверьте это поле. Приветствие, которое игрок видит при входе. В значении по умолчанию стоит особый знак апострофа — замените текст своим, латинскими буквами
Language Язык сообщений сервера: 1 — английский, 2 — немецкий, 3 — итальянский, 4 — французский, 5 — испанский
tModloader Version Оставьте latest — последний выпуск. Версия tModLoader у игроков должна совпадать с версией сервера
GitHub User, GitHub OAuth Token Оставьте пустыми

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

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

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

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

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

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

Когда установка закончится, сервер запустится сам: в форме создания была отмечена настройка «Start Server when Installed». Если вы её сняли, нажмите Start. При первом запуске сервер создаёт мир — в консоли бегут проценты; при проверке маленький мир создавался около полутора минут. Следующие запуски занимают полминуты. Сервер готов, когда в консоли появились строки «Listening on port 7777» и «Type 'help' for a list of commands». На снимке — консоль сервера с уже загруженным модом и ответ на команду modlist:

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

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

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

sudo ufw allow 7777/tcp

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

При проверке сервер, созданный в панели, ответил снаружи, с другого компьютера: на попытку входа обычным клиентом Terraria он сообщил, что к серверу tModLoader нужен клиент tModLoader.

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

Запустите tModLoader из Steam, выберите «Сетевая игра» → «Присоединиться по IP», затем персонажа, введите IP-адрес VDS и порт 7777. Если на сервере есть моды, которых нет у игрока, tModLoader предложит скачать их и перезагрузится.

С обычной Terraria зайти не получится: сервер отвечает «You cannot connect to a tModLoader Server with an unmodded client».

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

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

Моды — файлы .tmod в папке mods. Рядом лежит файл enabled.json: в нём перечислены моды, которые сервер загружает. Чтобы поставить мод:

1. Подпишитесь на мод в Мастерской Steam через tModLoader на своём компьютере. Файл мода появится в папке Steam: steamapps\workshop\content\1281930\НОМЕР_МОДА\ВЕРСИЯ\ИмяМода.tmod. Папок с версиями может быть несколько — берите самую новую.

2. Остановите сервер. На вкладке Files зайдите в папку mods и загрузите файл .tmod кнопкой Upload.

3. Откройте enabled.json и впишите имя мода — имя файла без расширения. Несколько модов перечисляют через запятую:

[
  "BossChecklist",
  "CalamityMod"
]

4. Запустите сервер и введите в строке под консолью modlist — сервер перечислит загруженные моды. При проверке так был поставлен мод Boss Checklist.

Набор из многих модов удобнее собрать в самой программе tModLoader: в меню «Workshop» → «Mod Packs» сохраните включённые моды как набор и откройте его папку — в ней лежат все файлы .tmod и готовый enabled.json. Загрузите их в папку mods сервера.

Мир лежит в папке saves/Worlds: файл ИМЯ_МИРА.wld и файл с данными модов ИМЯ_МИРА.twld. Чтобы поставить свой мир, остановите сервер, загрузите оба файла в эту папку и впишите имя мира без расширения в поле World Name на вкладке Startup.

Настройки — имя мира, размер, число игроков, пароль, приветствие — панель передаёт серверу в команде запуска; их меняют на вкладке Startup.

Команды. В строке под консолью работают команды сервера: help — список команд, modlist — загруженные моды, playing — игроки, save — сохранить мир, kick НИК и ban НИК — выгнать и заблокировать игрока, say ТЕКСТ — сообщение в чат. Кнопка Stop посылает серверу команду exit — он сохраняет мир и выключается; при проверке файл мира при остановке обновился.

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

Версии tModLoader у сервера и игроков должны совпадать, а tModLoader у игроков обновляется через Steam сам. Чтобы обновить сервер, откройте на его странице вкладку Settings и нажмите Reinstall Server: шаблон скачает последний выпуск поверх прежнего. Перед этим сделайте копию папок saves и mods — на вкладке Backups. После обновления tModLoader обновите и моды: старые версии могут не загрузиться.

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

Что видите Причина и решение
Игрок видит «You cannot connect to a tModLoader Server with an unmodded client» Он запускает обычную Terraria. Нужна программа tModLoader из Steam.
Игрока не пускает из-за версии Версии tModLoader у сервера и игрока разные. Обновите сервер кнопкой Reinstall Server.
Мод не появился в ответе на modlist Имя в enabled.json не совпадает с именем файла .tmod (регистр букв важен), потеряна запятая или кавычка, либо версия мода не подходит к версии tModLoader.
Сервер останавливается сам во время загрузки модов Не хватает памяти: крупным модам нужно 2–4 ГБ. Проверьте значение Memory.
Игроки не могут подключиться Закрыт порт 7777/TCP. Именно TCP: правило для UDP не поможет.
При импорте шаблона панель сообщает об ошибке формата Скачан файл для другой панели или вместо файла сохранилась веб-страница. Нужен файл egg-pterodactyl-….json, сохранённый по ссылке из шага 1.
В форме создания сервера нет нужного порта Порт не выделен или уже занят другим сервером. Проверьте вкладку Allocation узла.
Установка не заканчивается: надпись об установке висит часами Wings ждёт загрузки образа Docker не дольше 15 минут; если канал медленный, загрузка обрывается, а сервер остаётся в состоянии установки. Скачайте образ на VDS вручную: sudo docker pull ghcr.io/parkervcp/yolks:dotnet_8, затем на странице сервера откройте Settings и нажмите Reinstall Server.
Сервер запущен, но зайти не удаётся Проверьте, что порты открыты в файрволе VDS и что в игре указан верный адрес и порт.

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