SomaticCameraFO4 / Улучшенная камера от 1-го лица

Масштабное обновление камеры от первого лица для Fallout 4, которое позволяет видеть все тело вашего персонажа. SomaticCameraFO4 — добавляет систему псевдо-вида от первого лица (pseudo FPP). Она позволяет исследовать игровой мир с ракурса третьего лица, но при этом камера располагается на уровне головы персонажа. Это максимально точно имитирует настоящий вид от первого лица, сохраняя при этом все преимущества обзора и ситуационной осведомленности от третьего лица.

Что послужило вдохновением:
Этот мод был вдохновлён `Improved Camera` для Skyrim, `SomaticCameraSF` для Starfield и общей концепцией псевдо-камер от первого лица, встречающейся в различных играх от третьего лица. Реализация для Starfield послужила основной эталонной архитектурой, включая подход к управлению состояниями камеры, подключению к граф-сцене и обработке прицеливания. Версия для Fallout 4 создавалась с нуля, чтобы адаптировать эти концепции под иную систему камеры и архитектуру движка FO4.

Принцип работы:
Мод подключается к системе камеры Fallout 4 через расширитель скриптов F4SE (Fallout 4 Script Extender) и использует хуки виртуальных таблиц для функций обновления PlayerCamera::Update и древа сцены NiAVObject. При активации мод принудительно переводит стек камер движка в состояние k3rdPerson (от третьего лица) и непрерывно перемещает корень камеры вслед за узлом головы игрока, применяя заданные пользователем смещения по вертикали и вперед. Само вращение камеры (обзор мышью) полностью контролируется движком, благодаря чему псевдо-вид от первого лица ощущается естественным и отзывчивым.

Мод также включает в себя:
* ADS (Прицеливание) — система физического прицеливания в стиле Starfield. При зажатии кнопки прицеливания камера временно переключается на настоящий вид от первого лица, а после прекращения прицеливания плавно возвращается в режим псевдо-вида от первого лица.
* Поддержка переходов для мебели и силовой брони — псевдокамера корректно обрабатывает особые состояния, такие как использование мебели (усаживание) и вход/выход из силовой брони.
* Совместимость с Пип-боем и меню — мод распознает блокирующие интерфейсы (Пип-бой, терминалы, диалоги, верстаки и т.д.) и временно отключает псевдо-режим, позволяя движку игры стандартно обрабатывать камеру в меню.

ОСНОВНЫЕ ВОЗМОЖНОСТИ ПСЕВДОКАМЕРЫ: Настройки в МСМ меню (требуется мод "Mod Configuration Menu")

Псевдо-FPP камера
* Переключение псевдокамеры: Назначение любой клавиши переключения (выпадающий список в MCM; по умолчанию `F4`).
* Регулировка положения камеры: Смещение по высоте, вперед/назад и вбок.
* Выделенный Псевдо-FOV: Отдельный угол обзора, независимый от оригинального FOV.
* Поворот тела: Торс персонажа поворачивается в сторону камеры, если расхождение превышает заданный порог (10–90°), со скоростью не более 6°/кадр.
* Качание головы: Раскачивание камеры синхронизировано с вращением головы для состояний: покой, ходьба, бег, спринт, бой, скрытность и кувырок в скрытности (доступна опция синхронизации слайдеров).

Скрытие головы и шлема
* Скрыть голову: Полностью скрывает подграф головы (голову, лицо, волосы) в режиме псевдо-FPP.
* Скрыть шлем: Сканирование области вокруг головы скрывает шлемы, шляпы и маски.
* Ближняя тень головы: Альтернативный вариант — голова и шлем остаются в графе рендеринга и продолжают *отбрасывать тень*, но вырезаются из видимого изображения путем смещения ближней плоскости отсечения камеры (настраиваемый параметр).

Прицеливание
* Удерживайте ПКМ или LT (геймпад) для перехода из режима псевдокамеры в честный вид от первого лица.
* Прицеливание с оптикой (Scoped ADS): Плавное сглаживание перехода от игрового зума оптического прицела к псевдо-FOV (от 0.0 до 1.0).
* Прицеливание без оптики (Non-scoped ADS): Прямая установка FOV для механических прицелов (чем ниже значение, тем сильнее приближение).
* Настраиваемый порог срабатывания триггера LT на геймпаде.

FOV и ближняя дистанция отсечения
* Переопределение FOV для различных состояний: FPP / руки / бой / мебель / крафт / смерть / TPP и т.д.
* Переопределение ближней дистанции отсечения для каждого состояния (FPP, TPP, сидение) с порогом угла наклона.

Взаимодействие с миром
* Терминалы: Псевдокамера отключается во время использования терминала (курсор работает, экран отображается корректно).
* Пип-бой / Верстак для оружия / Мастерская: Псевдокамера отключается на время открытия меню (мышь работает исправно).
* Пункты крафта (оружие, броня, химия, готовочная стойка, робоверстак + мастерская поселения) — псевдокамера отключается на всё время взаимодействия (без неконтролируемого вращения камеры).
* Стулья / Кровати / Голый каркас Силовой Брони: Псевдокамера остается активной (анимации от первого лица, оригинальное поведение).
* Восстановление при застревании в мебели: Автоматический вывод камеры из застрявшего состояния `kFurniture` (экстренный принудительный перенос от третьего лица — `ForceThirdPerson`).

Силовая броня
* Вход и выход из силовой брони остаются в режиме псевдокамеры (анимации посадки/высадки от первого лица).
* Станция обслуживания силовой брони: Распознается и обрабатывается — псевдокамера отключается на всё время взаимодействия, обеспечивая чистый выход без вращения камеры.
* Обработка смотрового окна и восстановление псевдокамеры после завершения анимаций силовой брони.

Разное
* VATS: Голова и шлем восстанавливаются для сцены VATS, скрытие применяется повторно при выходе.
* Смерть / Загрузка сохранения: Хук камеры отключается во время камеры смерти и загрузок (защита от вылетов), псевдокамера отключается автоматически.
* Обработка событий регдолла (Ragdoll), `LoadGame` и `CellFullyLoaded`.
* Руки от третьего лица (Third Person Arms): Опциональное скрытие рук от первого лица / отображение рук от третьего лица.
* Встроенная приватная библиотека адресов (`SomaticCameraFO4.bin`) — отсутствие конфликтов с другими модами, использующими общую базу данных адресов.

Конфигурация
* F4MCM: Полноценное внутриигровое меню (Камера, Общее, Скрытие, Качание головы, FOV, Ближняя дистанция, События); изменения применяются без перезапуска игры (горячая перезагрузка).
* `Data\F4SE\Plugins\SomaticCameraFO4.ini`
* Поддержка профилей (`Default.ini`).

Требования:
Fallout 4 версии 1.10.163 - 1.11.221 - 1.11.240
Fallout 4 Script Extender (F4SE)
Address Library for F4SE Plugins
Mod Configuration Menu

Установка:
Через мод-менеджер или вручную:
1. Установите все требования, если они еще не установлены.
2. Установите архив морда через менеджеры модов или вручную. Проверьте активацию плагина.
3. Запустите игру через F4SE.


Обновление:2.6 Official Version V7 (OG 1.10.163.0)
• Добавлен переключатель для смены режима прицеливания между видом от третьего лица (TPP) и видом от первого лица (FPP) (для оружия без оптических прицелов).
• Скорректирована дистанция/дальность для состояний TPP Center 1 и 2.
• Переработана система обзора по сторонам в режиме TPP Center для соответствия ванильной камере от третьего лица (TPP).
• Добавлен псевдо-обход FOV для Пип-Боя.
• Исправлено несколько ошибок.
Обновление:2.А Official Version V3 (АЕ 1.11.240)
• Улучшения производительности и исправления просадок FPS.

Обновление:2.5 Official Version V6 (OG 1.10.163.0)
Обновление:1.А Official Version V2 (АЕ 1.11.240)
* Добавлен переключатель в меню MCM для включения/отключения задержки прицеливания.
* Добавлены настройки MCM для переназначения кнопок геймпада, отвечающих за переключение и смену состояний псевдо-камеры.
* Добавлена совместимость с кастомным оружием (например, XM2010), одеждой, телами и бронёй.
* Добавлена совместимость с модом Visible Favorites.
* Улучшена производительность и исправлены различные ошибки.

Обновление:2.4 Official Version V5 (OG 1.10.163.0)
Обновление:1.10 Official Version V3 (АЕ 1.11.221)
Режим прицеливания (ADS):
* Задержка перехода из прицеливания: Введена двухсекундная задержка при выходе из режима прицеливания (ADS) в псевдо-виде от первого лица. Это предотвращает мгновенный резкий возврат камеры в псевдо-вид от первого лица.
Поддержка геймпада:
* Добавлена комбинация кнопок контроллера (START + SELECT) для включения и выключения псевдо-камеры.
Новые функции меню настройки модов (MCM) для центрального вида от третьего лица:
* Настройка расстояния камеры: Добавлены параметры регулировки дистанции камеры как для первого, так и для второго состояния центральной камеры от третьего лица.
* Настройка клавиш переключения: Добавлена возможность назначения пользовательских клавиш для смены состояний псевдо-камеры.
* Переключатель для средней кнопки мыши: Добавлена опция включения и отключения *Mouse 3* (средней кнопки мыши) для переключения состояний псевдо-камеры.

Обновление:2.3 Official Version V4 (OG 1.10.163.0)
* Исправлен режим ADS: Из кода и MCM удалён зум при прицеливании, так как он вызывал различные проблемы во время стрельбы.
* Добавлено новое псевдосостояние камеры: вид от третьего лица по центру.
* Обновлён дисплей Пип-Боя: Теперь отображаются как само меню, так и руки. Меню стало меньше, но остаётся полностью функциональным, создавая более глубокое погружение в режиме псевдовида от первого лица.
* Исправление ошибок: Устранены некоторые мелкие неполадки.

Обновление:1.9 Official Version V2 (АЕ 1.11.221)
* Исправлены проблемы с прицеливанием.
* Исправлено несколько ошибок.

Обновление:1.8 Official Version V1 (АЕ 1.11.221)
* Добавлена опция скрытия головы и шлема.
* Добавлена логическая поддержка верстаков и станций силовой брони.
* Применена более простая логика прицеливания (ADS).
* Новые функции в MCM-меню: `HeightOffset` (смещение по высоте), `ForwardOffset` (смещение вперед), `SideOffset` (смещение вбок), `PseudoFov` (псевдо-FOV), `HeadShadowNear` (ближняя тень от головы), `EnableHeadHide` (включение скрытия головы), `EnableHelmetHide` (включение скрытия шлема), `EnableHeadShadowNear` (включение ближней тени от головы) и `ToggleKey` (клавиша переключения).
* Исправлено несколько багов.

Обновление:2.2 Official Version V3 (OG 1.10.163.0)
* Настройки MCM: Увеличены пределы смещения вверх/вперед в MCM (просто ради развлечения!).
* Исправления ADS: Улучшено поведение прицеливания (ADS) в режиме псевдо-камеры.
* Ближний бой: Скорректировано прицеливание (ADS) для оружия ближнего боя — блок теперь корректно удерживает вас в режиме псевдо-камеры.
* Производительность: Улучшена общая оптимизация и производительность.

Обновление:2.1 Official Version V2 (OG 1.10.163.0)
* Исправления крафта: Исправлены проблемы с камерой при работе с верстаками и станцией Силовой брони.
* Новая настройка MCM: В настройки MCM добавлен слайдер для прицеливания (ADS) без оптического прицела.
* Понятность MCM: Обновлены названия параметров ADS для лучшей читаемости.
* Корректировка `bEnableHeadShadowNear`: Скоректирован диапазон значений (слишком высокие значения приводили к исчезновению рук и частей оружия).
* Смещения (Offsets): Обновлены и сбалансированы все остальные значения смещений.
* Производительность и камера: Оптимизирована система псевдокамеры.
* Общие изменения: Различные прочие исправления ошибок и улучшения.

Обновление:2.0 BETA1 (OG 1.10.163.0)
* Исправлена проблема с подрагиванием/резким рывком камеры при движении назад.
Новые функции и настройки MCM: (Добавлены 3 основные переключателя)
`bEnableHeadHide` — Включает / отключает невидимость головы.
`bEnableHelmetHide` — Включает / отключает невидимость шлема.
`bEnableHeadShadowNear` — Отображает тень от головы и шлема.
(Если включить все три опции, голова и шлем останутся невидимыми, но их тень сохранится).*
Добавлены 3 новых ползунка смещения:
`fSideOffset` — Центрирует положение камеры.
`fADSZoom` — Регулирует уровень приближения при прицеливании (по умолчанию или увеличенный зум).
`fHeadShadowNear` — Увеличивает порог отсечения головы/шлема, если их части всё ещё остаются видимыми.
* Камера диалогов: Восстановлена оригинальная ванильная камера во время диалогов с NPC.
* Улучшения VATS: Видимость головы и шлема теперь восстанавливается во время использования VATS.
* Исправлена куча других мелких багов.

Обновление:1.5 BETA3 (OG 1.10.163.0)
* Добавлена функция скрытия головы при включении псевдо-камеры и восстановления ее видимости после отключения.
* Улучшен поворот камеры относительно тела.
* Добавлены новые настройки в меню MCM:
1. Настройка угла обзора (FOV).
2. Настройка горячей клавиши переключения псевдо-камеры.
* Исправлено несколько ошибок.

Обновление:1.4 BETA2 (OG 1.10.163.0)
* Вращение тела: Добавлено вращение тела персонажа относительно камеры (пока работает не идеально).
* Улучшенная система прицеливания (ADS): Прицеливание теперь плавно переключается из псевдокамеры в оригинальный вид от первого лица (поддерживается ПКМ на мыши и LT на геймпадах).
* Исправлено взаимодействие с терминалами: Устранены ошибки при использовании терминалов.
* Исправлено взаимодействие с Пип-Боем: Устранены проблемы при открытии и навигации в Пип-Бое.
* Расширен диапазон MCM: Увеличены пределы и значения слайдеров в меню настроек MCM.
* Поддержка силовой брони: Добавлена работа псевдокамеры при использовании силовой брони.

Обновление:1.3 BETA1.3 (OG 1.10.163.0)
* Оптимизирована система VATS.
* Оптимизировано прицеливание (ADS).
* Исправлены ошибки.
* Мод теперь использует исключительно собственный файл `SomaticCameraFO4.bin` и больше не зависит от Address Library, что должно полностью устранить ошибки `REL::ID`.

Обновление:1.2 BETA1.1 (OG 1.10.163.0)
* Добавлен вариант мода для игры 1.10.163.0
* Поскольку бэкпорт псевдокамеры из версии 1.11.221 в 1.10.163 провалилось из-за несовместимых функций, мне пришлось пересобирать её с нуля.

Обновление:1.7 BETA5 (АЕ 1.11.221)
* Исправлена ​​ошибка с Pip-Boy.
* Исправлена ​​ошибка с терминалом.
* Исправлены другие ошибки / общие исправления ошибок.

Обновление:1.4 BETA4 (АЕ 1.11.221)
* Исправлен Пип-Бой — теперь он отображается в режиме псевдо-камеры (если экипировано оружие, камера Пип-Боя пока переключается на стандартный вид от 3-го лица; исправление в разработке);
* Добавлена поддержка "Mod Configuration Menu";
* Теперь вы можете изменять настройки в MCM меню прямо во время игры: fHeightOffset, fForwardOffset, iToggleKey.
* Исправлено несколько обнаруженных ошибок.