Установка модов Don't Starve Together — сервер и клиент

Моды для Don't Starve Together на Dedicated Server устанавливаются в два шага: сначала сервер скачивает нужные Workshop-моды по их ID, затем ты активируешь и настраиваешь их в подходящем файле modoverrides.lua. Важно обрабатывать Master- и Caves-шард отдельно и после изменений всегда проверять перезапуск.

Требования

Тебе нужен доступ к конфигурационным файлам твоего сервера Don't Starve Together, и перед изменениями сервер стоит остановить. В game-serverhosting разумный рабочий процесс такой: отредактировать файлы, сохранить изменение, перезапустить сервер, проверить лог и только после этого добавлять следующие моды. Так остается понятно, какой мод отвечает за проблемы.

Официальная справка по работе Dedicated Server — это руководство Klei на форуме разработчика: документация на forums.kleientertainment.com. Для модов также важна соответствующая страница Steam Workshop, потому что там указаны автор мода, Workshop-ID, зависимости и Hinweise zur Server- oder Client-Nutzung.

Если ты сначала настраиваешь сам сервер, подойдет внутреннее руководство арендовать и настроить сервер Don't Starve Together. Для похожих рабочих процессов с модами в других играх хорошими точками сравнения будут установка модов Factorio на сервер и установка модов V Rising с BepInEx.

Как найти Workshop-ID

У каждого мода в Steam Workshop есть числовой ID. Ты найдешь его в URL страницы Workshop, чаще всего как значение после id=. Пример: в URL вроде steamcommunity.com/sharedfiles/filedetails/?id=378160973 числом 378160973 будет Workshop-ID.

Записывай только те моды, которые действительно хочешь использовать на сервере. Многие удобные моды работают только на стороне клиента и не должны попадать в конфигурацию сервера. Другие моды меняют мир, баланс, интерфейс или инвентарь, и их нужно активировать на сервере. Поэтому всегда проверяй описание мода и примечания автора.

Настройка модов через Workshop

Внеси моды, которые сервер должен скачать, в dedicated_server_mods_setup.lua. Этот файл является списком загрузки. Он еще не активирует моды в твоем мире, а сначала лишь обеспечивает, чтобы Dedicated Server знал содержимое Workshop.

-- Моды, которые нужно скачать
ServerModSetup("378160973")    -- Global Positions
ServerModSetup("462434129")    -- Wormhole Marks
ServerModSetup("458587300")    -- Season Clock
ServerModSetup("375850593")    -- Extra Equip Slots

Следи за корректными кавычками, не добавляй лишние пробелы в ID и не делай дублирующихся записей. Комментарии после строк полезны, потому что позже ты сразу увидишь, какой ID относится к какому моду.

Активация и настройка модов

Моды активируются в modoverrides.lua. Этот файл задает, какие скачанные Workshop-моды активны в мире. На сервере с Caves тебе нужна конфигурация для Master и Caves, потому что оба шарда могут использовать собственные настройки.

В modoverrides.lua (для Master и Caves):

return {
  ["workshop-378160973"] = { enabled = true },
  ["workshop-462434129"] = { enabled = true },
  ["workshop-458587300"] = {
    enabled = true,
    configuration_options = {
      clock_style = "analog"
    }
  }
}

Ключ состоит из workshop- плюс Workshop-ID. enabled = true активирует мод. Если мод поддерживает собственные параметры, они указываются в configuration_options. Какие параметры допустимы, нельзя сказать универсально: это зависит от конкретного мода. Поэтому используй только те параметры, которые указаны в описании Workshop, в существующих примерах конфигурации или в конфигурации, созданной самой игрой.

Популярные моды

Следующая таблица сохраняет имеющиеся примеры модов. Это не список рекомендаций с обещаниями производительности или стабильности, а практичная отправная точка для часто используемых типов модов.

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

Клиентские моды vs. серверные моды

• Серверные моды: должны быть установлены на сервере
• Клиентские моды: должны быть установлены у игрока
• С обеих сторон: должны быть установлены у обоих

Большинство модов работают с обеих сторон — игроки автоматически скачивают их при подключении. Но все равно не стоит предполагать, что каждый мод будет работать без дополнительных действий. Некоторые моды требуют определенных клиентских настроек, другие предназначены только для локальных функций удобства и не должны попадать в серверные файлы.

Проверка результата

После изменения перезапусти сервер и наблюдай за запуском. Чистая проверка состоит из трех частей: сервер запускается без Lua-ошибок, мир доступен, и игрок может подключиться, не застревая в цикле загрузки мода или ошибки.

Затем проверь в игре, действительно ли нужная функция активна. Например, с Global Positions стоит посмотреть, появляются ли позиции игроков на карте как ожидается. Для Caves дополнительно протестируй переход между поверхностью и пещерами, потому что ошибка часто видна только в одном шарде.

Устранение проблем

• Моды не загружаются: проверь Workshop-ID
• Краш: отключай моды по одному
• Caves-моды: modoverrides.lua в ОБОИХ папках шардов!

Если после нового мода сервер больше не запускается, сначала убери последнюю измененную строку из modoverrides.lua и запусти снова. Если ошибка остается, проверь также dedicated_server_mods_setup.lua, особенно скобки, кавычки и запятые в Lua-таблицах.

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

При проблемах с Caves самая частая причина — разная конфигурация между Master- и Caves-шардом. Не копируй настройки вслепую, а проверь, предназначен ли мод для обоих шардов. Моды генерации мира часто относятся к другой категории, чем чистые интерфейсные или удобные моды.

Проверка, ограничения и безопасный откат

Руководство «Установка модов Don't Starve Together — сервер и клиент» относится к типу сервера, описанному в статье, и к состоянию версий, видимому на момент проверки. Названия меню, доступные версии, совместимость модов или плагинов и необходимые ресурсы могут измениться после обновлений. Поэтому не переноси значения без проверки на другую версию игры, загрузчика или сервера.

Перед изменениями мира, сохранения, конфигурации или расширений создай резервную копию затронутых файлов. После этого меняй только один связанный шаг и проверяй его с той же версией клиента и сервера, с которой позже хочешь играть.

Успешный одиночный тест не является гарантией производительности или доступности. Размер мира, моды, плагины, число игроков, сетевой маршрут и одновременная нагрузка могут изменить результат. Документируй версию, изменение и результат теста, чтобы потом понимать причины отклонений.

FAQ

Нужно ли перезапускать сервер после каждого изменения мода?

Да. Изменения в dedicated_server_mods_setup.lua и modoverrides.lua надежно вступают в силу только после перезапуска сервера.

Куда вносить Workshop-ID?

Чистый список загрузки указывается в dedicated_server_mods_setup.lua. Затем мод активируется в modoverrides.lua через ключ workshop-ID, например workshop-378160973.

Нужен ли такой же modoverrides.lua для Caves?

Если твой сервер использует Caves, нужно учитывать конфигурацию модов для обоих шардов. Во многих настройках нужен один modoverrides.lua в папке Master и еще один в папке Caves.

Игроки скачивают серверные моды автоматически?

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

Что делать, если мод роняет сервер?

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