Don't Starve Together: кластер, Master и Caves и токен Klei

Don’t Starve Together — кооперативная выживалка, в которой мир состоит из двух частей: поверхность и пещеры. На сервере они называются шардами: Master (поверхность) и Caves (пещеры). Вместе они образуют кластер, и кластер подписывается одним токеном, который выдаёт Klei. Без токена сервер не стартует: это требование самой игры, а не особенность хостинга.

В этой статье разберём, откуда берётся токен, как устроен кластер на диске, какие файлы редактировать и как выдать права администраторам. Если вы только знакомитесь с серверами, сначала прочитайте про общие принципы в статье Доктор сервера: почему не запускается.

Коротко

Получите токен кластера в аккаунте Klei, сохраните его в файл cluster_token.txt в папке кластера, задайте имя и параметры в cluster.ini и отдельный server.ini для Master и Caves. Без токена сервер не стартует. Админов и белый список ведут в adminlist.txt и whitelist.txt в папке кластера.

Что нужно до начала

Аккаунт Klei. Токен выдаётся для аккаунта, на котором вы подтверждаете владение кластером.
Токен кластера. Его создают в личном кабинете Klei или через клиент игры, в зависимости от версии. Содержимое токена — это длинная строка, которую нельзя показывать игрокам.
Понимание шардов. Master и Caves запускаются как два процесса, каждый со своими настройками. Если вы поменяли параметр для одного шарда, второй о нём не знает.

Инструкции по получению токена меняются вместе с интерфейсом Klei, поэтому ориентируйтесь на текущую страницу аккаунта и на раздел «Токен» в клиенте. Сверяйте имена файлов с документацией вашей версии сервера.

Шаги

Получите токен. Войдите в аккаунт Klei и создайте токен кластера. Скопируйте его без пробелов и переносов строк.
Создайте папку кластера. На сервере создайте папку с именем кластера, например MyCluster, внутри папки DoNotStarveTogether. Внутри будут файлы кластера и две подпапки для шардов.
Сохраните токен. Создайте файл cluster_token.txt в корне папки кластера и вставьте в него токен. Файл должен содержать только токен, без комментариев.
Настройте cluster.ini. Файл задаёт общие параметры кластера: имя, режим игры, количество игроков, пароль и паузу. Пример структуры:
Конфиг
```
[GAMEPLAY]
game_mode = survival
max_players = 6
pvp = false
pause_when_empty = true

[NETWORK]
cluster_name = Наш кластер
cluster_password = придумайте-пароль
cluster_description = Сервер для друзей

[MISC]
console_enabled = true

[SHARD]
shard_enabled = true
bind_ip = 0.0.0.0
master_ip = 127.0.0.1
master_port = 10888
cluster_key = общий-ключ-кластера
```
Имена ключей взяты из распространённых гайдов по DST, а не из первоисточника. Перед запуском сверьте их с официальной документацией Klei для вашей версии. Значения подбирайте под себя: max_players не должен превышать лимит, который вы задали для сервера.
Создайте шарды. В папке кластера создайте две подпапки: Master и Caves. В каждой положите свой server.ini. Для Master задаются порт, is_master = true, а для Caves — is_master = false и другой порт. Порты шардов должны различаться, иначе второй процесс не запустится. Сервер DST по умолчанию слушает UDP 10999, а каждому шарду нужен свой порт: проверьте, что все они открыты в разделе «Сеть».
Добавьте администраторов. В файле adminlist.txt в корне кластера перечислите идентификаторы KU тех, кому нужны права. Идентификатор берётся в игре у каждого игрока. Белый список игроков, если вы его используете, ведётся в whitelist.txt.
Запустите кластер. Запустите сервер в панели и дождитесь статуса «Работает». Сначала стартует Master, затем Caves: подключаться можно, когда оба шарда в сети.

Пример: кластер для четырёх друзей

Допустим, вы играете вчетвером в выживание. В cluster.ini ставите max_players = 4, пароль кластера, и pause_when_empty = true, чтобы мир не шёл, когда никого нет. Администраторы — вы и один помощник, их идентификаторы в adminlist.txt. Для Caves задаёте другой порт, чем у Master, и тот же cluster_key, иначе шарды не найдут друг друга. Перед приглашением друзей зайдите сами, проверьте, что оба шарда видны в списке, и только потом передайте им пароль.

Симптом → причина → решение

Симптом	Частая причина	Что сделать
Сервер не стартует без ошибок	Нет или пустой `cluster_token.txt`	Создайте токен заново и вставьте без пробелов
Caves не запускается	Порт совпадает с Master	Поставьте другой `master_port` и порт в `server.ini`
Пещеры не подключаются к поверхности	Разный `cluster_key` или `master_ip`	Сверьте общий ключ и IP в обоих шардах
Друзья не видят сервер	Порты не открыты в «Сеть»	Проверьте порты шардов в разделе «Сеть»
Права админа не работают	Неверный идентификатор в `adminlist.txt`	Возьмите KU-идентификатор у игрока заново
Изменения не применились	Сервер не перезапущен	Остановите и запустите кластер

Как сделать в панели EGN: по шагам

Кластер DST состоит из нескольких файлов, поэтому порядок работы в панели важен. Ниже — последовательность, которая не даёт потерять настройки.

Создайте копию в «Бэкапы». Перед любой правкой кластера нажмите «Создать копию». Это касается и токена: если вы случайно удалите cluster_token.txt, восстановление из копии вернёт его.
Проверьте папку кластера в «Файлах». Убедитесь, что есть cluster_token.txt, cluster.ini, папки Master и Caves, и что в каждой подпапке лежит свой server.ini.
Отредактируйте общие параметры. В cluster.ini меняйте имя, пароль и лимит игроков. Не трогайте cluster_key, если уже играете: он должен совпадать у обоих шардов.
Отредактируйте параметры шардов. Порты и is_master задаются в server.ini каждого шарда. Меняйте их по одному и проверяйте, что порты не совпадают.
Запустите кластер и посмотрите статус. Сначала поднимается Master, затем Caves. Оба шарда должны показывать готовность в консоли. Если один из них не стартует, смотрите его последние строки.
Проверьте вход сами. Зайдите на поверхность и в пещеры: переход между ними должен работать. Если пещеры недоступны, проверьте master_ip и cluster_key.

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

Оба шарда в статусе «Работает», и один не перезапускается за другим.
Вы видите сервер в списке по имени из cluster.ini.
Администраторы из adminlist.txt получили права (проверьте одной командой в игре).
Переход из мира в пещеры работает.
В «Бэкапах» есть свежая копия после правок.

Частые ошибки

Токен попал в чат или в скриншот. Токен даёт право управлять кластером, поэтому держите его в секрете и не публикуйте файлы кластера.
Один cluster.ini на два шарда. Общие параметры кластера в cluster.ini, а параметры каждого шарда в его server.ini. Смешивание даёт непредсказуемое поведение.
Моды прописаны в одном шарде. По гайдам по DST моды настраиваются для каждого шарда отдельно, поэтому проверьте оба.
Пароль на сервере и кластере. Пароль кластера защищает вход в кластер, а не доступ к файлам. Для файлов используйте SFTP и не давайте лишних прав.
Ошибки в пути. Папка кластера должна лежать там, где её видит сервер. Копировать кластер с другой машины без правки путей нельзя.

Итог

Кластер Don’t Starve Together держится на токене Klei и трёх уровнях настроек: cluster_token.txt для доступа, cluster.ini для общих параметров и server.ini для каждого шарда. Соблюдайте порты, одинаковый cluster_key и администраторов в adminlist.txt, и кластер поднимется с первого раза. Общий порядок работы с файлами сервера и SFTP описан в статье Файлы сервера: загрузка папкой, поиск и SFTP, а бэкапы кластера — в статье Бэкапы сервера: расписание и восстановление.

Вопросы и ответы

Без чего не стартует сервер Don’t Starve Together?

Без токена кластера, который выдаёт Klei. Его кладут в cluster_token.txt в папке кластера.

Что такое Master и Caves?

Master — это поверхность мира, Caves — пещеры. Каждый шард запускается отдельно со своим server.ini, а вместе они образуют кластер.

Где задать администраторов сервера DST?

В файле adminlist.txt в корне кластера. Внесите туда KU-идентификаторы игроков.

Почему Caves не подключается к Master?

Чаще всего не совпадает cluster_key или master_ip, либо два шарда используют один порт. Сверьте параметры в обоих server.ini.

Бесплатный сервер на EGN Free — egnetwork.ru