mod_scenario_studio/docs/ru.md

# Scenario Studio — отладка и правка сценариев прямо во время игры

Scenario Studio — это панель рядом с запущенной игрой, которая показывает, какой сценарий играет и какая строка сейчас на экране. Она умеет ставить диалог на паузу, идти по нему строка за строкой, останавливаться на точках останова, переносить следующую строку, перезапускать сценарий с откатом состояния игры и менять сценарий на ходу — и тут же показывает изменения в игре.

Режима два: **Новичок** показывает сюжетный момент простыми блоками, **Автор** — текст сценария с номерами строк.

## Как открыть

У игры, в которую входит набор Developer Tools (механика *Scenario Studio*), на панели инструментов есть кнопка **Студия** — перо. Флаг запуска `--studio` открывает панель сразу при старте. Снимки ниже сделаны на кухне Cthangover; правки уходили в тестовый слой, а не в файлы самой игры.

## Режим «Новичок»

![Кухня с панелью «Студия» справа в режиме «Новичок»: сцена home_kitchen, сценарий home_kitchen_cooking, значок слоя; под «Сейчас на экране» реплика «Новая реплика» и вопрос «Комната оборудованная под кухню»; ответы «Выйти» (ведёт в сцену home_vestibule), «Готовить» (действие toggle_cooking_workbench) и новый ответ, у каждого — «Выбрать, куда» и «Изменить»; кнопки «+ Реплика до вопроса» и «+ Вариант ответа»; блок «Изменение затронет» с целевым слоем и кнопка «Применить» внизу.](assets/studio-novice.jpg)

Вкладка **Сейчас** показывает момент на экране: реплику, вопрос и все ответы с тем, куда каждый ведёт. **Изменить** правит текст, **Выбрать, куда** меняет, куда ведёт ответ (метка, другая сцена, конец), **+ Реплика** и **+ Вариант ответа** добавляют к моменту. У каждой правки блок **Изменение затронет** показывает, в какой мод или слой она попадёт.

## Режим «Автор», пауза и точки останова

![Панель в режиме «Автор»: на транспортной панели «Пауза», «Шаг», «Дальше», «Ресурсы» и «Перезапуск»; текст сценария home_kitchen, где строка 6 — select «Комната оборудованная под кухню» — отмечена красной точкой останова и маркером ▶ текущей строки; под ней «после строки 9» с кнопками «+ Реплика», «+ Выбор», «+ Переход в сцену» и целевым слоем my_studio.](assets/dock-breakpoint.jpg)

- **Пауза** задержит диалог перед следующей строкой; **Шаг** выполнит одну строку; **Дальше** продолжит.
- Клик на поле слева ставит **точку останова**: диалог остановится перед этой строкой.
- Перетаскивание маркера **▶** на другую строку назначает её следующей.
- **+ Реплика**, **+ Выбор**, **+ Переход в сцену** добавляют после текущей строки; **Править текст** правит весь сценарий.

## Применение и перезапуск

**Применить** записывает правки и перезапускает сценарий. Здесь перед вопросом добавлена реплика «Новая реплика»; после применения она на экране:

![Панель после применения: на экране «Новая реплика», статус «Применено в «my_studio», сценарий перезапущен с откатом».](assets/dock-applied.jpg)

**Перезапуск** предлагает: прогнать сценарий заново без отката, прогнать заново **с откатом состояния** (флаги, предметы, часы и остальное вернутся к тому, как было при старте сценария), заново войти в сцену или продолжить с текущей метки.

## Осмотр состояния

![Вкладка «Состояние»: «Значения можно менять, чтобы попробовать другую ветку», часы — день 24, время 23:00.](assets/dock-state.jpg)

Вкладка **Состояние** показывает состояние игры по владельцам: часы, переменные идущего диалога, задания, на которые ссылается сценарий, инвентарь и какие сценарии уже выполнялись. Переменные, количество предметов и статус заданий можно менять (Enter записывает их в игру), чтобы попробовать другую ветку. Вкладка **Сцена** перечисляет сценарии текущей сцены, **Карта** показывает сцены и пути между ними (и куда бросать новые фоны), а **Журнал** записывает, что происходило:

![Вкладка «Журнал»: вход в home_kitchen, старт home_kitchen_cooking, правка «+6 → my_studio», перезапуски, «точка останова, строка 6», «следующая строка перенесена на 5», «контрольная точка в home_kitchen».](assets/dock-log.jpg)

## Куда пишутся изменения

- Мод, установленный папкой, можно менять на месте.
- Иначе правки уходят в **слой студии** игры (`user://studio/<game>`), который главнее любого мода и не трогает сами моды. Слой можно выгрузить в новый мод, который затем добавляется в коллекцию игры.
- **Ресурсы** перечитывает фоны, брошенные во время игры в мод или в папку `backgrounds/` слоя; после этого на таком фоне можно завести новую сцену прямо со вкладки «Карта».

## Если что-то пошло не так

1. **Кнопки «Студия» нет.** В коллекцию игры не входит студия — добавьте набор Developer Tools или запустите с `--studio`.
2. **«Шаг» ничего не делает.** Диалог ждёт ответ: сначала выберите его.
3. **Другие игроки не видят правку.** Изменения в слое студии остаются в этой игре на этом компьютере; выгрузите слой как мод, чтобы поделиться.