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]
fTPWorldFOV=97.0                ; Угол обзора (FOV) для вида от 3-го лица
fFPWorldFOV=97.0                ; Угол обзора (FOV) для вида от 1-го лица
iToggleKey=111                  ; Клавиша переключения псевдо-вида от 1-го лица (/ = 111, 115=F4, 112=F1, 36=Home, 65=A)
iADSKey=2                       ; Назначенная клавиша режима прицеливания (ADS)
bHUDProbe=1                     ; Включение/отключение проверки состояния элементов интерфейса (HUD)
; Комбинация кнопок геймпада для псевдо-вида (по умолчанию A+Select). Допустимые имена: A B X Y LB RB Select Start LStick RStick DUp DDown DLeft DRight LT RT
sPadToggleBtn1=A
sPadToggleBtn2=Select

[PseudoFP]
fFOV=97.0                       ; Угол обзора (FOV) для псевдо-вида от 1-го лица
fMaxYawDegrees=0                ; Максимальный угол поворота головы/камеры по горизонтали (в градусах)
bUltraRigidHeadAttach=1         ; Включает сверхжёсткую привязку камеры к голове персонажа
bUltraRigidIgnoreSanityChecks=false ; Игнорировать проверки корректности позиции при сверхжёсткой привязке
fHeadAttachGraceFrames=120      ; Количество сглаживающих кадров при привязке камеры к голове
fUltraRigidMaxPlanarOffset=1.5  ; Максимальное горизонтальное/плоскостное смещение при сверхжёсткой привязке
fUltraRigidHeightTolerance=3.5  ; Допустимое отклонение по высоте при сверхжёсткой привязке
fUltraRigidBaseForward=0        ; Базовое смещение камеры вперёд
fUltraRigidMotionForward=0      ; Смещение камеры вперёд во время движения
fNoseForward= 0                 ; Смещение камеры относительно кончика носа
fUpOffset = 0.0     ; Вверх/Вниз
fForwardOffset = 0.03   ; Вперёд/Назад
fSideOffset = 0     ; По центру

bSAFPitchSync=false             ; Синхронизация наклона камеры по вертикали во время анимаций SAF
bSAFRigidCamera=0   ; 1 = жёсткая фиксация кадра во время SAF, 0 = свободный обзор мышью + отдаление колёсиком во время SAF (высота головы всегда отслеживается)
fSAFOffsetForward = 0.12   ; SAF Вперёд/Назад (направление взгляда, центрирование глаз)
fSAFOffsetUp = 0.01       ; SAF Вверх/Вниз
fSAFOffsetSide = 0.0        ; SAF Влево/Вправо (0 = по центру головы)

bAutoEquipHideHead=1     ; Автоматически надевать ICSF_Hide_Head (невидимый головной убор) при активации псевдо-камеры (1=да, 0=нет)
bAutoEquipHideHeadSS=1   ; Автоматически надевать ICSF_Hide_Head_SS (невидимый шлем) при активации псевдо-камеры (1=да, 0=нет)
; Настройка ближней плоскости отсечения головы (порт fHeadShadowNear из FO4, шкала SF 0.00-0.40, 0=отключить отсечение)
bEnableHeadShadowNear=1         ; Включить отсечение ближней плоскости головы
fHeadShadowNear=0.12            ; Дистанция отсечения геометрии головы перед камерой
; Пресеты центрирования вида от 3-го лица (Mouse3: состояние 1 = Близко, состояние 2 = Далеко) — настройка из интерфейса OSF
fTPPCloseForward=-1.50          ; Смещение близкой камеры центрирования вида от 3-го лица: Вперёд / Назад
fTPPCloseUp=0.15                ; Смещение близкой камеры центрирования вида от 3-го лица: Вверх / Вниз
fTPPFarForward=-2.50            ; Смещение дальней камеры центрирования вида от 3-го лица: Вперёд / Назад
fTPPFarUp=0.25                  ; Смещение дальней камеры центрирования вида от 3-го лица: Вверх / Вниз

Или настройки через мод "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.10 (Official version V11)
• Добавлена функция сохранения настроек мода, благодаря чему они сохраняются между перезапусками игры.
• Исправлены различные другие ошибки.
• Исправлена функция, принудительно активировавшая псевдо-камеру.
• Улучшен свободный обзор / вращение камеры в режиме центрирования вида от 3-го лица.
• Добавлена функция «Запас коллизии» для центрирования вида от 3-го лица: значение 1.0 сохраняет столкновения со стенами/потолком с максимальным смещением вперёд (FWD) -2.5; значение 3.0 позволяет использовать максимальное смещение вперёд до -6.0, но игнорирует столкновения со стенами и потолком.
• Улучшены различные другие функции.
• Скрытие головы: добавлены новые ближние плоскости с полной настройкой через интерфейс OSF (OSF UI).
• Логика снаряжения: невидимые головные уборы и шлемы теперь добавляются только в инвентарь; псевдо-камера их больше не использует.
• Рефакторинг ядра: улучшено большинство встроенных функций.
• Центрирование вида от 3-го лица: обновлена обработка камеры и поведение вращения.
• Оптимизация: общие улучшения производительности.

Обновление:2.7 (Official version V8)
-> Добавлен переключатель «Только 3-е лицо по центру» — для тех, кому нужен этот режим без псевдо-1-го лица
-> Улучшена механика вращения камеры (орбита) в 3-м лице по центру
-> Исправлено несколько ошибок
-> Исправлено и улучшено прицеливание
-> Добавлено включение псевдо-камеры комбинацией на геймпаде: SELECT/BACK + A (по умолчанию), настраивается в меню
-> Добавлены ползунки смещения для 3-го лица по центру в меню настроек
-> Исправлено несколько ошибок

Обновление: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 под себя.
* Исправлено несколько багов.