Установка модов

Это руководство описывает установку и управление модами на сервере Terraria через tModLoader: переключение версии сервера, загрузку файлов .tmod, настройку enabled.json, совместимость миров и основные ошибки запуска.

Что важно перед установкой модов

Моды Terraria работают через tModLoader. На ванильном сервере Terraria файлы .tmod не загружаются.

Перед установкой модов сервер должен быть переключён на tModLoader.

Миры tModLoader и ванильной Terraria лучше хранить отдельно. Если мир был создан или долго использовался с модами, запускать его на ванильном сервере небезопасно: модовые предметы, NPC, биомы и структуры могут быть потеряны или привести к ошибкам загрузки.

Основные файлы

mods/
mods/enabled.json
saves/Worlds/

mods/ — папка с файлами модов .tmod;
mods/enabled.json — список включённых модов;
saves/Worlds/ — миры Terraria в формате .wld.

На Linux имя папки и регистр символов важны. Если в панели используется mods/, загружайте файлы именно туда, а не в Mods/ или вложенную папку mods/mods/.

Переключение сервера на tModLoader

В параметрах сервера выберите версию или тип запуска tModLoader, затем выполните переустановку/обновление серверных файлов, если это требуется выбранной сборкой.

После переключения запустите сервер один раз без модов. Это позволит создать базовые папки и проверить, что сервер запускается именно как tModLoader, а не как ванильная Terraria.

Если после переключения в корневой директории смешались файлы ванильной Terraria и tModLoader, сервер может падать при запуске. В таком случае нужна чистая установка tModLoader с сохранением резервной копии миров.

Установка .tmod-файлов

Моды tModLoader имеют расширение:

.tmod

Загрузите файлы модов в папку:

mods/

Пример:

mods/CalamityMod.tmod
mods/ThoriumMod.tmod
mods/RecipeBrowser.tmod

Файлы .tmod не нужно распаковывать.

enabled.json

Файл:

mods/enabled.json

Он определяет, какие моды будут включены при запуске сервера.

Корректный формат:

[
  "CalamityMod",
  "ThoriumMod",
  "RecipeBrowser"
]

Имена в enabled.json должны соответствовать внутренним именам модов. На Linux регистр важен: CalamityMod и calamitymod считаются разными именами.

Неправильный формат enabled.json

Не используйте такой формат:

{
  "EnabledMods": [
    "CalamityMod",
    "ThoriumMod"
  ]
}

Для tModLoader-сервера нужен массив:

[
  "CalamityMod",
  "ThoriumMod"
]

Также нельзя оставлять запятую после последнего мода:

[
  "CalamityMod",
  "ThoriumMod",
]

Как получить правильный enabled.json

Надёжный способ — собрать список модов на клиенте tModLoader:

Установите нужные моды в tModLoader на своём ПК.
Включите только те моды, которые должны быть на сервере.
Найдите локальный файл enabled.json.
Загрузите этот файл на сервер в mods/enabled.json.
Загрузите соответствующие .tmod-файлы в mods/.

Так меньше риск ошибиться во внутренних именах модов.

Совместимость версий

Версия tModLoader на сервере, версия tModLoader у игроков и версии модов должны совпадать.

Если у игрока другая версия мода или отсутствует мод из enabled.json, подключение завершится ошибкой.

При обновлении tModLoader проверьте, что все установленные моды поддерживают новую версию. Крупные моды могут обновляться позже самой платформы.

Зависимости модов

Некоторые моды требуют дополнительные библиотеки или другие моды.

Если зависимость отсутствует, сервер не загрузит мод и покажет ошибку в консоли или логах.

Перед установкой проверьте страницу мода и добавьте все обязательные зависимости в mods/ и enabled.json.

Моды и существующий мир

Перед изменением списка модов сделайте резервную копию мира:

saves/Worlds/YourWorld.wld

Особенно рискованно добавлять или удалять моды, которые меняют:

биомы;
генерацию мира;
руды и блоки;
NPC и боссов;
предметы, аксессуары и инвентарь;
структуры и сундуки.

Для крупных модов и модпаков лучше создавать новый мир после установки модов.

Моды генерации мира

Моды, добавляющие новые биомы, руды или структуры, должны быть включены до создания мира.

Если такой мод добавить в уже созданный мир, новый контент может не появиться в старых областях карты или появиться только частично.

Для корректной генерации создайте новый мир с нужным набором модов.

Удаление мода

Для отключения мода удалите его внутреннее имя из enabled.json:

[
  "CalamityMod",
  "RecipeBrowser"
]

Файл .tmod при этом можно оставить в папке mods/. Сервер не будет загружать мод, если его нет в enabled.json.

Для полного удаления остановите сервер, удалите имя мода из enabled.json и удалите соответствующий файл .tmod.

Обновление модов

Остановите сервер.
Сделайте резервную копию мира.
Замените старый файл .tmod новой версией.
Проверьте enabled.json.
Запустите сервер и проверьте консоль.

Если сервер не запускается после обновления, верните старый файл .tmod или временно уберите мод из enabled.json.

Проверка запуска

После перезапуска проверьте консоль. tModLoader выводит информацию о загружаемых модах и ошибках.

Типовые причины ошибки:

мод отсутствует в папке mods/;
мод есть в mods/, но отсутствует в enabled.json;
в enabled.json указано неправильное внутреннее имя;
ошибка JSON-синтаксиса;
не хватает зависимости;
мод не поддерживает текущую версию tModLoader;
файлы загружены во вложенную папку mods/mods/.

Если сервер не видит моды

проверьте, что сервер запущен именно на tModLoader;
проверьте, что .tmod-файлы находятся прямо в mods/;
проверьте формат enabled.json;
проверьте регистр букв в именах модов;
убедитесь, что нет вложенной папки mods/mods/;
проверьте лог tModLoader.

Если игрок не может подключиться

у игрока другая версия tModLoader;
у игрока другая версия одного из модов;
на клиенте включён лишний мод;
на клиенте отсутствует мод, который включён на сервере;
мир создан с модом, которого больше нет на сервере.

Для подключения набор модов и их версии должны совпадать с сервером.

Если мир не загружается после удаления мода

Верните мод обратно в mods/ и enabled.json, затем запустите сервер.

Если мир запускается только с этим модом, значит сохранение зависит от его контента. В таком случае удаление мода без потери данных невозможно или требует отдельной ручной чистки мира.

Краткая шпаргалка

Сервер должен быть:
tModLoader

Папка модов:
mods/

Формат мода:
.tmod

Файл включённых модов:
mods/enabled.json

Правильный enabled.json:
[
  "ModName1",
  "ModName2"
]

Файлы мира:
saves/Worlds/*.wld

Моды распаковывать:
не нужно

Что не делать

не загружать .tmod на ванильный сервер Terraria;
не использовать формат {"EnabledMods": [...]} для enabled.json;
не оставлять запятую после последнего мода в JSON;
не смешивать файлы ванильной Terraria и tModLoader без чистой установки;
не удалять моды из активного мира без резервной копии;
не переносить модовый мир на ванильный сервер без проверки;
не загружать моды во вложенную папку mods/mods/.

Статьи категории