Files
DndGamePlayer/docs/instructions-new-features-after-1.0.29.md
Ivan Fontosh 712086ddca feat: кубики/таймер/кисть/спонсоры и задел игровых систем
Показ анимации кубиков игрокам, закрытие оверлеев с окнами, ручной ввод количества, меньший радиус кисти, блок спонсоров в «О программе»; плюс черновик game systems / character sheet.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-13 15:37:44 +08:00

148 lines
11 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Инструкции: новые функции после 1.0.29
Все инструменты ниже (кроме шаблонов сетки, плейлистов в редакторе и экрана презентации) доступны во время сессии на **пульте управления**.
---
## 1. Кубики (3D)
**Где:** Пульт → **Инструменты** → 🎲 **Кубики**.
1. Выберите тип кубика: d4, d6, d8, d10, d12, d20 или d100.
2. Задайте **Количество** кнопками **−** / **+** или введите число вручную (от 0 до 20).
3. При необходимости включите **Показать анимацию игрокам** (по умолчанию включено).
4. Нажмите **Бросить**.
5. Если галочка включена — на экране игроков (презентация) проиграет 3D-анимация; в окне «Кубики» сразу появятся грани и **Сумма**. Если выключена — анимация не показывается, результат виден только мастеру в окне «Кубики».
6. Чтобы убрать кубики с экрана и очистить результат — **Убрать**.
7. **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. На предпросмотре пульта: перетащите таймер; углы — размер; ручка сверху — поворот. На презентации только просмотр.
**Важно:** пока идёт отсчёт, длительность менять нельзя. При нуле таймер останавливается. Без **Показать игрокам** игроки его не видят. Закрытие окна «Таймер» (Esc / крестик) скрывает виджет с презентации и предпросмотра и ставит отсчёт на паузу, если он шёл.
---
## 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. Рисуйте на предпросмотре: открытие снимает тьму, закрытие снова накрывает участки. У игроков закрытое — чёрное; у вас на пульте — полутень.
**Важно:** это не эффект действия **Тьма** 🌑. Состояние тьмы помнится, пока идёт показ и вы возвращаетесь на ту же карточку сцены.
---
## Краткая карта инструментов пульта
Маркер · Описание · Материалы · Плейлисты · Таймер · Инициатива · Кубики · НПС