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

Это руководство описывает установку и управление модами на выделенном сервере Factorio. Моды устанавливаются вручную через папку mods/ и управляются файлом mods/mod-list.json.

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

mods/
mods/mod-list.json
saves/

mods/ — папка, куда загружаются ZIP-файлы модов;
mods/mod-list.json — список включённых и отключённых модов;
saves/ — сохранения мира, которые могут зависеть от установленных модов.

Формат модов Factorio

Моды Factorio устанавливаются в виде ZIP-файлов. Распаковывать их не нужно.

Корректный пример:

mods/ExampleMod_1.2.3.zip

Некорректные варианты:

mods/ExampleMod_1.2.3/
mods/ExampleMod_1.2.3.zip.zip
mods/ExampleMod/ExampleMod_1.2.3.zip

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

Остановите сервер.
Скачайте нужный мод с mods.factorio.com.
Загрузите файл .zip в папку mods/.
Проверьте или отредактируйте mods/mod-list.json.
Запустите сервер.

Если мод загружен в mods/, но не включён в mod-list.json, сервер не будет использовать его при запуске.

mod-list.json

Файл:

mods/mod-list.json

Пример:

{
  "mods": [
    {
      "name": "base",
      "enabled": true
    },
    {
      "name": "ExampleMod",
      "enabled": true
    },
    {
      "name": "AnotherMod",
      "enabled": false
    }
  ]
}

base — базовый мод Factorio. Его нужно оставить включённым.

Как правильно указать имя мода

ZIP-файл содержит название мода и версию:

ExampleMod_1.2.3.zip

В mod-list.json указывается имя мода без версии и без .zip:

{
  "name": "ExampleMod",
  "enabled": true
}

Если имя в mod-list.json не совпадает с внутренним именем мода, сервер не загрузит мод корректно.

Включение и отключение модов

Включить мод:

{
  "name": "ExampleMod",
  "enabled": true
}

Отключить мод без удаления ZIP-файла:

{
  "name": "ExampleMod",
  "enabled": false
}

Отключение через enabled: false удобнее, чем удаление файла, если нужно проверить конфликт или временно убрать мод из запуска.

Добавление нескольких модов

Пример списка:

{
  "mods": [
    {
      "name": "base",
      "enabled": true
    },
    {
      "name": "squeak-through-2",
      "enabled": true
    },
    {
      "name": "factoryplanner",
      "enabled": true
    },
    {
      "name": "RateCalculator",
      "enabled": true
    }
  ]
}

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

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

Перед установкой проверьте зависимости на странице мода.

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

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

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

Мод должен поддерживать версию Factorio, запущенную на сервере.

Проверьте параметр версии:

FACTORIO_VERSION

Если сервер работает на стабильной версии:

FACTORIO_VERSION=latest

используйте моды, совместимые со стабильной веткой.

Если сервер работает на экспериментальной версии:

FACTORIO_VERSION=experimental

проверьте, что мод поддерживает эту версию.

Моды и сохранения

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

saves/

Файл сохранения имеет формат:

saves/{SAVE_NAME}.zip

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

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

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

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

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

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

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

Остановите сервер.
Сделайте резервную копию сохранения.
Загрузите новый ZIP-файл мода в mods/.
Удалите старую версию ZIP-файла, если сервер продолжает использовать её.
Проверьте mod-list.json.
Запустите сервер.

Если после обновления сервер не запускается, отключите обновлённый мод через "enabled": false или верните старую версию файла.

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

Остановите сервер.
Сделайте резервную копию сохранения.
В mod-list.json установите "enabled": false.
Запустите сервер и проверьте сохранение.
Если мир работает корректно, удалите ZIP-файл из mods/.

Не удаляйте крупные overhaul-моды из активного мира без проверки на копии сохранения.

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

ZIP-файл загружен не в mods/;
мод был распакован;
в mod-list.json указано неправильное имя;
у мода стоит "enabled": false;
мод не поддерживает версию Factorio на сервере;
не установлена обязательная зависимость.

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

Откройте лог запуска сервера.
Найдите строки с названием последнего добавленного мода.
Проверьте зависимости мода.
Проверьте совместимость мода с версией Factorio.
Отключите проблемный мод через "enabled": false.
Запустите сервер повторно.

Частые сообщения в логе:

Failed to load mod
Dependency is missing
Mod is not compatible with current version
Checksum mismatch
Error while loading prototype
JSON parser error

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

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

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

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

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

Файл списка модов:
mods/mod-list.json

Формат мода:
ModName_version.zip

ZIP-файлы:
не распаковывать

Включить мод:
"enabled": true

Отключить мод:
"enabled": false

Базовый мод:
base должен быть включён

Что не делать

не распаковывать ZIP-файлы модов;
не отключать base;
не менять крупный набор модов без резервной копии сохранения;
не смешивать моды под разные версии Factorio;
не удалять мод из активного мира, если он добавлял предметы, технологии, рецепты или ресурсы.

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