Моды Stardew Valley: установка SMAPI и совместимость

Моды Stardew Valley на ПК обычно устанавливают через SMAPI: загрузчик запускает игру с дополнениями, читает папку Mods и сообщает об ошибках. Сначала сохраните копию фермы, установите подходящую версию SMAPI, а затем добавляйте модификации вместе с указанными автором зависимостями. Менеджер модов для этого необязателен.

С чего начать: версия игры и задача мода

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

Перед установкой проверьте номер игры и требования загрузчика. На момент подготовки материала SMAPI 4.5.2 требует Stardew Valley 1.6.14 или новее. Версия 1.6.15 проходит этот порог, но это не подтверждает совместимость каждого отдельного мода. Для него нужно отдельно проверить поддерживаемую версию игры, требования к SMAPI и зависимости. Пометка о поддержке 1.6 помогает при выборе, однако не заменяет инструкцию к конкретному файлу.

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

Эта инструкция посвящена версии для ПК и прежде всего Windows. Установщики SMAPI для Linux и macOS отличаются; на Steam Deck используется путь для Linux. Переносить шаги для Windows на телефон или консоль нельзя: поддержка модификаций и доступные загрузчики там устроены иначе.

Как сохранить ферму перед установкой

Закройте игру и скопируйте сохранения в отдельное место. В Windows нужный каталог можно открыть через окно «Выполнить», введя %appdata%\StardewValley\Saves. Папка каждой фермы содержит несколько связанных файлов, поэтому удобнее копировать всю папку выбранного хозяйства или целиком каталог Saves. Копию храните отдельно от действующего сохранения и подпишите так, чтобы было понятно, к какой версии игры и набору модов она относится.

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

В комплекте SMAPI есть Save Backup, который делает ежедневные резервные копии и сохраняет десять последних таких копий. Это полезная дополнительная защита, но перед крупным изменением состава модов лучше иметь собственный снимок. Особенно это важно для дополнений с новыми предметами, зданиями и территориями: сведения о них могут попасть в сохранение.

Установка SMAPI в Windows

Скачайте загрузчик со страницы его разработчика и полностью распакуйте архив. Не запускайте установочный файл прямо из окна архиватора. В распакованном комплекте выберите install on Windows.bat и следуйте подсказкам установщика.

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

После установки в каталоге игры появляется StardewModdingAPI.exe, а для дополнений используется папка Mods. Дальнейший способ запуска зависит от клиента:

• В Steam перенесите в параметры запуска всю строку, которую вывел установщик SMAPI, включая кавычки и %command%. Путь в ней должен вести к вашей установке.
• Для отдельного запуска в Windows используйте StardewModdingAPI.exe из каталога игры.
• Если запускаете игру через GOG Galaxy и хотите сохранить работу его функций, настройте запуск по инструкции SMAPI для Galaxy. Параметры Steam для этого не подходят.

Сначала запустите загрузчик без новых модификаций. Окно SMAPI должно показать ход запуска, после чего появится меню игры. Так вы отделите проверку самого загрузчика от проверки добавленных файлов. Не закрывайте его консоль во время игры: это часть запущенного процесса, а не лишнее окно установщика.

Куда распаковывать моды

Обычная структура выглядит так: Stardew Valley\Mods\НазваниеМода\manifest.json. Название папки зависит от дополнения; переименовывать её по этому примеру не требуется. Важнее, чтобы внутри находились распакованные файлы мода, а не ещё один архив.

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

manifest.json помогает отличить пакет для SMAPI от случайной папки с изображениями или старого дополнения другого формата. Однако не нужно самостоятельно создавать этот файл или менять его версию, чтобы заставить несовместимый мод загрузиться. Если ожидаемого файла нет, проверьте описание загрузки: возможно, вы скачали исходный код, перевод без основного мода или пакет, которому нужен другой компонент.

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

Зависимости: зачем нужны Content Patcher и другие компоненты

SMAPI - общий загрузчик. Некоторым дополнениям нужны ещё и библиотеки либо отдельные инструменты. Например, наборы для Content Patcher используют его возможности для изменения игровых данных и оформления без ручной замены исходных XNB-файлов. Сам Content Patcher тоже устанавливают как мод в Mods.

Это не означает, что он обязателен для любой модификации Stardew Valley. Откройте требования выбранного дополнения и установите перечисленные обязательные компоненты. Слово «необязательный» в описании зависимости также имеет значение: такой компонент может открывать отдельную функцию, не требуясь для основного запуска.

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

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

Первый запуск и настройка

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

Часть модов создаёт config.json только после первого запуска. Чтобы изменить такой файл вручную, закройте игру, сохраните его копию и редактируйте только нужные параметры. Соблюдайте синтаксис: пропущенная кавычка или запятая может сделать конфигурацию нечитаемой. Если автор предлагает внутриигровое меню настройки, следуйте его инструкции и установите требуемый для этого компонент.

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

Модификации могут менять сведения, на которых основаны обычные игровые советы. Например, дополнение с новыми персонажами или изменёнными предпочтениями потребует собственной таблицы подарков. Наш гайд по подаркам Stardew Valley относится к базовым правилам игры; изменения выбранного мода нужно учитывать отдельно.

Почему мод не работает: порядок проверки

Начните с сообщения SMAPI, а не с переустановки всей игры. Сначала определите, загрузился ли нужный мод вообще. Если он пропущен, проверьте поддерживаемую версию игры, требования к загрузчику и наличие зависимостей. Если загрузился, но эффект не виден, проверьте настройки и условия появления функции.

Для подробного разбора используйте журнал SMAPI и его разборщик: там виден состав загруженных компонентов и сообщения об ошибках. Полезно сохранить журнал именно того запуска, в котором возникла проблема. Общая фраза «игра не работает» даёт меньше информации, чем версия игры, список последних изменений и конкретная ошибка.

Если отключаете мод для проверки, перенесите его папку за пределы Mods, сохранив её целиком. Но не открывайте после этого ценную ферму бездумно: удаление дополнения с собственными объектами может потребовать отдельной процедуры. Проверять запуск без проблемного пакета безопаснее на тестовом сохранении, если автор не описал другой порядок.

Обновление, удаление и разные наборы модов

Перед обновлением закройте игру и сохраните копии фермы, конфигурации и текущего набора дополнений. SMAPI обновляют через установщик новой версии. Порядок обновления конкретного мода определяет его автор: иногда достаточно заменить файлы, а иногда требуется удалить старую папку перед установкой новой. Не оставляйте две версии одного дополнения в разных подпапках Mods.

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

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

Моды в совместной игре

Единого правила «достаточно установить только хозяину» нет. Локальное оформление и изменения общего мира предъявляют разные требования. Для дополнений с новыми предметами, картами или персонажами может понадобиться установка у всех участников; для некоторых локальных изменений это не требуется. Решение ищите в описании конкретного мода.

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

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