Добавление модов

Это руководство описывает установку модов на выделенный сервер Core Keeper: где лежат серверные моды, как устроена папка Mods, чем отличается автоматическая установка через панель от ручной загрузки и почему мод может не примениться после перезапуска.

Core Keeper использует встроенную поддержку модов через mod.io. На выделенном сервере моды размещаются внутри директории серверной сборки, а не в папке сохранений мира.

Где скачивать моды

Основной источник модов для Core Keeper:

• mod.io — Core Keeper

Перед установкой проверяйте на странице мода:

• поддерживает ли мод dedicated server;
• нужен ли этот мод игрокам на клиенте;
• есть ли зависимости, например библиотеки или CoreLib-модули;
• подходит ли версия мода под текущую версию Core Keeper.

Куда устанавливаются моды

Папка серверных модов:

CoreKeeperServer_Data/StreamingAssets/Mods/

Итоговая структура должна выглядеть примерно так:

CoreKeeperServer_Data/
  StreamingAssets/
    Mods/
      ChatCommands/
        ...
      CoreLib/
        ...
      SomeOtherMod/
        ...

Каждый мод должен лежать в собственной подпапке внутри Mods. Не смешивайте файлы разных модов в одной общей папке.

Установка через панель

В панели доступен раздел Core Keeper Mods, используйте его как основной способ установки.

Панель берёт моды из каталога mod.io, скачивает архив, распаковывает его и помещает файлы в серверную папку:

CoreKeeperServer_Data/StreamingAssets/Mods/

После установки мод появится в списке установленных модов. Сервер нужно перезапустить, чтобы Core Keeper заново прочитал содержимое папки Mods.

Если мод имеет зависимости, устанавливайте их отдельно. Зависимость — это такой же мод, который должен лежать в своей подпапке внутри Mods.

Ручная установка через SFTP

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

1. Скачайте мод с mod.io.
2. Распакуйте архив.
3. Создайте отдельную папку для мода внутри CoreKeeperServer_Data/StreamingAssets/Mods/.
4. Загрузите распакованные файлы мода в эту папку.
5. Перезапустите сервер.

Пример:

CoreKeeperServer_Data/StreamingAssets/Mods/ChatCommands/
CoreKeeperServer_Data/StreamingAssets/Mods/CoreLib/
CoreKeeperServer_Data/StreamingAssets/Mods/AutoDoors/

Название папки лучше делать таким же, как название мода на mod.io. Это упрощает дальнейшее обслуживание и помогает не перепутать зависимости.

Неправильная структура

Частая ошибка — загрузить архив так, что внутри появляется лишний уровень папок.

Плохо:

CoreKeeperServer_Data/StreamingAssets/Mods/ChatCommands/ChatCommands/
  mod files...

Плохо:

CoreKeeperServer_Data/StreamingAssets/Mods/
  ChatCommands.zip
  CoreLib.zip

Нормально:

CoreKeeperServer_Data/StreamingAssets/Mods/ChatCommands/
  mod files...

CoreKeeperServer_Data/StreamingAssets/Mods/CoreLib/
  mod files...

Если сервер не видит мод, сначала проверьте именно структуру папок.

Зависимости

Многие моды Core Keeper требуют дополнительные библиотеки. Например, один мод может требовать CoreLib или отдельный модуль CoreLib.

Зависимости устанавливаются так же, как обычные моды:

CoreKeeperServer_Data/StreamingAssets/Mods/CoreLib/
CoreKeeperServer_Data/StreamingAssets/Mods/CoreLib.RewiredExtension/
CoreKeeperServer_Data/StreamingAssets/Mods/SomeModThatNeedsCoreLib/

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

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

Не каждый мод достаточно поставить только на сервер.

• Серверные моды — работают на стороне сервера и не требуют установки у игроков;
• Клиентские моды — нужны только игроку и обычно не устанавливаются на сервер;
• Сервер + клиент — должны быть установлены и на сервере, и у каждого игрока.

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

Конфигурация модов

Некоторые моды создают конфигурационные файлы только после первого успешного запуска.

Если конфигурации нет сразу после загрузки файлов, запустите сервер с модом один раз, дождитесь полной загрузки и проверьте файлы снова.

Конкретный путь к конфигам зависит от мода. Обычно автор указывает его на странице мода.

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

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

Безопасный порядок:

1. сохранить копию старой папки мода;
2. удалить старую папку мода из Mods;
3. загрузить новую версию;
4. проверить зависимости;
5. перезапустить сервер.

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

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

Чтобы отключить мод, удалите его папку из:

CoreKeeperServer_Data/StreamingAssets/Mods/

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

После удаления сервер нужно перезапустить.

Служебный manifest

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

Например:

corekeeper_mods.txt

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

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

• мод лежит не в CoreKeeperServer_Data/StreamingAssets/Mods/;
• внутри папки мода есть лишняя вложенная папка;
• загружен архив .zip, а не распакованные файлы;
• не установлена зависимость;
• мод рассчитан только на клиентскую часть;
• версия мода не подходит под текущую версию Core Keeper;
• мод установлен на сервер, но нужен ещё и игрокам;
• сервер не был перезапущен после установки.

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

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

Рекомендации

• устанавливайте зависимости до запуска основного мода;
• не обновляйте сразу много модов без резервной копии;
• после обновления Core Keeper проверяйте, обновились ли используемые моды;
• для закрытого сервера держите у всех игроков одинаковый набор клиентских модов;
• если моды ставятся через панель, не смешивайте автоматическую установку с ручным редактированием manifest-файла.