docs: инструкции и обложка ВК по новым фичам после 1.0.29

Co-authored-by: Cursor <cursoragent@cursor.com>

docs/instructions-new-features-after-1.0.29.md

@@ -0,0 +1,146 @@
+# Инструкции: новые функции после 1.0.29
+
+Все инструменты ниже (кроме шаблонов сетки, плейлистов в редакторе и экрана презентации) доступны во время сессии на **пульте управления**.
+
+---
+
+## 1. Кубики (3D)
+
+**Где:** Пульт → **Инструменты** → 🎲 **Кубики**.
+
+1. Выберите тип кубика: d4, d6, d8, d10, d12, d20 или d100.
+2. Задайте **Количество** кнопками **−** / **+** (от 1 до 20).
+3. Нажмите **Бросить**.
+4. На экране игроков (презентация) проиграет 3D-анимация; в окне «Кубики» сразу появятся грани и **Сумма**.
+5. Чтобы убрать кубики с экрана и очистить результат — **Убрать**.
+6. **Esc** закрывает окно (результат на экране при этом не снимается, пока не нажали **Убрать**).
+
+**Важно:**
+- Анимация показывается на **презентации**; мастер смотрит числа в окне «Кубики».
+- d100 в приложении — кубик **десятков** (грани 10, 20, …, 90, 00/100). Результат совпадает с гранью, а не с диапазоном 20–29.
+- Оверлей не скрывается сам — только кнопкой **Убрать**.
+- Новый бросок можно сделать, не нажимая **Убрать**.
+
+---
+
+## 2. Трекер инициативы
+
+**Где:** Пульт → **Инструменты** → ⚔ **Инициатива**.
+
+1. При открытии окна трекер включается: в **Очередь** попадают НПС с токенами на текущей сцене и игроки сессии (если показаны).
+2. **Имя вручную** + **Добавить** (или Enter) — запись без токена на карте (буква и цветной фон).
+3. Перетаскивайте строки в очереди, чтобы задать порядок хода.
+4. Клик по участнику делает его текущим; **Следующий** — следующий в цикле.
+5. Кнопка **+** у участника — меню **Состояния** (Испуган, Ослеплён, Без сознания и т.д.). Чип с **×** снимает состояние.
+6. **×** на слоте — убрать в **Запас**. Из запаса: **Вернуть**; у ручных записей ещё **Удалить**.
+
+**На карте:**
+- Пока трекер открыт, у текущего хода подсветка курсора на токене.
+- Под токенами НПС и игроков видны чипы состояний (на пульте и презентации).
+
+**Важно:**
+- Скрытые игроки (**Скрыть игроков**) уходят в **Запас**.
+- При смене сцены или конце сессии трекер очищается.
+- Закрытие окна инициативы отключает подсветку хода на карте.
+
+---
+
+## 3. Таймер сессии
+
+**Где:** Пульт → **Инструменты** → ⏱ **Таймер**.
+
+1. Выберите пресет **01:00** / **05:00** / **10:00** или введите **Длительность (MM:SS)** и подтвердите Enter / уходом с поля.
+2. **Старт** — запуск, **Пауза** — пауза, **Сброс** — в начало.
+3. Включите **Показать игрокам** — виджет появится на предпросмотре и на презентации.
+4. На предпросмотре пульта: перетащите таймер; углы — размер; ручка сверху — поворот. На презентации только просмотр.
+
+**Важно:** пока идёт отсчёт, длительность менять нельзя. При нуле таймер останавливается. Без **Показать игрокам** игроки его не видят.
+
+---
+
+## 4. Плейлисты
+
+**В редакторе (создание и правка):** шапка → **Плейлисты**.
+
+1. **Создать** — новый плейлист.
+2. **Добавить аудио** или перетащите файлы в окно (*Перетащите аудиофайлы сюда*).
+3. Можно переименовать плейлист/трек, дублировать, удалить, искать, запускать плеер (**Играть** / **Пауза**, prev/next, громкость, перемотка).
+
+**На пульте (только воспроизведение):** **Инструменты** → 🎵 **Плейлисты**.
+
+Там же список и плеер, но без создания и правки.
+
+**Важно:** библиотека хранится в приложении на этом компьютере, не внутри файла кампании.
+
+---
+
+## 5. Шаблоны сетки кампании
+
+**Где:** свойства сцены → **Редактор сцены** → аккордеон **Сетка** → **Шаблоны кампании**.
+
+1. Включите **Наложить сетку**, настройте тип, цвет и размер.
+2. **Сохранить как шаблон** — задайте имя → **Сохранить**.
+3. На любой сцене в списке шаблонов нажмите **Применить** — сетка включится с сохранённым стилем.
+4. Шаблоны можно переименовать и удалить (с подтверждением).
+
+**Важно:** шаблоны пишутся в файл проекта (лимит около 20). На другие сцены сами не подставляются — только по **Применить**.
+
+---
+
+## 6. Аккордеон «Сцены» на пульте
+
+**Где:** левая колонка пульта, рядом с **История** → **Сцены** (по умолчанию свёрнут).
+
+1. Раскройте **Сцены**.
+2. Увидите все сцены **текущей сюжетной линии** в порядке редактора.
+3. Клик по сцене — переход к ней. Текущая помечена как **Текущая сцена**; уже посещённые — **Пройдено**.
+
+**Отличие от «История»:** история — только цепочка визитов этой сессии; **Сцены** — полный список линии, включая ещё не посещённые.
+
+---
+
+## 7. Экран презентации при запуске
+
+**Где:** редактор → **Настройки** → **Экран презентации**.
+
+1. Выберите **Монитор** (основной или второй).
+2. При необходимости включите **Полноэкранный режим**.
+3. **Сохранить**.
+
+При каждом **Запустить** / **Запустить с этой сцены** / **Запустить с игроками** окно презентации откроется на выбранном мониторе. Пульт всегда на основном экране.
+
+---
+
+## 8. Маркер на области видимости
+
+**Где:** Пульт → **Инструменты** → 🖍️ **Маркер**.
+
+1. В блоке эффектов при необходимости выберите **Форма кисти** (**Круглая** / **Квадратная**), **Цвет маркера** и **Радиус кисти**.
+2. Рисуйте левой кнопкой в **Предпросмотр экрана** — штрихи видны вам и игрокам.
+3. **Ластик** стирает маркеры в той же зоне; **Очистить эффекты** убирает и эффекты, и маркеры.
+
+**Важно:** рисовать нужно внутри **жёлтой рамки** (область видимости / соотношение экрана игроков). Клики вне рамки для маркера игнорируются. Это не туман войны и не **Затемнить сцену**.
+
+---
+
+## 9. История и кисти затемнения
+
+### История
+
+Левая колонка → **История** (по умолчанию открыта): цепочка сцен текущей сессии. Клик по прошлой — переход; текущая — **Текущая сцена**, прошлые — **Пройдено**.
+
+### Кисти затемнения
+
+Только если у сцены включено **Затемнить сцену**.
+
+1. Блок **Управление затемнением**: 🔦 **Кисть Открытия** / ⬛ **Кисть Закрытия**.
+2. При выборе инструмента доступны **Форма кисти** (**Круглая** / **Квадратная**) и **Радиус кисти**.
+3. Рисуйте на предпросмотре: открытие снимает тьму, закрытие снова накрывает участки. У игроков закрытое — чёрное; у вас на пульте — полутень.
+
+**Важно:** это не эффект действия **Тьма** 🌑. Состояние тьмы помнится, пока идёт показ и вы возвращаетесь на ту же карточку сцены.
+
+---
+
+## Краткая карта инструментов пульта
+
+Маркер · Описание · Материалы · Плейлисты · Таймер · Инициатива · Кубики · НПС