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

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

Базовые термины (перспективы камеры):
FPP (First-Person Perspective) — Вид от первого лица. Вы смотрите на игровой мир прямо из глаз персонажа. Руки и оружие обычно видны на переднем плане, а сам персонаж — нет.
TPP (Third-Person Perspective) — Вид от третьего лица. Камера находится снаружи и «парит» позади или над плечом персонажа, позволяя полностью видеть его тело, броню и окружающую обстановку. TPP — это набор новых режимов псевдо-камеры, которые имитируют стандартный вид от третьего лица, но располагают камеру строго по центру за спиной персонажа, а не над правым плечом.

Вид от третьего лица по центру: (TPP)
Особенности (TPP):
* Поведение свободной камеры с отслеживанием головы, аналогичное ванильному виду от третьего лица.
* Поддержка прицеливания от третьего лица.
* Переключение на TPP Center автоматически применяет невидимые слоты головных уборов и шлемов (независимо от ваших настроек в интерфейсе OSF).
* Взаимодействие с транспортными средствами или космическими кораблями принудительно переключает TPP Center в режим псевдо-вида от первого лица (Pseudo FPP) и блокирует его (из-за текущих проблем).
* Взаимодействие с мебелью временно переключает TPP Center в режим Pseudo FPP, но вы можете вручную переключиться обратно на TPP Center.

Список задач на будущее:
* Добавить пользовательские настройки смещения для Вида от третьего лица.
* Попробовать реализовать невидимость головы методом из SomaticCameraFO4.
* Улучшить интеграцию с космическими кораблями.
* Исправить другие известные баги.

ОСНОВНЫЕ ФУНКЦИИ ПСЕВДО-КАМЕРЫ:
* Псевдо-камера FPP/TPP: переключение псевдо-камеры по горячей клавише (по умолчанию `F4`).
* Настройка положения камеры: смещение вперед/назад, вверх/вниз и в стороны через INI-файл конфигурации или интерфейс OSF.
* Выделенный псевдо-FOV: независимый угол обзора, не влияющий на базовый угол обзора игры.
* Поворот тела за камерой: торс разворачивается в сторону камеры при превышении порога отклонения по оси рыскания (yaw); отключено в TPP Center.
* TPP Center: два пресета (близко/далеко), при которых персонаж четко виден, а камера отцентрована строго за его спиной.
* Орбитальная камера TPP Center: камера реагирует на наклон по оси тангажа (pitch — взгляд вверх/вниз), ведя себя как классический вид от третьего лица.

СКРЫТИЕ ГОЛОВЫ / ШЛЕМА:
* Скрытие головы / шлема: в обычном псевдо-режиме автоматически экипируются невидимые предметы `ICSF_Hide_Head` / `ICSF_Hide_Head_SS`.
* Восстановление оригинального шлема: при отключении псевдо-режима сохраненный шлем возвращается на место.
* Встроенное определение скафандра: если скафандр занимает одновременно слоты головы и тела, экипировка скрывающих предметов пропускается, чтобы скафандр не снимался.
* Отображение шлема в TPP Center: в отдаленных/орбитальных режимах шлем остается видимым на персонаже.

ПРИЦЕЛИВАНИЕ (ADS):
* Правая кнопка мыши / левый триггер геймпада (LT): в обычном псевдо-режиме переключает на честный вид от первого лица.
* Прицеливание (ADS) в TPP Center: поддержка прицеливания непосредственно в режиме TPP Center.
* Оружие ближнего боя: прицеливание с ножом, лопатой или кулаками не переключает камеру на вид от первого лица.
* Настраиваемый порог LT: в INI-файле можно задать глубину нажатия левого триггера, необходимую для срабатывания прицеливания.

КОРАБЛИ / ТРАНСПОРТ:
* Определение кресла пилота: распознает, когда игрок сидит в кресле пилота корабля.
* Автоотключение TPP Center: в кабинах кораблей и транспорте пресет автоматически сбрасывается до обычного псевдо-режима, чтобы камера не оказывалась позади игрока.

SAF (STARFIELD ANIMATION FRAMEWORK — АНИМАЦИОННЫЙ ФРЕЙМВОРК):
* Псевдо-камера во время анимаций SAF: камера остается на уровне головы игрока во время проигрывания анимаций SAF.
* Защита от ложного окончания анимаций (Debounce): небольшой допуск для кратковременных ошибочных сигналов о завершении анимации, предотвращающий срыв камеры между циклами.

ВЗАИМОДЕЙСТВИЕ С МЕНЮ И МИРОМ:
* Блокировка операций с инвентарем в меню: функции `EquipHideHeadgear` / `UnequipHideHeadgear` приостанавливаются, пока открыты меню инвентаря (`InventoryMenu`), контейнера (`ContainerMenu`), торговли (`BarterMenu`), крафта (`CraftingMenu`) и т.д., что предотвращает вылеты при выходе из меню.
* Поглощение прокрутки колесика в меню: прокрутка внутри инвентаря не меняет пресет камеры после закрытия меню.
* Отложенное восстановление шлема: если игрок отключает псевдо-режим клавишей `F4` при открытом меню, шлем автоматически восстановится сразу после закрытия меню.

РАЗНОЕ:
* Определение состояния камеры: распознает состояния вида от третьего лица (TPP), вида от первого лица (FPP), механического прицела, полета на корабле, управления транспортом и использования мебели.
* Восстановление при зависании состояний: экстренный принудительный переход на вид от третьего лица (`ForceThirdPerson`) при неожиданных сбоях переходов камеры.
* Отсутствие конфликтов с базой адресов: использует собственные приватные смещения (offsets).

КОНФИГУРАЦИЯ:
* `Data\SFSE\Plugins\SomaticCameraSF.ini`: полная настройка горячих клавиш, смещений, угла обзора (FOV), порога триггера LT и автоскрытия головных уборов.
* Плагин загружается автоматически через SFSE; изменения в INI-файле требуют перезапуска игры.

* В файле `SomaticCameraSF.ini` есть функции для управления положением псевдокамеры:

[Settings]
; Угол обзора (FOV) для вида от третьего лица в игровом мире
fTPWorldFOV=97.0

; Угол обзора (FOV) для вида от первого лица в игровом мире
fFPWorldFOV=97.0

; Клавиша включения/выключения функции (115 = F4)
iToggleKey=115

; Клавиша прицеливания (ADS) (2 = правая кнопка мыши)
iADSKey=2

; Проверка / зондирование HUD (1 = включено, 0 = выключено)
bHUDProbe=1

[PseudoFP]
; Поле зрения (FOV) для режима PseudoFP (псевдо-вида от первого лица)
fFOV=97.000000

; Включить сверхжесткое прикрепление камеры к голове (1 = включено, 0 = выключено)
bUltraRigidHeadAttach=1

; Игнорировать проверки корректности при сверхжестком прикреплении (false = выключено)
bUltraRigidIgnoreSanityChecks=false

; Задержка/градус плавности прикрепления к голове в кадрах (120 кадров)
fHeadAttachGraceFrames=120

; Максимальное плоскостное смещение для сверхжесткого прикрепления
fUltraRigidMaxPlanarOffset=1.5

; Допустимая погрешность по высоте для сверхжесткого прикрепления
fUltraRigidHeightTolerance=3.5

; Базовое смещение камеры вперед в сверхжестком режиме
fUltraRigidBaseForward=0

; Динамическое смещение камеры вперед при движении в сверхжестком режиме
fUltraRigidMotionForward=0

; Смещение камеры вперед относительно носа персонажа
fNoseForward= 0

; Смещение камеры вверх относительно головы
fUpOffset =0.110000

; Смещение камеры вперед относительно головы
fForwardOffset =0.070000

; Смещение камеры вбок (влево/вправо) относительно головы
fSideOffset =0.000000

; Синхронизация наклона (Pitch) во время анимаций SAF (false = выключено)
bSAFPitchSync=false

; Жесткая камера во время анимаций SAF:
; 1 = зафиксированный кадр во время SAF
; 0 = свободное вращение мышью + отдаление колесиком во время SAF (высота всегда следит за головой)
bSAFRigidCamera=0

; Смещение SAF Вперед/Назад (по направлению носа, центрирование по глазам)
fSAFOffsetForward = 0.12

; Смещение SAF Вверх/Вниз
fSAFOffsetUp = 0.01

; Смещение SAF Влево/Вправо (0 = строго по центру головы)
fSAFOffsetSide = 0.0

; Автоматически экипировать предмет для скрытия головы (0 = выключено)
bAutoEquipHideHead=0

; Автоматически экипировать предмет для скрытия головы в скафандрах (0 = выключено)
bAutoEquipHideHeadSS=0

; Скрытие головы через ближнюю плоскость с сохранением тени (порт fHeadShadowNear из FO4, шкала SF от 0.00 до 0.40, 0 = отключение отсечения):
; Включить отсечение головы через ближнюю плоскость (1 = включено)
bEnableHeadShadowNear=1

; Дистанция ближнего отсечения головы (0.250000)
fHeadShadowNear=0.250000

Или настройки через мод "OSF UI - Web Interface Framework and Mod Settings Menu (MCM)"

Требования:
Starfield версии 1.16.244
SFSE (Starfield Script Extender)
Address Library (для SFSE)

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

Благодарности
* CommonLibSF — моддинг-сообществу Starfield.
* MinHook — Tsuda Kageyu.
* Источник вдохновения — мод Improved Camera для Skyrim SE.


Обновление:2.5 (Official version V6)
• НОВАЯ ФУНКЦИЯ — Добавлено скрытие головы через ближнюю плоскость отсечения:
* Скрывает голову и шлем, полностью сохраняя при этом отображение тени.
* Полностью настраивается через мод "OSF UI".
* Совместимо со скафандрами со встроенными шлемами.
* Совместимо с одеждой, закрывающей голову или использующей слоты головы.
* Исправлена проблема с прохождением текстур (клиппингом) в области груди, когда персонаж игрока раздет.
* Может использоваться без модов на невидимые головные уборы или невидимые шлемы (они будут полностью удалены из кода в будущем обновлении).
• Исправлено несколько ошибок.

Обновление:2.4 (Official version V5)
* Добавлена 2-секундная задержка при обратном переходе из режима прицеливания от первого лица в псевдо-вид от первого лица.
* Удалено переключение камеры с помощью колеса мыши; теперь оно назначено на Кнопку мыши 3 (Mouse 3) / Кнопку Выбор (Select / Back) для предотвращения случайной смены режима.
* Исправлены различные другие ошибки.

Обновление:2.3 (Official version V4)
* Улучшен прицельный режим (ADS).
* Внесены исправления и корректировки для вида от третьего лица по центру.
* Исправлены различные мелкие ошибки.

Обновление:2.2 (Official version V3)
* Исправлено дрожание камеры от третьего лица в помещениях (интерьерах).
* Исправление ошибок / исправлены баги.

Обновление:2.1 (Official version V2)
* Исправлено прицеливание (ADS) для оружия с оптическими прицелами в режимах псевдо-камеры и вида от 3-го лица по центру (TPP Center).
* Исправлены проблемы с коллизией при виде от 3-го лица по центру (TPP Center) под потолками кораблей и зданий.
* Исправлены другие мелкие ошибки.

Обновление:2.0 (Official version V1)
* Оптимизация: Улучшение производительности и общая оптимизация.
* Исправление ближнего боя: Добавлена функция, предотвращающая переключение на вид от первого лица при использовании оружия ближнего боя.
* Новые режимы псевдо-камеры:
* Псевдо-вид от первого лица.
* Вид от третьего лица по центру: Близко.
* Вид от третьего лица по центру: Далеко.

Обновление:1.12 (Beta Version 7)
* Добавлена поддержка мода Osf UI (автор: ozooma10).
* Теперь вы можете изменять настройки кастомной камеры прямо в игре, включая: iToggleKey (в настоящее время есть баг с Numpad), fFOV, fAutoEquipHideHeadSS, bAutoEquipHideHead, fSideOffset, fForwardOffset, fUpOffset
* Исправлено несколько ошибок.

Обновление:1.11 (Beta Version 6 V4)
Переименовано название мода на SomaticCameraSF и файлы мода на SomaticCameraSF.ini и SomaticCameraSF.dll, поэтому обязательно удалите старые файлы ImprovedCameraSF.dll и ImprovedCameraSF.ini по пути Data\SFSE\Plugins\
Обновлен код: теперь установка параметра bAutoEquipHideHeadSS=0 предотвращает снятие текущего шлема псевдокамерой.

Обновление:1.9 (Beta Version 6 V3)
* Исправлена проблема, из-за которой прицеливание (ADS) приводило к снятию невидимого шлема.
* Добавлено автоматическое повторное надевание ранее экипированного шлема после отключения псевдо-камеры.
* Исправлено несколько мелких багов и ошибок.

Обновление:1.8 (Beta Version 6 V2)
* Исправлена камера от первого лица (FPP) во время космического полёта (на данный момент при подъёме с кресла пилота принудительно включается вид от третьего лица).
* Невидимые головные уборы и шлемы теперь подгружаются напрямую из файла .esm (из-за жестко прописанных FormID псевдокамера экипировала случайные предметы).
* Исправлены различные внутренние ошибки.
* Исправлены ошибки, появившиеся в предыдущей версии.
* Удалена дополнительная горячая клавиша переключения (она была одной из главных причин недавних проблем).
* При активации псевдокамеры в ваш инвентарь теперь добавляются невидимый головной убор и невидимый шлем.
* В файл ImprovedCameraSF.ini добавлены настройки для автоматической экипировки невидимых головных уборов (включено по умолчанию).
* Теперь для включения и выключения псевдокамеры используется всего одна основная горячая клавиша — по умолчанию Num / (вы можете изменить её на любую другую в файле ImprovedCameraSF.ini).
* Во время анимаций (вроде SnuSnuField) псевдокамера теперь отслеживает положение головы, но не блокируется — это значит, что вы всё ещё можете вращать камеру.
* Псевдокамера добавлена для анимаций усаживания в кресло пилота и подъёма с него. (Примечание: режим от первого лица пока не работает во время самого космического полёта — я сейчас работаю над исправлением).

Обновление:1.6 (Beta Version 5 V3)
* Добавлена поддержка двух горячих клавиш: Num / (работает как раньше) и новая клавиша F4.
* Новые возможности горячей клавиши F4: переключает режим псевдокамеры и добавляет невидимый головной убор и шлем прямо в инвентарь. Автоматическое надевание отключено (их нужно надевать вручную).
* Исправление синхронизации губ: устранены проблемы с синхронизацией губ во время диалогов с NPC.
* Улучшения производительности: общая оптимизация производительности.

Обновление:1.4 (Beta Version 5)
* Улучшения производительности: исправлены фризы и просадки FPS.
* Обновлена интеграция с модом SAF - Deputy NAF.
* В файл ImprovedCameraSF.ini добавлены три функции (для анимаций SAF) для управления положением псевдокамеры.
* Исправлено взаимодействие с мебелью.

Обновление:1.3 (Beta Version 4)
* Исправление ошибок;
* Исправлены анимации того, как персонаж садится и встает с мебели;
* Добавлена и оптимизирована логика транспорта;
* Добавлена возможность включать и выключать псевдокамеру в файле `ImprovedCameraSF.ini`;
* Изменена логика для таких анимаций, как *SnuSnuField* (теперь камера следует за головой, а также работает настройка положения, так что вы можете выставить её по своему вкусу);
* Прицеливание (ADS) от первого лица;
* Добавлен невидимый головной убор благодаря *HooliG4N83* (он автоматически надевается и снимается псевдокамерой; я не стал добавлять шлем в код, так как он конфликтовал со скафандрами со встроенными шлемами — если он вам нужен, просто введите в консоли `player.additem 04000900 1`);
* Оптимизация производительности.

Обновление:1.2 (Beta Version 3)
* Улучшена интеграция с мебелью (камера больше не будет бесконтрольно вращаться).
* Многочисленные исправления багов.
* Смещение перспективы (теперь камера находится на высоте головы, ровно там, где расположен нос).
* Полная интеграция с модом SAF - Deputy NAF.
* Совместимость с SnuSnuField (наслаждайтесь анимациями от первого лица с видимым телом).
* В файл `ImprovedCameraSF.ini` добавлены три функции для управления положением псевдо-камеры:
* `fUpOffset` — высота камеры / положение по вертикали.
* `fForwardOffset` — смещение камеры вперед / назад.
* `fSideOffset` — центрирование камеры, если она смещается в сторону.
> Выставленные по умолчанию значения — это мои личные предпочтения, они могут вам как подойти, так и нет, но вы всегда можете настроить их на свой вкус.
* Эффективный способ скрыть голову пока так и не найден.

Обновление:1.1 (Beta Version 2)
* Добавлена клавиша F4 для включения и выключения псевдо-камеры прямо в игре.
* Добавлен .ini-файл, позволяющий каждому настроить положение камеры и FOV под себя.
* Исправлено несколько багов.