Для сервера tModLoader сначала согласуйте с игроками ветку движка и набор сетевых модов, затем загрузите нужный модифицированный мир. Если просто скопировать папку модов на обычный сервер Terraria, сервером tModLoader он не станет.
Здесь разобрана прямая установка через скрипт разработчиков на Linux x86-64 с подключением по IP. На 25 октября 2026 года стабильный GitHub-релиз — v2026.08.3.0 на базе Terraria 1.4.4; preview выпускается отдельно. Убедитесь, что ваша сборка поддерживает выбранную версию. Плагины TShock, актуальная обычная Terraria и клиенты на консолях или телефонах к этой схеме не относятся.
Подготовьте учётную запись и сборку на клиенте#
Используйте обычную учётную запись Linux с доступным для записи домашним каталогом, свободным местом и правом занять выбранный порт. Установите Bash, curl, unzip и tar средствами дистрибутива, а также SteamCMD по инструкции Valve. Для загрузки модов Workshop он нужен даже тогда, когда сам движок скачивается с GitHub. Зависимости SteamCMD на Linux могут включать 32-битные библиотеки: список пакетов другого дистрибутива не стоит переносить вслепую.
Скрипт управления устанавливает нужный релизу .NET через утилиты запуска. Если они сообщают об отсутствующих системных библиотеках, сначала устраните указанную причину по инструкции для вашего дистрибутива. Поддерживаемой ARM-установки у рассматриваемых утилит tModLoader нет. Наличие отдельной ARM-сборки TShock этого не меняет.
На рабочем PC-клиенте tModLoader включите нужные моды и зависимости. В Workshop → Mod Packs выберите Save Enabled as New Mod Pack, затем Open Mod Pack Folder. Сохраните install.txt, enabled.json и tmlversion.txt, если он есть в пакете. Первый файл задаёт загрузки Workshop, второй — включённые моды. Одного списка Workshop ID для включения недостаточно.
Установите конкретную версию движка#
Выполняйте команды от имени серверного пользователя на обычном хосте. В контейнере скрипт обнаруживает другое окружение и использует другую структуру:
mkdir -p "$HOME/terraria-tml/Mods" "$HOME/terraria-tml/Worlds"
cd "$HOME/terraria-tml"
curl -fL -o manage-tModLoaderServer.sh \
https://raw.githubusercontent.com/tModLoader/tModLoader/v2026.08.3.0/patches/tModLoader/Terraria/release_extras/DedicatedServerUtils/manage-tModLoaderServer.sh
chmod +x manage-tModLoaderServer.sh
Прочитайте скачанный скрипт перед запуском. Ниже специально указан проверенный стабильный тег: меняйте его после сверки с клиентами и сборкой. Предложение обновить сам скрипт рассматривайте отдельно от обновления игрового движка.
./manage-tModLoaderServer.sh install-tml --github --tmlversion v2026.08.3.0
Движок устанавливается в server, постоянные данные остаются в terraria-tml. Скопируйте экспортированные install.txt, enabled.json и необязательный tmlversion.txt в каталог Mods этого корня. Там же разместите локально распространяемые .tmod, если они нужны, и включите их внутренние имена в enabled.json. Используйте файлы автора мода или своей рабочей сборки: переименованные DLL и плагины TShock здесь не подходят.
Загрузите содержимое Workshop:
./manage-tModLoaderServer.sh install-mods
Проверьте результат и журнал запуска: нет ли отсутствующих зависимостей или отклонённых модов. Workshop меняется независимо от тега движка. Зафиксированная версия tModLoader сама по себе не фиксирует версии Workshop-модов.
Создайте или перенесите мир с этими модами#
Во время настройки ограничьте игровой порт адресом администратора. Для первого нового мира выполните:
cp -n server/serverconfig.txt serverconfig.txt
./manage-tModLoaderServer.sh start -nosteam
Сверьте загруженные моды, затем следуйте запросам консоли для выбора или создания мира. Генерируйте его уже с включёнными модами контента. Когда консоль запросит параметры, укажите порт, число игроков и отдельный пароль входа. После первого успешного сохранения завершите сервер консольной командой exit и дождитесь выхода процесса.
При переносе существующего мира сначала остановите исходный сервер. Скопируйте соответствующие друг другу .wld и .twld в каталог Worlds нового корня постоянных данных. Настройки модов восстановите в его каталог ModConfigs, сохранив также дополнительные пути данных отдельных модов. В .twld находятся модифицированные данные мира: одного обычного файла мира для полноценного переноса недостаточно. Работайте с копией и сохраните исходный совместимый набор движка и модов.
Закрепите нужный мир в конфигурации#
Создайте serverconfig.txt рядом со скриптом управления. В примере домашний каталог пользователя — /home/terraria; замените путь к миру реальным абсолютным путём вашей установки. $HOME внутри конфигурации не раскрывается:
world=/home/terraria/terraria-tml/Worlds/Coop.wld
maxplayers=8
port=7777
password=REPLACE_WITH_PRIVATE_JOIN_PASSWORD
В world указывайте .wld, а не .twld. Замените пример пароля и ограничьте доступ к конфигурации. При загрузке существующего мира не добавляйте autocreate: ошибка в пути не должна незаметно создавать новое прохождение. Повторите запуск той же командой start -nosteam, сверьте мир и моды.
Для подключения по публичному IP разрешите настроенный TCP-порт в firewall хоста и у VPS-провайдера. За домашним роутером дополнительно потребуется проброс на стабильный LAN-адрес сервера; при CGNAT нужен другой достижимый маршрут. Открывать остальные порты или отключать весь firewall не требуется.
Проверьте вход и сохраняйте экземпляр целиком#
На PC-клиенте tModLoader с подходящей версией откройте Multiplayer → Join via IP. Укажите достижимый адрес сервера, выбранный порт и пароль входа. Проверьте знакомый участок мира и модифицированный контент. Наличие слушающего сокета ещё не подтверждает вход в игру.
При несовпадении версий сначала сравните фактические версии tModLoader и ветки stable/preview на обеих сторонах, затем версии сетевых модов и зависимости. Если мир выглядит новым, проверьте путь и пользователя процесса прежде, чем что-либо генерировать. Сохраните журнал неудачной загрузки.
Перед обслуживанием отключите игроков, сохраните и штатно завершите сервер. Скопируйте весь постоянный корень: Worlds, Mods, ModConfigs, настройки, содержимое Workshop и сведения о рабочем релизе. Храните копию вне установки. Обновления движка и модов согласуйте с клиентами: install-tml меняет движок, install-mods загружает свежий Workshop, install выполняет оба действия. Новый набор модов сначала проверяйте на копии мира, сохраняя исходный вариант.
Если таких машин несколько, Nexardo поможет управлять собственной инфраструктурой; совместимую сборку и проверенный мир для этого экземпляра всё равно выбирает его администратор.
