Моды ARK Ascended на сервере через CurseForge

Чтобы добавить моды на выделенный сервер ARK: Survival Ascended, найдите числовой project ID каждого мода в CurseForge, добавьте их в строку запуска как -mods=id1,id2,id3 и перезапустите сервер. Сервер сам скачивает моды из CurseForge при запуске, а игроки, которые заходят, получают те же моды автоматически - никому не нужно ни на что подписываться или копировать файлы вручную. Вот и весь механизм, и это настоящее улучшение по сравнению с Survival Evolved и его Steam Workshop. Ломается по-прежнему всё вокруг него: неправильный ID, мод, который не обновили после патча, два мода, которые дерутся за одну и ту же постройку, и мод, удалённый из живого сохранения и забравший с собой полбазы.

Базовая настройка сервера - установка, порты, строка запуска - описана в руководстве по установке ARK: Survival Ascended. Эта статья только о модах.

Как работают моды на Ascended#

Моды для Ascended публикуются в CurseForge, и каждый мод - это проект CurseForge с числовым project ID. Серверу передают список этих ID. При запуске он запрашивает каждый из них у CurseForge, скачивает всё отсутствующее или устаревшее и загружает. Подключающийся клиент сравнивает свой список модов с серверным и перед входом скачивает всё, чего ему не хватает.

У такой схемы есть три следствия, которые полезно знать до первого мода:

• Серверу при запуске нужен исходящий доступ в интернет к CurseForge. Если CurseForge недоступен или медленный, запуск подвисает или моды не скачиваются. Лог в итоге об этом сообщит.
• Первый запуск после изменения модов медленный, и первый вход у всех тоже. Сначала мод скачивает сервер, потом каждый клиент. Меняйте моды перед вечерней игрой, а не во время неё.
• Моды кроссплатформенные по замыслу. Поддержку модов в Ascended делали так, чтобы ими могли пользоваться и игроки на консолях, поэтому сервер с модами не становится автоматически сервером только для PC. Доступен ли конкретный мод на каждой платформе, зависит от самого мода и его одобрения, так что если в вашей группе есть консольные игроки, смотрите страницу мода.

Списка разрешённых модов на стороне сервера тоже нет. Любой мод из списка -mods загружается; любой мод не из списка - нет. Игрок не может принести мод, которого нет на сервере.

Как найти project ID мода#

Project ID - это число, а не название мода и не slug из его URL. На странице мода в CurseForge он показан в боковой панели About Project, с подписью Project ID. Скопируйте это число.

Держите небольшой текстовый файл, где каждому ID сопоставлены название мода и причина, по которой вы его поставили. Через полгода -mods=928793,929420,931874 ничего вам не скажет, а тот, кто унаследует сервер, скажет спасибо.

Как добавить моды в строку запуска#

Список модов - это аргумент запуска. Он идёт после строки запроса через пробел, ID разделяются запятыми без пробелов между ними:

TheIsland_WP?listen?SessionName=Longship?Port=7777?QueryPort=27015 -mods=928793,929420,931874 -log

У хостера с панелью строка запуска собирается из полей на вкладке Startup, и для списка модов обычно есть отдельное поле. Вставьте туда ID через запятую.

Шаги по порядку:

1. Сделайте резервную копию сохранения. Мод становится изменением мира, как только им кто-нибудь воспользуется.
2. Штатно остановите сервер.
3. Добавьте новый ID в конец списка.
4. Запустите сервер и следите за логом, пока мод не скачается и сервер не начнёт принимать игроков.
5. Зайдите, проверьте, что мод на месте, и поиграйте с ним вечер, прежде чем добавлять следующий.

Некоторые сборки читают также строку ActiveMods= в GameUserSettings.ini. Используйте один способ, а не оба. Аргумент запуска - тот, что задокументирован и который показывают панели, поэтому полагайтесь на него.

Порядок загрузки

Порядок ID в списке - это порядок загрузки. Он важен только тогда, когда два мода меняют одно и то же - одну постройку, одно существо, одну таблицу лута, - и в этом случае побеждает один из них. Как именно это работает, гадать не стоит: авторы крупных модов обычно пишут на странице, загружать ли их мод первым или последним, и это указание ценнее любого общего правила. Если два мода конфликтуют и ни один ничего не говорит, попробуйте оба порядка на тестовом сохранении и оставьте тот, при котором всё работает. В статье порядок загрузки модов эта идея разобрана для разных игр.

Моды карт#

Пользовательские карты - тоже моды. Чтобы запустить такую карту, нужно два изменения, а не одно:

1. Добавьте project ID мода карты в -mods=.
2. Замените имя карты в начале строки запуска на имя уровня этой карты.

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

Мод карты - самый большой вид мода. Это целый мир, и первое скачивание велико и для сервера, и для каждого игрока. У пользовательской карты ещё и свой профиль производительности: одни легче The Island, другие намного тяжелее. Прежде чем переводить на неё сообщество, погоняйте её несколько вечеров и следите за памятью в течение сессии.

Настройка модов#

Большинство модов с настройками читают их из ini-файлов самого сервера, из секции, названной по имени мода. Обычно это секция в GameUserSettings.ini, иногда в Game.ini. Имя секции и ключи даёт страница мода или его документация.

[ServerSettings]XPMultiplier=2.0[SomeModName]SomeSetting=TrueAnotherSetting=50

Действуют те же правила, что и для собственных настроек игры, описанных в руководстве по GameUserSettings.ini и Game.ini в ARK: останавливайте сервер перед правкой, потому что штатное выключение перезаписывает GameUserSettings.ini; пишите ключи точно, потому что опечатка молча игнорируется; и кладите секцию в тот файл, который ожидает мод. Некоторые моды принимают настройки и в игре через меню администратора, которое записывает их обратно в ini.

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

Какие моды стоят памяти и CPU#

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

Закономерность такая: стоимость мода - это в основном то, что игроки с ним делают, а не сам мод. Набор построек в день установки не стоит ничего. Через три месяца, когда у каждого по замку, он стоит несколько гигабайт. Заложите это в бюджет с самого начала; в статье сколько RAM нужно серверу ARK есть базовая цифра, к которой это нужно прибавить.

Среди популярных модов удобства на Ascended - моды подзорной трубы вроде Awesome Spyglass!, переработки построек и хранилищ вроде Cybers Structures QoL+ и Utilities Plus, а также моды для возврата вещей после смерти. Названия и доступность меняются; прежде чем строить сервер вокруг мода, проверьте, что его поддерживают и недавно обновляли.

Как обновлять моды, не ломая сервер#

Моды обновляются независимо от игры, а обновления игры ломают моды. Эти два факта и определяют обслуживание сервера с модами.

При запуске сервер получает текущую версию каждого мода. Поэтому перезапуск - это ещё и обновление модов, хотели вы того или нет. Клиенты получают новую версию при следующем входе.

Опасный день - патч игры. Wildcard выпускает обновление, сервер обновляется, и каждый мод, который касается изменённого, может не загрузиться или ронять сервер, пока автор не выпустит исправление. Одни моды чинят за часы, другие за дни, третьи заброшены. Оборонительный порядок действий:

1. Не позволяйте серверу с модами автоматически обновлять игру в день патча. Обновляйте его осознанно, после того как проверите, что важные для вас моды обновлены под новую версию.
2. Делайте резервную копию перед каждым обновлением игры и перед каждым изменением модов.
3. Если мод сломан, а автор его не починил, решите, сможете ли вы несколько дней обойтись без него. Для мода интерфейса - обычно да. Для набора построек, из которого сделана половина баз, - нет: если можете, оставьте сервер на старой сборке или закройте его, пока не выйдет исправление.

Статья что делать, когда обновление мода всё сломало - общий порядок действий на такое утро, а в статье как держать сервер с модами в чистоте разобраны привычки, благодаря которым такое случается реже.

Удаление мода из живого сохранения#

Удаление мода - самое разрушительное, что можно сделать с сервером ARK, если не считать удаления самого сервера. Всё, что определял мод, - постройки, предметы, существа - хранится в сохранении как ссылка на мод. Уберите мод, и ссылки будут указывать в пустоту:

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

Если удалить мод всё же нужно:

1. Объявите об этом с датой, чтобы люди успели вынести вещи из хранилищ мода и уйти с фундаментов мода.
2. Сделайте резервную копию непосредственно перед удалением и убедитесь, что она восстанавливается. Как это сделать, объясняется в статье проверьте восстановление до того, как оно понадобится.
3. Уберите ID из -mods=, запустите сервер и проверьте лог и мир.
4. Если сохранение не загружается, восстановите копию и запланируйте удаление на вайп.

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

Моды в кластере#

Каждая карта в кластере должна работать с одним и тем же списком модов в одном и том же порядке. Предмет или существо из мода, который карта назначения не загружает, не переживёт перенос. Если одной карте нужен мод, который не нужен остальным, - например, мод карты, - Ascended может загружать на других серверах данные мода без его содержимого через список пассивных модов (-passivemods=), и предметы этого мода остаются целыми при переносе. Поведение менялось с обновлениями, так что после каждого изменения проверяйте перенос. Остальное - в статье кластеры ARK и переходы между серверами.

ARK с модами на панели#

В RE:NODE список модов указывается в аргументах запуска на вкладке Startup, а моды сервер скачивает из CurseForge сам, так что загружать ничего не нужно. Настройки модов в ini правятся во встроенном в браузер файловом менеджере или по SFTP. Консоль показывает ход скачивания в реальном времени - это самый быстрый способ отличить медленный первый запуск от зависшего. Слоты резервных копий есть в каждом тарифе, и это покрывает backup перед каждым изменением, о котором статья напоминает снова и снова. Списка разрешённых модов и установщика модов в один щелчок в RE:NODE нет - моды выбираете вы. Отдельной строки в каталоге у ARK нет, так что актуальные варианты смотрите в списке игровых серверов.

Если сервер с модами не работает#

Сервер запускается, но мода нет. Неправильный ID (file ID вместо project ID), опечатка в списке или пробел после запятой. Поищите в логе строку скачивания для этого ID.

Запуск висит несколько минут без вывода. Скачиваются моды. При первом запуске после изменения дайте ему десять минут. Если он так и не сдвинется, уберите самый новый ID и запустите снова.

Сервер падает при запуске после обновления игры. Мод, который не обновили под новую сборку. Убирайте моды по одному, начиная с недавно обновлённых, пока сервер не запустится.

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

Ванильная настройка перестала работать. Её переопределяет мод. Проверьте собственные настройки мода.

За ночь исчезло полбазы. Мод был удалён или не загрузился, и его постройки пропали. Остановите сервер и восстановите последнюю копию, сделанную до изменения, прежде чем кто-нибудь начнёт играть в повреждённом мире.

FAQ#

Нужно ли игрокам вручную ставить моды ARK, чтобы зайти на сервер?

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

Где найти ID мода ARK?

На странице мода в CurseForge, в панели About Project, с подписью Project ID. Это число. File ID на вкладке Files - это версии, а не проекты, и они не подойдут.

Можно ли добавить мод в существующий мир?

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

Сколько модов может держать сервер ARK?

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

Получат ли моды игроки на консолях?

Система модов Ascended кроссплатформенная, так что в принципе да. Отдельные моды могут быть доступны не на всех платформах; прежде чем добавлять мод на сервер с консольными игроками, проверьте его страницу.