Favorites Menu Grid - F4SE / Сетка меню "Избранное"

Отображает ваши избранные предметы в виде сетки объемом до восьми страниц вместо стандартного крестообразного меню на двенадцать клавиш — как в самом меню избранного, так и в диалоге «НАЗНАЧИТЬ В ИЗБРАННОЕ» в Пип-Бое. Позволяет перемещать избранное между клавишами и страницами, очищать их, а также экипировать и снимать предметы. Поддерживается управление мышью, клавиатурой и геймпадом.

Дисклеймер:
Это порт моего мода Favorites Menu Grid из Starfield, который, в свою очередь, является форком мода Favorites Banks - Multiple Favorite Pages от SrSator. Поскольку в Fallout 4 система избранного устроена совершенно иначе, данный проект — это переписанный с нуля код, а не просто пересборка, однако идея и название принадлежат автору оригинала, поэтому обязательно ознакомьтесь с оригинальным модом и поддержайте его.

СЕТКА МЕНЮ ИЗБРАННОГО:
* Одна строка на страницу, одна ячейка на клавишу. Количество страниц задается в INI-файле (до восьми). Номера клавиш отображаются над столбцами, номера страниц — сбоку от строк.
* Наведите курсор на ячейку, чтобы выбрать ее, или перемещайтесь с помощью клавиш W/A/S/D или крестовины (D-pad). Название выбранного предмета отображается над сеткой, а под ним — его характеристики: урон и боеприпасы для оружия, сопротивления для брони (стандартные показатели игры).
* Используйте выбранную ячейку нажатием E, Enter, кликом мыши или кнопкой A на геймпаде. Выбор ячейки на другой странице сначала переключает на эту страницу, поэтому любой предмет на любой странице находится на расстоянии одного действия.
* Использование оружия или брони, которые уже экипированы, снимает их — используется стандартный механизм игры для убирания оружия в кобуру/снятия снаряжения, поэтому силовая броня и всё остальное работают по правилам игрового движка. Расходуемые предметы (химикаты, еда) применяются сразу и не имеют режима переключения.

ПЕРЕМЕЩЕНИЕ И ОЧИСТКА:
* Нажатие INSERT (кнопка X на геймпаде) подбирает выбранный предмет из избранного; следующее нажатие помещает его в другую выбранную ячейку, и оба предмета меняются местами — в том числе и между разными страницами. Именно так предмет можно переместить с 3-й страницы на 1-ю без использования Пип-Боя.
* Нажатие кнопки DELETE (кнопка Y) освобождает выбранную клавишу. Ничего не удаляется из инвентаря: предмет остается в категории избранного, но без назначенной клавиши — точно так же, как в оригинальной игре, когда предмету не присвоена цифра.

ПИП-БОЙ:
* При назначении предметов в избранное через Пип-Бой вместо стандартного крестообразного меню на двенадцать клавиш отображается такая же сетка. Наведите курсор или перейдите к любой ячейке на любой странице и нажмите «Принять» или кликните мышью; предмет будет назначен в эту ячейку. Все остальные аспекты назначения предметов работают стандартно.

ИКОНКИ:
* Если у вас установлен мод "FallUI Item Sorter" и библиотека иконок "Icon Library" (или DEF_UI), в каждой ячейке будет отображаться иконка предмета в цвете, заданном вашей конфигурацией сортировщика и цветовой схемой — точно такой же символ, который вы видите в меню FallUI, считываемый из уже имеющихся у вас файлов. Дополнения иконок (Diello, 4estGimp и другие) также поддерживаются. Никакие графические ресурсы не поставляются в составе этого мода. Без сортировщика в ячейках будут отображаться названия предметов, а всё остальное продолжит работать аналогично.
* В Пип-Бое иконки генерируются собственной библиотекой иконок FallUI, поэтому они точно соответствуют списку инвентаря.

КАК РАБОТАЮТ СТРАНИЦЫ:
* В игре предусмотрено двенадцать реальных горячих клавиш избранного. В каждый момент времени их занимает одна страница; остальные страницы сохраняются рядом с вашим сохранением в файле со-сохранения F4SE, поэтому у каждого персонажа будет свой собственный набор. Переключение на страницу перемещает её предметы в реальные клавиши через стандартные процедуры движка — именно поэтому цифровые клавиши 1–0, счетчики патронов и статус экипировки продолжают работать точно так же, как в оригинальной игре без модов.
* Параметр DefaultPage в INI-файле задает страницу, которая будет автоматически возвращаться на реальные клавиши каждый раз при закрытии меню избранного или Пип-Боя, чтобы цифры во время игры всегда отвечали за одну фиксированную страницу. По умолчанию функция отключена, что оставляет активной ту страницу, которой вы пользовались в последний раз.

СОВМЕСТИМОСТЬ:
* Моды, заменяющие файл FavoritesMenu.swf или перерабатывающие меню избранного (FavoritesMenuEx и им подобные), не тестировались с этим модом и, скорее всего, будут с ним конфликтовать — выбирайте что-то одно. Моды, которые только считывают или записывают избранное, работают иначе: этот мод сообщает системе избранного игры о каждом внесенном изменении точно так же, как это делает Пип-Бой. Подтверждена совместимость с модом Visible Favorites; также разработка и тестирование велись с оглядкой на сортировщики и FallUI.

ИЗВЕСТНЫЕ ОГРАНИЧЕНИЯ:
* Протестировано на одной сборке с установленными FallUI и FIS. Без них мод должен откатываться к отображению названий текста, но этот сценарий полноценно не тестировался в игре. Делайте резервные копии сохранений.
* Маленькие значки, которые некоторые иконки сортировщиков имеют в углу (например, таблетки рядом с бутылкой), не отображаются.
* Предмет из избранного, которого больше нет в вашем инвентаре, теряет привязанную клавишу при следующем переключении страницы; он не отображается полупрозрачным, как это было реализовано в версии для Starfield.

ТРЕБОВАНИЯ:
FALLOUT 4 OG 1.10.163, Next-Gen (1.10.980 / 1.10.984) и 1.11.x (включая 1.11.221 и 1.11.240)
F4SE
Address Library for F4SE Plugins
Runtime Database

УСТАНОВКА:
Установите через Vortex или Mod Organizer 2 или Nexus Mod Manager, либо вручную скопируйте папки в Data:
Data\F4SE\Plugins\FavoritesMenuGrid.dll
Data\F4SE\Plugins\FavoritesMenuGrid.ini
Data\Interface\FavoritesMenuGrid.swf

Файл .swf представляет собой пустой файл размером 36 байт, принадлежащий самому моду. Он не заменяет ни один ванильный файл, поэтому не может конфликтовать с DEF_UI, FallUI, HUDFramework или любым другим модом, содержащим файлы в папке Interface. Сетка отрисовывается в него напрямую из C++.

Все настройки находятся в файле FavoritesMenuGrid.ini, где подробно описан каждый параметр (переведено на русский). Файл считывается один раз при запуске игры.

Обновление:1.2
Исправления:
* Зависание списка инвентаря: Исправлена ошибка, из-за которой после назначения предмета в «Избранное» через Пип-бой список инвентаря переставал реагировать на нажатия клавиш «Вверх»/«Вниз» (стик или W/S) до тех пор, пока переключение вкладки не пересобирало его заново. Диалоговое окно освобождало клавиши списка при закрытии, а сетка интерфейса блокировала их обратно в том же кадре (найдено пользователем Hitman136).
* Управление с геймпада: В диалоговом окне назначения «Избранного» в Пип-бое маркер выборки перескакивал между ячейками, удержание стика прокручивало страницы, а список инвентаря на фоне прокручивался вместе с ним. Причина: игра превращала каждое нажатие D-Pad или отклонение стика в нажатие стрелок для скрытого оригинального креста «Избранного», и он перемещался по своей стандартной сетке, увлекая за собой новую сетку. Теперь, пока сетка находится в диалоговом окне, нажатия D-Pad и левого стика направляются исключительно в новую сетку. Кнопки «Вверх» и «Вниз» перелистывают по одной странице за нажатие/толчок; «Влево» и «Вправо» по-прежнему повторяют ввод при удержании. Управление с клавиатуры и мыши осталось без изменений.
Новые функции:
* GridBackdrop (Задний фон сетки): Темная подложка позади сетки интерфейса, настраиваемая в процентах (от 0 до 100, по умолчанию отключена). Полезна на фоне яркого неба, где иконки могут становиться невидимыми. При включенной подложке эмблема Vault-Tec и надпись "Q.A.O.S. - Quick Access Operating System" отображаются поверх сетки, пока ничего не выбрано.
* PauseGame=1 (Пауза игры): Приостанавливает время в игре во время открытия меню «Избранного» — аналогично тому, как это работает в Пип-бое. По умолчанию функция выключена, так как меню проектировалось для максимально быстрого использования в реальном времени.
* Оригинальные иконки игры: Предметы без тегов сортировщика (или все предметы, если сортировщик не используется) теперь отображают стандартные иконки из оригинального креста «Избранного». Иконка подбирается стандартными алгоритмами игры (по ключевым словам типа оружия на конкретном экземпляре, либо по тегам одежды, шлемов, перчаток, химикатов, алкоголя, еды, ремкомплектов, аптечек и эффектов режима «Выживание») и окрашивается в цвет вашего HUD. Ресурс подгружается напрямую из игрового файла `FavoritesMenu.swf` (сторонние файлы не поставляются). Не используется в Пип-бое, где иконки отрисовывает FallUI. Тестировалось на одной конфигурации с FallUI.
* IconColors=2 (Цвета иконок): Режим `2` окрашивает каждую иконку в цвет вашего HUD (как оригинальный крест); `1` сохраняет цвета сортировщика; `0` оставляет графику иконок белой.
Заметки по совместимости:
* Протестировано на версии игры 1.10.163 с установленным модом *FallUI*.
* На версиях Next-Gen / 1.11.x тестирование не проводилось; оригинальные иконки игры там отключены.
* Версия 1.2 является основным релизом для всех пользователей (поддержка 1.0.x прекращена).

Обновление:1.1.0
* Теперь для Fallout 4 OG 1.10.163, Next-Gen (1.10.980 / 1.10.984) и 1.11.x (включая 1.11.221 и 1.11.240). Один DLL-файл для всех версий игры. Адреса определяются для запущенной версии игры с помощью библиотеки CommonLibF4RD и базы данных Runtime Database вместо использования фиксированных адресов под версию 1.10.163. Две функции, которые этот мод ранее вызывал по фиксированным номерам, теперь находятся по их взаимосвязи с известными библиотеке функциями. В случае сбоя мод не пытается угадывать адреса, а просто отказывается от их использования — таким образом, отсутствие адреса проявится как «использование предмета из избранного ничего не делает» с записью строки в лог-файл, а не приведёт к вылету игры.
* Теперь требуется Runtime Database.
• Исправлено: назначение предмета в избранное в Пип-Бое с помощью клавиши подтверждения (E / Enter) иногда приводило к его использованию или экипировке вместо назначения. Мышь этой проблеме подвержена не была. Мод FallUI переносит фокус клавиатуры на список инвентаря каждый раз при его пересборке, вызываемой сеткой при смене страницы; если это происходило между выбором ячейки и нажатием клавиши подтверждения, нажатие уходило в список инвентаря. Теперь сетка удерживает фокус на диалоге назначения, пока он отображается.
• Исправлено: после закрытия диалога назначения на экране Пип-Боя мог оставаться желтый прямоугольник.