OBSpaceWin · Windows x64 · 0.2.27

Короткий порядок: откройте OBS → подключите OBS в программе → выберите сцену →
свяжите клуб и судью → проверьте плашки → покажите их в эфире.

## 1. OBS и сцена

1. Распакуйте ZIP целиком в папку на ноутбуке и запустите «Запустить плашки.cmd».
2. Используйте уже открытый OBS. Программа не запускает второй OBS, не меняет
   сцену и не запускает или останавливает эфир.
3. В OBS откройте Инструменты → Настройки obs-websocket. Проверьте, что сервер
   включён, и используйте его текущий порт и настройки авторизации. Не меняйте
   общий пароль или порт OBS без необходимости: они нужны и другим программам.
4. В OBSpaceWin укажите порт и, если требуется, пароль; нажмите «Подключить OBS».
   После подключения явно выберите сцену, где должны быть плашки.
5. Нажмите «Добавить или проверить плашки». Новый источник добавляется скрытым.
   Когда будете готовы к эфиру, нажмите «Показать в эфире». Скрыть источник можно
   кнопкой программы или значком глаза в OBS.

При включённой WebSocket-авторизации Windows сохраняет пароль в Credential
Manager только после успешного подключения. До этого введённый пароль находится
в памяти открытой программы. Неудачная попытка не заменяет сохранённый пароль.
Если авторизация в OBS выключена, пароль не нужен и не сохраняется.

## 2. Привязка клуба и судьи

Привязка OBS действует для клуба и сохраняется между играми.

1. Если OBSpaceWin показывает код, нажмите «Скопировать код».
   При сохранённой рабочей привязке новый код получать не нужно.
2. В Club OS откройте «Трансляция», введите код из OBS и подключите OBS клуба.
3. В поле «Эфир вести от имени судьи» выберите судью, чей стол будет передаваться.
   Это настройка клуба, она остаётся выбранной для следующих игр.
4. На телефоне судья входит в свой аккаунт MafiaSpace, сам выбирает свой вечер и
   игру, затем выбирает подготовленную рассадку из MafiaUniverse.

Не запрашивайте новый код перед каждой игрой. «Новый код подключения» меняет
привязку OBS к клубу; это нужно при первоначальной настройке или смене привязки.
Выбор другого вечера или следующей игры сам по себе привязку не сбрасывает.

## 3. Камера и микрофон · по желанию

Эта настройка отдельна от показа плашек. По умолчанию программа работает вручную.
Авто включается только по явному действию и после выбора источников и подготовки.
После запуска или обновления снова включён Ручной режим.

1. Откройте вкладку «Камера и микрофон» и нажмите «Обновить список источников
   выбранной сцены».
2. Выберите камеру и микрофон из этой сцены, затем нажмите «Подготовить управление
   (эфир сохранится)».
3. Если нужно автоматически применять режим дня и ночи выбранной игры, нажмите
   «Включить Авто». «Ручной» останавливает автоматику. Без этого действия программа
   не переключает камеру, эффекты или микрофон по фазам игры.

Авто сохраняет включённое намерение при обрыве связи с OBS или игрой и продолжает
после восстановления. Оно управляет выбранным микрофоном и своими ночными
эффектами; громкость и остальные источники звука не меняет. Выключение программы
не завершает OBS и эфир. Перед выходом проверьте текущее состояние микрофона.

## Обновление и завершение

Закрытие окна сворачивает OBSpaceWin; соединение и обновление плашек продолжаются.
Для остановки нажмите «Завершить программу». OBS и эфир останутся открытыми,
программа остановит свою автоматику и сохранит текущее состояние ночи и микрофона.

Оформление обновляется отдельно: проверка выполняется при запуске и раз в минуту.
Проверенная новая версия применяется сразу, в том числе во время игры.
Камера, микрофон, сцена и клубная привязка сохраняются. Прежний вид можно вернуть
в разделе «Оформление»; этот выбор не отменяется автоматическим обновлением.

Не удаляйте `%LOCALAPPDATA%\MafiaSpace\GraphicsOnly` при обновлении: там
сохраняются настройки программы. Пароль OBS хранится отдельно в Windows
Credential Manager; ключ подключения игры также хранится в Credential Manager.

Если подготовка просит вернуть день для прежних источников, нажмите
«Ручной» → «День / вернуть». Программа проверит прежние источники и вернёт
свои ночные изменения. Затем подготовьте выбранные камеру и микрофон заново.

Если положение заставки в OBS изменено, программа сохраняет его. Камера,
микрофон и возврат дня продолжают работать; для закрытой ночи используется
собственный тёмный экран вместо перемещённой картинки.

После удаления наших экранов нажмите «День / вернуть», затем «Подготовить
управление». Программа восстановит удалённые источники скрытыми. Собственный
ночной экран будет восстановлен на полный кадр, пока он скрыт. Версия программы
видна в заголовке окна: OBSpaceWin 0.2.27.

Оформление проверяется автоматически при запуске и каждую минуту. Проверенный
пакет применяется сразу после загрузки, включая текущую игру. Ожидать паузу
или нажимать «Применить» не требуется. Это меняет только оформление плашек;
сцена, звук, камера и режим «Авто» остаются прежними. Кнопки ручного применения
и возврата сохранены. После возврата тот же выпуск автоматически не вернётся;
следующий более новый выпуск снова может установиться автоматически.

Оформление клуба: кабинет клуба → Трансляция → Оформление.
Можно менять четыре цвета ролей и показывать/скрывать жетон шерифа и кольцо дона.
Текст на выбранном фоне подбирается автоматически. Сохранённое оформление
приходит в программу вместе с данными эфира; перезапуск OBS не требуется.

Обрыв связи телефона не скрывает уже открытые роли. Они читаются с сервера
даже при старом checkpoint и после переподключения Windows-программы.
При обрыве связи с самим сервером сохраняются последние публичные роли.
Явное скрытие ролей, новая игра или отзыв доступа по-прежнему очищают их показ.
Подсветка речи/выставлений и автоматика требуют свежих данных телефона.
