Установка сервера Terraria с модами (tModLoader) в панели Pterodactyl
Инструкция, как установить и запустить сервер 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:
- VPS/VDS серверы — для небольших и средних серверов
- Выделенные серверы — для высоконагруженных игровых серверов