Как создать сервер tModLoader

Что такое tModLoader и подвох с версией

tModLoader — стандартный способ играть в Terraria с модами на ПК: бесплатное отдельное приложение в Steam, которое запускает Terraria с модами из собственного Steam Workshop. Сервер tModLoader — та же идея на стороне сервера: он загружает моды, а каждый игрок тоже подключается через tModLoader.

Две вещи часто сбивают с толку:

• Для мультиплеера это другая игра. Игроки tModLoader не могут зайти на ванильный сервер, а игроки ванильной версии — на сервер tModLoader. Все в группе играют через tModLoader.
• Он работает на более старой Terraria. Ванильная Terraria уже на 1.4.5 (обновление «Bigger and Boulder» января 2026 года). tModLoader всё ещё основан на 1.4.4, и версии tModLoader для 1.4.5 пока нет. Мир, в котором играли на 1.4.5, нельзя открыть в tModLoader. В обратную сторону работает: мир tModLoader открывается в ванильной 1.4.5 и при этом обновляется.

Поэтому, если хотите прохождение с модами, начинайте мир в tModLoader. Не переносите туда свой ванильный мир 1.4.5.

Сервер tModLoader у себя дома

Быстрый способ: хостить из игры

Установите tModLoader из Steam (он бесплатный, но Terraria должна быть у вас в Steam), включите моды и выберите Multiplayer > Host & Play. Друзья заходят через Steam. Мир работает на вашем ПК и останавливается, когда вы выходите.

Выделенный сервер на Windows или macOS

1. Сначала настройте список модов в игре. Подпишитесь на моды в Workshop и включите их в tModLoader. Затем откройте Workshop > Mod Packs, выберите Save Enabled as New Mod Pack и Open Mod Pack Folder. Теперь у вас есть install.txt (ID из Workshop) и enabled.json (какие моды включены).
2. Запустите сервер. В папке установки tModLoader (в Steam: правый клик по tModLoader > Manage > Browse local files) запустите start-tModLoaderServer.bat на Windows или start-tModLoaderServer.sh на macOS.
3. Ответьте на вопросы: использовать ли Steam, какой мир (или создать новый), максимум игроков, порт (по умолчанию 7777), проброс портов и пароль.
4. Откройте порт. Пробросьте TCP 7777 на роутере на ваш ПК, и друзья зайдут по вашему внешнему IP через Join via IP.

Моды и миры лежат в Documents/My Games/Terraria/tModLoader/: в Mods/ — файлы .tmod и enabled.json, в Worlds/ — каждый мир в виде файла .wld и файла .twld с данными модов. Держите оба файла мира вместе.

На Linux

У tModLoader есть свои инструменты для этого — DedicatedServerUtils. Их документация рекомендует запускать сервер в Docker; альтернатива — manage-tModLoaderServer.sh, который устанавливает tModLoader (install-tml --github), скачивает моды из Workshop, перечисленные в install.txt (install-mods), и запускает сервер (start). Предварительно положите install.txt и enabled.json в tModLoader/Mods/, а мир — в tModLoader/Worlds/.

Про ванильную часть — консоль, serverconfig.txt, проброс портов — читайте как создать сервер в Террарии; tModLoader принимает те же настройки.

Хостинг сервера tModLoader на HytHost

1. Выберите tModLoader при заказе. На странице хостинга Terraria выберите тариф и укажите tModLoader как серверное ПО. Для Calamity или Thorium начинайте с Gold (6 GB).
2. Загрузите моды. В файловом менеджере GamePanel (или по sFTP) положите файлы .tmod в папку mods/. На ПК они лежат в steamapps/workshop/content/1281930/, по папке на каждый элемент Workshop.
3. Загрузите enabled.json в ту же папку. Это простой список названий модов, например ["CalamityMod","CalamityModMusic"]; каждый мод, который должен быть включён, обязан быть в нём.
4. Перезапустите сервер и посмотрите консоль: она выводит каждый мод по мере загрузки и называет тот, что не загрузился, если такой есть.
5. Заходите. Друзья открывают tModLoader, выбирают Join via IP и вводят адрес и порт из панели. Недостающие моды скачиваются с сервера при входе.

Уже есть мир с модами? Загрузите .wld и его .twld в папку миров сервера или пришлите их нам — перенесём бесплатно. Кроме самого tModLoader, ничего не предустановлено, поэтому версии модов всегда те, что выбрали вы.

Популярные сборки модов и сколько им нужно RAM

Именно моды в первую очередь определяют потребление памяти сервером tModLoader. Контентные моды добавляют предметы, врагов, боссов и генерацию мира, и всё это держится в памяти, пользуется этим кто-то или нет. Ни tModLoader, ни крупные моды не публикуют официальных цифр для сервера, поэтому таблица ниже — наша рекомендация с некоторым запасом:

Ещё две вещи повышают расход памяти: размер мира (большой мир занимает примерно вдвое больше памяти, чем маленький, ещё до входа игроков) и игроки, разбредшиеся по карте. Для сравнения, ванильный сервер на маленьком мире в простое занимает заметно меньше 1 GB.

Чтобы увидеть, какие моды тяжёлые, включите Show Mod Memory Estimates в настройках tModLoader. Если сервер падает с OutOfMemoryException, ему нужно больше RAM или меньше крупных модов — никакая настройка это не исправит.

Как друзья получают моды

Друзьям не нужно собирать список модов вручную. Когда клиент tModLoader подключается, он сравнивает свои моды с серверными — по названию, версии и файлу — и скачивает всё недостающее или отличающееся прямо с сервера, затем перезагружается и подключается. Моды, которые есть у клиента, но нет на сервере, отключаются на эту сессию. Моды, помеченные как только серверные, никогда не передаются.

Что нужно каждому игроку:

• Сам tModLoader из Steam той же версии, что и на сервере.
• Включённая опция «Download Mods From Servers» в настройках tModLoader. По умолчанию она включена; если её выключить, клиент откажется подключаться и покажет список нужных модов.
• Доверие к серверу. tModLoader предупреждает, что моды могут содержать код и скачивать их стоит только с сервера, которому вы доверяете. На вашем собственном сервере это вы.

Частые ошибки сервера tModLoader

"You are not using the same version as this server"

Версии tModLoader отличаются — они должны совпадать точно. Steam обновляет tModLoader у игроков автоматически, поэтому после выхода новой версии tModLoader обновите и сервер. То же сообщение появляется, если вы случайно подключаетесь к ванильному серверу на том же порту.

Мод отсутствует или не загружается

Проверьте, что мод указан в enabled.json под внутренним именем (а не отображаемым), что его зависимости тоже загружены и включены и что файл .tmod той же версии, что у друзей. В логе сервера указан мод, который не загрузился.

Нехватка памяти

OutOfMemoryException в логе означает, что серверу не хватило RAM при загрузке или работе модов. Уберите крупный мод, используйте мир поменьше или перейдите на тариф побольше.

Мир не открывается

Обычно это мир, в котором играли на ванильной 1.4.5, — tModLoader не может его открыть. Также причиной может быть отсутствующий файл .twld рядом с .wld или мод, от которого зависит мир, но который больше не включён.

Игра не запускается после установки мода «64 bit»

Старый элемент Workshop "tModLoader 64 bit" устарел — текущий tModLoader уже 64-битный, — и его установка не даёт игре запуститься. Отпишитесь от него.