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

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

> ⚠ Бета-версия — мод работает, но всё еще находится в разработке. Некоторые функции не завершены, и могут возникать ошибки. См. раздел «Известные проблемы» ниже.

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

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

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

Установка:
Через мод-менеджер или вручную:
1. Установите SFSE и Address Library, если они еще не установлены.
2. Распакуйте архив.
3. Скопируйте файлы ImprovedCameraSF.dll и ImprovedCameraSF.ini по пути ВашаПапкаСИгрой\Data\SFSE\Plugins\.
4. Запустите игру через SFSE.

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

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

Известные проблемы:
⚠ Это бета-версия. Мод работает, но еще не отполирован. Возможны недоработки.
* Голова видна в режиме псевдо-FPP — камера находится в районе головы, из-за чего изнутри можно увидеть меш головы (рот, нос, глаза). Мы пока не нашли эффективного способа скрыть геометрию головы в Starfield. Ни один из опробованных подходов (установка бита флага kHidden, масштабирование почти до нуля, изменение ограничивающей сферы, смещение геометрии из зоны видимости) не сработал стабильно.
* Сторонние моды на анимацию могут приводить к временному отсоединению камеры от головы во время кастомных анимаций. В качестве резервного варианта камера возвращается к отслеживанию корневой позиции (root) игрока, если кость головы не удается считать.
* Доставание/убирание оружия может вызывать кратковременное смещение камеры во время перезагрузки скелета модели.

Планы разработки:
* Полноценное переключение видимости геометрии головы/тела (исследуется правильный флаг NiAVObject в Starfield).
* Улучшение отслеживания при использовании сторонних модов на анимацию.
* Тонкая настройка смещения камеры вперед.
* Поворот камеры вперед для псевдо-FPP (в данный момент используется ориентация камеры от третьего лица).
* Смещение вперед для улучшения отсечения геометрии головы.
* Настройка смещений и клавиш переключения через INI-файл.

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

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


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

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