OSF UI - Web Interface Framework / Веб-интерфейсная платформа

OSF UI - Web Interface Framework - позволяет модам создавать внутриигровые интерфейсы с использованием HTML, CSS и JavaScript. Он предоставляет фреймворк для пользовательских меню и оверлеев HUD с возможностью подключения к Papyrus или C++. Устанавливайте данный фреймворк вместе с модами, которые этого требуют, после чего открывайте их интерфейсы через управление самого мода или в моде "OSF Settings - Mod Configuration Menu (MCM - Меню настройки модов).

Новое в версии 2.0: настройки модов, назначение клавиш и отчёты о проблемах перенесены в *OSF Settings - Mod Configuration Menu*. Теперь *OSF Settings - Mod Configuration Menu* является обязательным требованием для OSF UI. Установите оба мода, чтобы использовать модификации на базе OSF UI. Модам, созданным только для OSF Settings, мод OSF UI не требуется.

ВОЗМОЖНОСТИ:
* Пользовательские интерфейсы: создавайте меню и интерактивные панели с помощью HTML, CSS и JavaScript.
* Оверлеи HUD: отображайте прозрачные пассивные элементы интерфейса во время игры с поддержкой нескольких слоев HUD.
* Поддержка C++ и Papyrus: подключайте интерфейсы к вашему моду через Papyrus или прямо внутри C++ плагина SFSE.
* Ввод с клавиатуры, мыши и геймпада: поддержка интерактивного управления и навигации с контроллера (поддержка геймпада зависит от конкретного интерфейса).
* Единое меню запуска: поддерживаемые моды могут выводить свои меню в списке "OSF Settings - Mod Configuration Menu" для быстрого доступа.

Обратите внимание: OSF UI — это технический фреймворк. Пользовательские меню и элементы HUD поставляются отдельными модами; установка одного лишь OSF UI не добавляет новые интерфейсы в игру.

АВТОРАМ МОДОВ:
Поставляйте манифест представления (view manifest), а также локальные файлы HTML, CSS и JavaScript. Используйте C++ или Papyrus API для открытия представлений, обработки команд и запросов, отправки событий и поддержания актуального состояния интерфейса.
* Меню и элементы HUD: выбирайте между интерактивным меню или пассивным HUD. Меню могут захватывать ввод и при необходимости ставить игру на паузу.
* Интеграция с меню запуска: добавьте запись запуска в манифест меню, чтобы отобразить его в списке OSF Settings.
* Настройки и горячие клавиши: используйте OSF Settings для конфигурации, переназначаемых клавиш и отчётов о проблемах. Передавайте любые настройки, необходимые вашему веб-интерфейсу, через OSF UI.
* Инструменты разработчика: включите режим разработчика (Developer mode) на странице настроек OSF UI и перезапустите игру, чтобы получить доступ к WebView DevTools (F12) и горячей перезагрузке файлов без перезапуска игры.

МИНИМАЛЬНЫЙ ПРИМЕР МАНИФЕСТА ПРЕДСТАВЛЕНИЯ:
Разместите ваш манифест по пути:
Data/SFSE/Plugins/OSF/UI/views/mymod/panel/manifest.json

Поместите `index.html` и ресурсы интерфейса в ту же папку.

{
  "manifestVersion": 1,
  "title": "My Mod",
  "entry": "index.html",
  "kind": "menu",
  "capturesInput": true,
  "pausesGame": true,
  "launcher": true
}

Идентификатор (ID) этого представления: `mymod/panel`.
Собирайте все нужные для вашей страницы файлы локально: сетевые функции браузера и запросы страницы на открытие внешних окон заблокированы.
Руководство по SDK, примеры, справку по манифесту, заметки о совместимости с версией 1.6 и руководство по миграции см. на GitHub. Новые интеграции должны использовать API версии 2.0.

УСТРАНЕНИЕ НЕПОЛАДОК:
#### Я установил OSF UI, но ничего нового не появилось
OSF UI — это просто технический фреймворк. Установите мод, предоставляющий интерфейс на базе OSF UI, и следуйте инструкциям этого мода для его открытия.

#### В меню паузы отсутствует пункт НАСТРОЙКИ МОДОВ (MOD SETTINGS)
Установите и включите *OSF Settings*, запустите игру через SFSE и убедитесь, что `OSFSettings.dll` успешно загрузился (согласно логу SFSE). Проверьте, не была ли переназначена клавиша открытия.

#### Мод отсутствует в меню запуска
Там отображаются только меню, официально зарегистрированные для меню запуска. Элементы HUD и меню, открываемые через собственное управление мода, могут не иметь записи в меню запуска.

#### Меню не открывается или отображается пустым
Убедитесь, что установлен *WebView2 Evergreen Runtime*, полный пакет OSF UI включен, а файлы интерфейса мода находятся на месте. Проверьте раздел *ПРОБЛЕМЫ С МОДАМИ* в интерфейсе "OSF Settings" на наличие сообщений об ошибках и рекомендаций по их устранению.

#### Сообщение об ошибке (баге)
Укажите, что именно произошло, шаги для воспроизведения, затрагиваемый мод и вашу версию OSF UI. Для проблем с отображением графики также укажите, используете ли вы HDR, генерацию кадров или другие сторонние оверлеи.
Прикрепите логи *OSF UI* и *SFSE*, а также файл `OSF UI.webview2-host.log` (если он есть) из папки и отправьте автору на Нексусе:

`Документы\My Games\Starfield\SFSE\Logs`

ТРЕБОВАНИЯ:
Starfield 1.16.244
Starfield Script Extender (SFSE)
Address Library for SFSE Plugins
OSF Settings - Mod Configuration Menu (MCM)
Microsoft Edge WebView2 Evergreen Runtime - обычно уже установлен в большинство систем Windows 10/11. Убедитесь в его наличии, если интерфейс не работает.

УСТАНОВКА:
Установите требования, затем установите OSF UI с помощью MO2 или Vortex или NMM и включите его. Для OSF UI не требуется активация плагинов ESM или ESP.
Запустите Starfield через SFSE и загрузите сохранение.
Откройте НАСТРОЙКИ МОДОВ в меню паузы игры — все зарегистрированные интерфейсы отобразятся в списке. Некоторые моды открывают свои меню через собственные горячие клавиши или игровые действия.

УСТАНОВКА И ОБНОВЛЕНИЕ ВО ВРЕМЯ ИГРЫ:
Поддерживается установка и обновление прямо поверх существующих сохранений. Устанавливать и удалять можно в любой момент *(учтите, что зависимые моды могут перестать работать при удалении)*.