Friendly Meditation Mod для Next Gen Edition v.0.9NGE
=====================================================
by wghost81 aka Wasteland Ghost
===============================

Мод предназначен для версии 4.0 также известной как "Next Gen Edition" (NGE).

Описание:
=========

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

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

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

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

Клавиша медитации имеет несколько режимов (см. меню настроек мода): ускорение времени, переключение ускорения, вход в режим медитации. В первом случае Геральт медитирует в ускоренном времени пока клавиша медитации зажата. Во втором первое зажатие клавиши начинает ускорение времени, а второе - останавливает его. В последнем режиме зажатие клавиши включает медитацию без ускорения времени, время ускоряется зажатием отдельной клавиши - этот режим можно использовать в сочетании с "обзорным" режимом камеры, чтобы просто насладиться окружающим миром.

Примечание: мод не меняет сохранения, так что установка/удаление посреди прохождения безопасны.

Назначения клавиш по-умолчанию:
===============================

"Удерживать N" ("удерживать нажатым правый стик контроллера") - медитация в реальном времени;
"Удерживать пробел" ("удерживать нажатым левый стик контроллера") - ускорить время.
"Нажать End" - вкл/выкл разжигание огня при медитации.
"Нажать C" ("удерживать нажатой кнопку Y контроллера") - остановить медитацию в меню медитации.


Настройка:
==========

Все опции доступны во внутриигровом меню - ищите "Моды" и "Friendly Meditation".

Установка:
==========

Начиная с версии 4.0 (Next Gen Edition) игра использует два отдельных файла конфигурации для dx11 и dx12 версий. Если вы не видите меню мода в игре или у вас проблемы с настройками - проделайте шаги 3 и 4 ручной установки (см. ниже).

Для установки мода рекомендуется использовать The Witcher 3 Mod Manager (TW3MM), доступный для скачивания на Nexus Mods.

Vortex (бывший Nexus Mod Manager) устанавливает мод не полностью - части мода могут работать некорректно, например, горячие клавиши! Если вы используете Vortex и у вас что-то не работает, проверьте шаги ручной установки перед тем, как сообщать о баге.

Решение конфликтов с другими модами
===================================

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

Ручная установка:
=================

1. Создание резервной копии (не обязательно)

Поскольку некоторые моды (включая этот) меняют файлы конфигурации, не повредит сделать резервную копию папки "[Path To The Witcher 3]\bin\config" (в случае если подобные моды ранее не устанавливались и папка всё ещё ванильная).

2. Установка основных файлов мода

Для установки основных файлов мода необходимо распаковать и скопировать папку "modFriendlyMeditation" в "[Путь куда установлена The Witcher 3]\Mods". Если папка "Mods" не существует, её нужно создать. Основные файлы можно установить с помощью NMM, но привязки клавиш и настройки для игрового меню всё равно придётся устанавливать вручную (см. ниже).

3. Установка внутриигрового меню и горячих клавиш

Для работы игрового меню необходим файл modFMeditationConfig.xml в папке "[Путь куда установлена The Witcher 3]\bin\config\r4game\user_config_matrix\pc" folder. А также запись modFMeditationConfig.xml; в файлах dx11filelist.txt и dx12filelist.txt.

Для работы новых горячих клавиш, их необходимо добавить в файл "[Путь куда установлена The Witcher 3]\bin\config\r4game\user_config_matrix\pc\input.xml".

3.1. Быстрая установка

Если у вас нет других модов, добавляющих горячие клавиши, просто скопируйте папку "[Путь куда установлена The Witcher 3]\Mods\modFriendlyMeditation\bin" в папку "[Путь куда установлена The Witcher 3]". Если всё сделано правильно, то появится окно, с вопросом хотите ли вы перезаписать существующий файл input.xml. Выберите "перезаписать", чтобы заменить исходный файл input.xml модифицированным.

3.2. Ручная установка

Если у вас уже установлены другие моды, добавляющие горячие клавиши, вы почти наверняка не захотите перезаписывать input.xml. В этом случае для установки горячих клавиш нужно открыть файлы "[Путь куда установлена The Witcher 3]\bin\config\r4game\user_config_matrix\pc\input.xml" и "[Путь куда установлена The Witcher 3]\Mods\modFriendlyMeditation\bin\config\r4game\user_config_matrix\pc\input.xml" и скопировать изменения modFriendlyMeditation вручную (они помещены внутрь комментариев "modFriendlyMeditation begin" и "modFriendlyMeditation end") в аналогичную часть существующего файла.

Также необходимо скопировать файл "[Путь куда установлена The Witcher 3]\Mods\modFriendlyMeditation\bin\config\r4game\user_config_matrix\pc\modFMeditationConfig.xml" в папку "[Путь куда установлена The Witcher 3]\bin\config\r4game\user_config_matrix\pc" для установки меню.

Откройте файл "[Path To The Witcher 3]\bin\config\r4game\user_config_matrix\pc\dx11filelist.txt" и впишите в конец строку modFMeditationConfig.xml; (см. пример в файле "[Path To The Witcher 3]\Mods\modFriendlyMeditation\bin\config\r4game\user_config_matrix\pc\dx11filelist.txt"). Проделайте такую же операцию с файлом dx12filelist.txt.

4. Инициализация установок мода по умолчанию и горячих клавиш

Для версии DX11 установки мода хранятся в файле "C:\Users\[Имя Пользователя]\Documents\The Witcher 3\user.settings".

Для версии DX12 установки мода хранятся в файле "C:\Users\[Имя Пользователя]\Documents\The Witcher 3\dx12user.settings".

Привязки клавиш хранятся в файле "C:\Users\[Имя Пользователя]\Documents\The Witcher 3\input.settings".

Для инициализации настроек мода по-умолчанию необходимо открыть "C:\Users\[Имя Пользователя]\Documents\The Witcher 3\user.settings" и "[Путь куда установлена The Witcher 3]\Mods\modFriendlyMeditation\user.settings.part.txt" из мода. Выделить всё в файле "user.settings.part.txt", скопировать и вставить в начало файла "user.settings". Проделайте такие же операции над dx12user.settings. Если пропустить этот шаг, почти все функции мода будут отключены и будет казаться, что мод не работает или работает неправильно.

Для инициализации горячих клавиш необходимо открыть "C:\Users\[Имя Пользователя]\Documents\The Witcher 3\input.settings" и "[Путь куда установлена The Witcher 3]\Mods\modFriendlyMeditation\input.settings.part.txt" из мода, выделить всё в файле "input.settings.part.txt", скопировать и вставить в начало файла "input.settings". Если пропустить этот шаг, то клавиши будут отображаться в меню, но назначить их нормально не получится.

5. Решение конфликтов с другими модами

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

Обновление:
===========

Удаление старой версии и установка новой - наиболее безопасный способ. Причём если мод удалялся через TW3MM/Vortex, необходимо убедиться, что папка "[Path To The Witcher 3]\Mods\modFriendlyMeditation" действительно была удалена. Если в списке изменений нет новых клавиш и опций меню, то никакие другие действия, кроме установки основных файлов, не требуются.

Если обновление содержит новые горячие клавиши, проще всего удалить файл "C:\Users\[Имя Пользователя]\Documents\The Witcher 3\input.settings", запустить игру один раз, чтобы получить новый файл с настройками по умолчанию и затем повторить шаги 3 и 4 описанного выше процесса установки.

Если обновление содержит новые опции меню, проще всего удалить файл "C:\Users\[Имя Пользователя]\Documents\The Witcher 3\user.settings" (dx12user.settings), запустить игру один раз, чтобы получить новый файл с настройками по умолчанию и затем повторить шаги 3 и 4 описанного выше процесса установки.

Внимание! Не забудьте восстановить пользовательские настройки после удаления файлов input.settings и user.settings (dx12user.settings)!

При наличии других модов, после установки надо удалить существующие объединения в ScriptMerger и объединить всё заново.

Удаление:
=========

Если вы ставили мод с помощью TW3MM, просто запустите его и выберите пункт "удаление".

Если меню мода (или пустые строчки) всё ещё видны в игре, проверьте файлы dx11filelist.txt и dx12filelist.txt (см. ручную установку, шаг 3.2).

Не забудьте после удаления запустить Script Merger.

Ручное удаление:
================

1. Удаление основных файлов мода

Использовать NMM или удалить вручную папку мода "[Путь куда установлена The Witcher 3]\Mods\modFriendlyMeditation".

2. Удаление меню и горячих клавиш

Для удаления меню надо удалить файл modFMeditationConfig.xml из папки "[Путь куда установлена The Witcher 3]\bin\config\r4game\user_config_matrix\pc".

Для удаления горячих клавиш их необходимо убрать из файла "[Путь куда установлена The Witcher 3]\bin\config\r4game\user_config_matrix\pc\input.xml".

2.1. Быстрое удаление с использованием резервной копии

Если у вас есть резервная копия папки "[Путь куда установлена The Witcher 3]\bin\config" и нет других модов, меняющих файлы конфигурации, просто удалите папку "[Путь куда установлена The Witcher 3]\bin\config" и скопируйте на её место папку "config" из резервной копии.

2.2. Ручное удаление

Для удаления горячих клавиш откройте файл "[Путь куда установлена The Witcher 3]\bin\config\r4game\user_config_matrix\pc\input.xml" и удалите всё между комментариями "modFriendlyMeditation begin" и "modFriendlyMeditation end".

Для удаления меню надо удалить файл modFMeditationConfig.xml из папки "[Путь куда установлена The Witcher 3]\bin\config\r4game\user_config_matrix\pc". Затем удалите строчку modFMeditationConfig.xml; из файлов dx11filelist.txt и dx12filelist.txt.

3. Конфликты с другими модами

При наличии других модов, после удаления надо объединить всё заново в ScriptMerger.
