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

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

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

Особенности:
* Полное тело от первого лица — смотрите на тело, экипировку и броню своего персонажа в режиме вида от первого лица.
* Отслеживание головы (Head tracking) — камера следует за костью головы во время стандартных анимаций (ходьба, бег, спринт, прыжки, прицеливание).
* Поворот игрока при взгляде — модель вашего персонажа естественно поворачивается, когда вы смотрите влево или вправо в режиме псевдо-вида от первого лица.
* Включение/выключение — По умолчанию: Numpad / (можно изменить в файле настроек SomaticCameraSF.ini)
* Совместимость с анимациями от третьего лица — анимации тела воспроизводятся в обычном режиме, пока вы находитесь в режиме псевдо-вида от первого лица.
* INI-файлы — для ручной настройки псевдо-камеры.

* В файле `SomaticCameraSF.ini` есть функции для управления положением псевдокамеры:
iToggleKey=111 - переключение горячей клавиши псевдокамеры (/ = 111, 115=F4, 112=F1, 36=Home, 65=A)
fUpOffset — высота камеры / вертикальное положение
fForwardOffset — перемещение камеры вперед/назад
fSideOffset — центрирование камеры, если она смещается в сторону
fSAFOffsetForward — центрирует камеру, если она смещается от центра (для мода SAF - Deputy NAF)
fSAFOffsetSide — перемещает камеру вперёд/назад (для мода SAF - Deputy NAF)
fSAFOffsetUp — высота/вертикальное положение камеры (для мода SAF - Deputy NAF)
bAutoEquipHideHead=1 - автоматически экипировать ICSF_Hide_Head (невидимый головной убор) при активации псевдокамеры (1=да, 0=нет)
bAutoEquipHideHeadSS=1 - автоматически экипировать ICSF_Hide_Head_SS (невидимый шлем) при активации псевдокамеры (1=да, 0=нет)

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

Задачи в будущем:
- Анимация сидения и вставания пилота в кресле.
- Полёт корабля с использованием псевдокамеры.

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

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

Использование:
Горячую клавишу переключения можно настроить в настройках игры. По умолчанию:

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

Технические заметки:
Создано с использованием CommonLibSF и MinHook. Мод внедряет хуки в ThirdPersonState::Update и TESCamera::Update, чтобы переопределять положение камеры без изменения файлов игры.

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


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