feat: save games and edit scene darkness

Persist show state to local saves; author map darkness in scene editor with bake-to-scene and help updates. Co-authored-by: Cursor <cursoragent@cursor.com>
2026-10-06 11:41:42 +08:00
parent f6c301a12b
commit 877fbaa8e7
43 changed files with 2086 additions and 72 deletions
@@ -0,0 +1,57 @@
+# Сохранение игры
+
+Слепок показа по явной кнопке мастера. Файл партии не меняется. Новый «Запустить» по-прежнему открывает пустую сессию.
+
+## Как мастер этим пользуется
+
+- На пульте, в ряду над «Предпросмотр экрана», сразу после текстовой кнопки «Завершить» — кнопка-иконка с дискетой. Подпись на кнопке нет. Тултип и имя для чтения с экрана: «Сохранить» (EN: Save). Высота как у соседней «Завершить», вид как у иконок инструментов (`iconOnly`).
+- Вторая «Завершить» в пустой ветке («Нет вариантов перехода») без дискеты. Сохранение одно, над предпросмотром.
+- Клик по дискете открывает модалку в стиле остальных подтверждений пульта. Заголовок «Сохранить игру». Список — только сохранения открытой партии. Клик по строке не пишет файл: он подставляет имя и помечает эту запись на перезапись. Новое сохранение — другое имя в поле и ни одна строка не выбрана. Пишет файл кнопка «Сохранить» внизу. Рядом «Отмена». Второго подтверждения нет. Показ не закрывается. Пустое имя подставляется датой и временем.
+- Имя хранится внутри файла. На диске у сохранения свой id, чтобы два одинаковых имени не затирали друг друга.
+- «Загрузить сохранение» — пункт меню кнопки «Запустить». Он открывает отдельное окно со списком, в том же стиле, что выбор игроков у «Запустить с игроками», а не подменю имён. Клик по строке её выбирает, показ открывает кнопка «Загрузить». «Отмена» оставляет редактор. Если сохранений этой партии нет, пункт меню неактивен и окно не открывается. Пункт «Запустить с этой сцены» на графе сохранение не грузит: слепок сам открывает карточку, на которой остановились.
+- Все пути закрытия показа (обе кнопки «Завершить», Escape, крестик презентации и пульта) открывают «Завершить показ?». Если в этом показе ещё не сохранялись или стол изменился после последнего сохранения, в окне три действия: «Сохранить и завершить», «Завершить без сохранения», «Отмена». «Сохранить и завершить» закрывает этот вопрос и открывает модалку дискеты; после успешной записи показ закрывается. «Отмена» в модалке сохранения оставляет показ открытым. «Завершить без сохранения» закрывает показ сразу. Если изменений нет, окно как сейчас: «Отмена» и «Завершить». Английские подписи: Save and end, End without saving, Cancel.
+- Экспорта и импорта сохранений нет. Файл лежит в данных приложения и привязан к `id` партии на этом компьютере.
+- Копия архива партии на другой компьютер исследование не увозит. Повторный импорт той же партии на этот компьютер получает новый `id`, старые сохранения остаются у исходного файла.
+
+## Что попадает в слепок
+
+Уже помнится весь показ и пишется по всем посещённым карточкам графа:
+
+- карточка, на которой остановились;
+- штрихи затемнения и маркеры;
+- состояние ловушек;
+- сдвиги токенов сцены и НПС, токены НПС, вызванные на сессию, скрытие от игроков, общий масштаб НПС;
+- путь токена как пауза: точка на пути, без привязки к часам;
+- таймер как пауза: остаток времени, без абсолютного момента конца.
+
+Эффекты поля (туман, огонь, дождь, вода) и следы, которые сами не истекают (лёд после заморозки, тёмное пятно после тьмы-действия), пишутся по всем посещённым карточкам. При смене карточки они остаются на той, где их нарисовали, и возвращаются вместе с ней. Ластик и «Очистить эффекты» снимают их с текущей карточки. В сохранение попадает этот же кэш. Ключ карточки тот же, что у затемнения: узел графа, иначе id сцены.
+
+Токены игроков — только слепок карточки в момент «Сохранить игру», и только если они были показаны. В слепок входят выбранные игроки, флаг показа и их позиции на этой карточке. На уже покинутых карточках позиции игроков не пишутся. После загрузки смена карточки по-прежнему убирает токены игроков с карты. Логика показа, скрытия и сброса при переходах не меняется.
+
+На момент сохранения, без памяти по прошлым карточкам, пишутся ещё камера, материалы поверх сцены, крупные аватары НПС и трекер инициативы. Это то, что показ и так держит только для текущей карточки.
+
+Не пишутся черновик незавершённого штриха, идущий бросок костей и сами разовые эффекты действий (молния, луч света, облако яда, взрыв, вспышка заморозки, тьма-действие). Лёд и тёмное пятно, которые после них остаются на карте, пишутся.
+
+## Справка
+
+Тексты на русском и английском, в тех же разделах, что уже есть. Ниже русский смысл; английский повторяет его.
+
+«Запуск сессии» — после абзаца про «Запустить с игроками»:
+
+Стрелка справа на «Запустить» → «Загрузить сохранение». Открывается отдельное окно со списком сохранений этой партии на этом компьютере. Строку выбирают кликом, показ открывает кнопка «Загрузить»: карточка, где нажали «Сохранить», открытые участки, эффекты поля, токены и остальное из файла. Обычный «Запустить» сохранение не подхватывает. Если сохранений нет, пункт неактивен. «Запустить с этой сцены» по-прежнему открывает выбранную карточку с пустой сессией.
+
+В шагах «Вернуться к подготовке»: если с последнего сохранения стол изменился или в этом показе ещё не сохранялись, «Завершить показ?» даёт три действия. «Сохранить и завершить» открывает список сохранений и после записи закрывает показ. «Завершить без сохранения» закрывает показ сразу. «Отмена» оставляет показ. Если изменений нет, в окне по-прежнему только «Отмена» и «Завершить».
+
+«Пульт управления» — рядом с описанием «Завершить»:
+
+Сразу после «Завершить» над предпросмотром — дискета, подсказка «Сохранить». Она открывает список сохранений этой партии. Клик по строке подставляет её имя для перезаписи, файл пишет кнопка «Сохранить». Новое имя без выбранной строки создаёт ещё одну запись. Показ остаётся открытым. В файл входят исследование карты, эффекты поля на посещённых карточках, лёд и тёмные пятна, маркеры, ловушки, токены сцены и НПС, а также токены игроков на текущей карточке, если они были показаны. Файл остаётся на этом компьютере и не попадает в архив партии. Если закрывать показ с несохранёнными изменениями, «Завершить показ?» предлагает «Сохранить и завершить», «Завершить без сохранения» и «Отмена».
+
+«Эффекты поля и действий» — после списка полевых кистей:
+
+Туман, дождь, огонь, вода, а также лёд после заморозки и тёмное пятно после тьмы-действия остаются на карточке, пока идёт показ. Переход на другую сцену их прячет, возврат на ту же карточку показывает снова. Ластик и «Очистить эффекты» стирают их с текущей карточки до конца этого показа. В сохранение через дискету они входят вместе с остальным слепком. Сами эффекты действий при смене сцены по-прежнему пропадают.
+
+## Чего сохранение не делает
+
+- Не встраивается в `.ttrpg.zip` и не едет вместе с экспортом партии.
+- Не продолжает сессию само при обычном «Запустить».
+- Не начинает помнить позиции игроков на каждой посещённой карточке.
@@ -0,0 +1,35 @@
+# Затемнение сцены в редакторе
+
+Согласовано. Стартовый рисунок тьмы живёт в файле партии; показ и сохранение игры рисуют поверх.
+
+## Интерфейс
+
+- Галочку «Затемнить сцену» убрать из свойств сцены в инспекторе редактора кампании.
+- В «Редактор сцены» — аккордеон «Затемнение сцены» (не вкладка).
+- Внутри: переключатель «Затемнить сцену». При включении превью заливается 100% тьмой; доступны «Кисть Открытия» и «Кисть Закрытия», форма и радиус как на пульте.
+- При выключенном затемнении кисти недоступны.
+
+## Данные в партии
+
+- `darkenScene: boolean` — как сейчас.
+- Новое поле на **сцене**: стартовые штрихи (reveal/cover, точки, радиус, форма). Не на карточке графа.
+- Две карточки одной сцены делят одну базу.
+
+## Показ
+
+- Вход на карточку с `darkenScene`: кэш затемнения сначала заполняется штрихами из сцены, поверх — то, что нарисовали в этом показе или подняли из сохранения игры.
+- Обычный «Запустить» = база из сцены.
+- «Загрузить сохранение» = полный рисунок из слепка.
+- Кисти на пульте меняют только сессию, сцену в проекте сами не правят.
+
+## Запись итога вечера в сцену (5b)
+
+- Действие «Записать затемнение в сцену»: текущие штрихи активной карточки пишутся в поле сцены как новая база.
+- После этого экспорт/копирование партии увозит «полуоткрытую» карту без отдельного файла сохранения.
+- Сохранение игры по-прежнему хранит полный текущий рисунок по карточкам и базу сцены само не затирает.
+
+## Вне объёма этого шага
+
+- Пожар, туман, маркеры, ловушки в редакторе.
+- Отдельный импорт «сцена + состояние» между партиями.
+- Разная база затемнения для двух карточек одной сцены.
@@ -0,0 +1,36 @@
+# ВК: общий пост релиза 1.1.0
+
+Обложка: `docs/vk-covers/vk-cover-release-1-1-0.png` (1:1, без текста на картинке).  
+Запасной вариант с версией на кадре: `docs/vk-covers/vk-cover-1-1-0.png`.
+
+---
+
+## Черновик поста
+
+НРИ Плеер 1.1.0 — инструменты за столом, которые раньше жили в головах и на бумажках.
+
+Что нового:
+
+• 3D-кубики в отдельном окне — бросок с анимацией на экране игроков или только у мастера
+• Трекер инициативы — очередь хода, состояния, подсветка текущего на карте
+• Таймер сессии поверх сцены — пресеты, пауза, показ игрокам
+• Маркер на области видимости — рисовать прямо на превью, игроки видят сразу
+• Библиотека плейлистов — в редакторе и на пульте; громкость в проекте и параллельное воспроизведение
+• Шаблоны сетки кампании — сохранили стиль один раз, применили на любую сцену
+• Аккордеон «Сцены» на пульте — вся линия сюжета под рукой, не только история визитов
+• Выбор монитора презентации при запуске сессии
+• Окно инструкций и мелочи за столом: токены игроков не пропадают при смене сцены, кисти затемнения с формой и радиусом
+
+Скачать бесплатно: https://ttrpgplayer.ru
+Windows · macOS · Linux
+
+#НРИплеер #TTRPG #DnD #релиз #настолки #мастер
+
+---
+
+## Короткая версия
+
+НРИ Плеер 1.1.0: 3D-кубики, инициатива, таймер, маркер, плейлисты, шаблоны сетки и удобнее пульт за столом.
+
+https://ttrpgplayer.ru
+#НРИплеер #TTRPG #релиз