docs(help): rewrite Instructions in friendlier RU/EN with clear steps
Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
@@ -143,63 +143,63 @@ export const EDITOR_MESSAGES: Record<EditorLocale, Record<string, string>> = {
|
|||||||
|
|
||||||
'help.section.overview.title': 'Обзор приложения',
|
'help.section.overview.title': 'Обзор приложения',
|
||||||
'help.section.overview.body':
|
'help.section.overview.body':
|
||||||
'TTRPG Player объединяет три окна: «Редактор» (подготовка кампании), «Пульт управления» (ведение сессии) и «Презентация» (экран для игроков). Редактор открывается при запуске; пульт и презентация появляются после нажатия «Запустить» в шапке редактора.\n\nВ редакторе слева — список сцен, по центру — граф сцен, справа — свойства игры и выбранной сцены. Пока открыты окна показа, редактор блокируется: закройте презентацию и пульт, чтобы снова редактировать кампанию.\n\nИнтернет нужен только для активации лицензии и проверки обновлений. Сами проекты и медиафайлы хранятся локально на вашем компьютере.',
|
'При запуске вы попадаете в Редактор — здесь готовите кампанию: сцены, картинки, музыку и связи между эпизодами. Когда придёт время играть, нажмите «Запустить» — откроются «Презентация» для игроков и «Пульт управления» для вас.\n\nВ редакторе слева — список сцен, по центру — карта связей, справа — настройки игры и выбранной сцены.\n\nПока идёт показ, редактор временно нельзя менять — это нормально. Закройте презентацию и пульт, чтобы снова редактировать кампанию.\n\nИнтернет нужен только для активации лицензии и проверки обновлений. Все проекты и файлы хранятся на вашем компьютере.',
|
||||||
|
|
||||||
'help.section.license.title': 'Лицензия и первый запуск',
|
'help.section.license.title': 'Лицензия и первый запуск',
|
||||||
'help.section.license.body':
|
'help.section.license.body':
|
||||||
'При первом запуске откройте «Настройки» → «Указать ключ». Если лицензионное соглашение ещё не принято, сначала откроется окно EULA — примите условия, затем вставьте продуктовый ключ (формат TTRPG-… или DND-…) и нажмите «Сохранить».\n\nДо активации лицензии доступно только меню «Настройки». Создание и открытие проектов, редактирование сцен и запуск сессии станут доступны после успешной активации.\n\nСтатус лицензии, срок действия и привязка к устройству — в «Настройки» → «О лицензии». Ключ привязан к компьютеру; при смене ПК потребуется новая активация согласно условиям покупки.',
|
'Перед работой с проектами один раз активируйте лицензию.\n\n1) Откройте «Настройки» → «Указать ключ».\n2) Если появится лицензионное соглашение — прочитайте и примите его.\n3) Вставьте ключ из письма (формат TTRPG-… или старый DND-…) и нажмите «Сохранить».\n\nДо активации доступны только настройки. После успешного сохранения ключа откроются проекты, сцены и запуск сессии.\n\nСтатус, срок действия и привязка к компьютеру — в «Настройки» → «О лицензии». Ключ привязан к этому ПК; на другом компьютере понадобится отдельная активация по условиям покупки.',
|
||||||
|
|
||||||
'help.section.projects.title': 'Проекты',
|
'help.section.projects.title': 'Проекты',
|
||||||
'help.section.projects.body':
|
'help.section.projects.body':
|
||||||
'На начальном экране (когда проект не открыт) в левой колонке отображается список «Проекты». Введите название в поле и нажмите «Создать проект», либо кликните по существующему проекту, чтобы открыть его.\n\n«Проект» → «Начальный экран» — закрывает текущий проект и возвращает к списку. Клик по логотипу и названию приложения в шапке делает то же самое.\n\n«Проект» → «Импорт» — загрузите архив .ttrpg.zip с другого компьютера. «Проект» → «Экспорт» — сохраните копию выбранного проекта в указанную папку.\n\n«Файл» → «Переименовать проект» (когда проект открыт) — измените отображаемое имя и имя файла на диске. Минимум 3 символа; в имени файла нельзя использовать символы <>:"/\\|?*.\n\nВ списке проектов кнопка «⋯» у карточки открывает меню удаления. Удаление безвозвратно стирает файл проекта и кэш с диска.',
|
'Проект — вся кампания целиком: сцены, медиа и связи между ними.\n\nСоздать новую кампанию:\n1) На начальном экране введите название в поле слева.\n2) Нажмите «Создать проект».\n\nОткрыть существующую — кликните по названию в списке. Вернуться к списку: «Проект» → «Начальный экран» или клик по названию приложения в шапке.\n\nПеренести кампанию на другой компьютер:\n1) «Проект» → «Экспорт» — сохраните копию как .ttrpg.zip.\n2) На другом ПК — «Проект» → «Импорт» и выберите этот файл.\n\nПереименовать открытый проект: «Файл» → «Переименовать проект» (минимум 3 символа; в имени файла нельзя использовать <>:"/\\|?*).\n\nКнопка «⋯» у карточки удаляет проект без восстановления — используйте осторожно.',
|
||||||
|
|
||||||
'help.section.scenes.title': 'Сцены',
|
'help.section.scenes.title': 'Сцены',
|
||||||
'help.section.scenes.body':
|
'help.section.scenes.body':
|
||||||
'Сцена — единица кампании: локация, эпизод или кадр истории с превью, описанием и аудио. В левой колонке редактора нажмите «+ Новая сцена», чтобы создать пустую сцену.\n\nПоле «Поиск сцен…» фильтрует список по названию. Клик по карточке сцены выделяет её и открывает свойства справа; та же сцена подсвечивается на графе.\n\nПравый клик по карточке в списке — меню «Удалить». Удаление сцены убирает её из списка и с графа вместе со связями. Сцену можно перетащить мышью из списка на граф (см. раздел «Граф сцен»).',
|
'Сцена — отдельный эпизод: локация, кадр истории, диалог. У неё есть название, картинка или видео для игроков, описание для мастера и своя музыка.\n\nДобавить сцену:\n1) В левой колонке нажмите «+ Новая сцена».\n2) Задайте название и настройте свойства справа (см. «Свойства сцены»).\n\n«Поиск сцен…» помогает быстро найти нужную. Клик по карточке выделяет сцену — она же подсветится на карте связей.\n\nУдалить: правый клик по карточке в списке → «Удалить». Сцена исчезнет из списка и с карты вместе со связями.\n\nПеретащите сцену из списка на карту — так она появится как узел (подробнее в «Граф сцен»).',
|
||||||
|
|
||||||
'help.section.graph.title': 'Граф сцен',
|
'help.section.graph.title': 'Граф сцен',
|
||||||
'help.section.graph.body':
|
'help.section.graph.body':
|
||||||
'Граф — визуальная карта кампании. Каждый узел на графе — экземпляр сцены; одна и та же сцена может встречаться на графе несколько раз (например, возврат в локацию).\n\nПеретащите сцену из левого списка на свободное место графа — появится карточка-узел. Перетаскивайте узлы, чтобы расставить схему. Соедините два узла: потяните от нижней точки (handle) одного узла к верхней точке другого — появится стрелка перехода. Одна карточка может иметь несколько исходящих связей (ветвление).\n\nНельзя провести вторую связь к тому же целевому узлу с той же карточки. Обычный клик и двойной клик по линии ничего не делают. Чтобы удалить связь, нажмите по линии правой кнопкой мыши и выберите «Удалить» в контекстном меню.\n\nПравый клик по узлу: «Начальная сцена» — с какого узла стартует партия при «Запустить»; «Удалить» — убрать узел с графа (сама сцена в списке останется). На начальной сцене отображается метка «НАЧАЛО».\n\nПанель масштаба внизу графа: увеличение, уменьшение, «Показать всё». Колёсико мыши над графом тоже меняет масштаб.',
|
'Карта в центре показывает, как эпизоды связаны. Каждый прямоугольник — место на схеме; одна сцена может встретиться несколько раз (например, игроки снова возвращаются в таверну).\n\nДобавить сцену на карту:\n1) Возьмите сцену в левом списке.\n2) Перетащите на свободное место на карте.\n\nСделать переход между сценами:\n1) Наведите на нижнюю точку первой карточки.\n2) Потяните линию к верхней точке второй и отпустите — появится стрелка.\n\nИз одной сцены может выходить несколько стрелок — так вы делаете ветвление сюжета. Вторую стрелку к той же паре сцен провести нельзя.\n\nУдалить стрелку: правый клик по линии → «Удалить». Обычный клик по линии ничего не делает.\n\nС чего начинается игра: правый клик по карточке → «Начальная сцена» (появится метка «НАЧАЛО»). Убрать карточку с карты, не удаляя сцену из списка: ПКМ → «Удалить».\n\nМасштаб — кнопки внизу или колёсико мыши. «Показать всё» вместит всю схему на экран.',
|
||||||
|
|
||||||
'help.section.sceneProps.title': 'Свойства сцены',
|
'help.section.sceneProps.title': 'Свойства сцены',
|
||||||
'help.section.sceneProps.body':
|
'help.section.sceneProps.body':
|
||||||
'Правая колонка «Свойства сцены» активна, когда выбрана сцена. «Название сцены» и «Описание» — текст для мастера; описание видно на пульте в блоке сюжетной линии.\n\n«Превью сцены» — главное изображение или видео для игроков. Нажмите «Загрузить» или «Изменить» и выберите файл (изображение: PNG, JPG, WebP, GIF и др.). Для изображений доступна кнопка «Повернуть» (шаг 90°). «Очистить» удаляет превью.\n\nДля видео-превью отметьте «Автостарт», если ролик должен начинаться сам на экране презентации. На видео-сценах эффекты кисти на пульте отключены (как на презентации).\n\n«Аудио сцены» — музыка и звуки, привязанные к этой сцене. «Загрузить» добавляет файлы. У каждого трека: «Авто» (автовоспроизведение при входе в сцену на пульте) и «Цикл» (зацикливание). Корзина убирает трек из сцены.\n\nБлок «Ветвления» напоминает: связи задаются перетаскиванием на графе, а не в инспекторе.',
|
'Выберите сцену в списке слева — справа откроются её свойства.\n\n«Название сцены» и «Описание» — для мастера. Описание видно на пульте в блоке сюжетной линии.\n\nКартинка или видео для игроков:\n1) В «Превью сцены» нажмите «Загрузить» или «Изменить».\n2) Выберите файл (PNG, JPG, WebP, GIF и др.).\n3) Для картинки можно «Повернуть» (шаг 90°). «Очистить» — убрать превью.\n\nДля видео включите «Автостарт», если ролик должен сам начаться на экране игроков. На видео-сценах эффекты кистью недоступны.\n\n«Аудио сцены» — музыка и звуки этого эпизода. «Загрузить» добавляет файлы. У каждого трека: «Авто» (играть при входе в сцену) и «Цикл». Корзина удаляет трек.\n\nСвязи между сценами задаются на карте, а не здесь — см. «Граф сцен».',
|
||||||
|
|
||||||
'help.section.campaignAudio.title': 'Аудио игры',
|
'help.section.campaignAudio.title': 'Аудио игры',
|
||||||
'help.section.campaignAudio.body':
|
'help.section.campaignAudio.body':
|
||||||
'В правой колонке блок «Свойства игры» → «Аудио игры» — музыка всей кампании (фон, тема, ambient), не привязанная к конкретной сцене.\n\nНажмите «Загрузить» и выберите аудиофайлы. Для каждого трека задайте «Авто» и «Цикл» так же, как у аудио сцены. Удаление — иконка корзины.\n\nНа пульте музыка сцены имеет приоритет над музыкой игры: пока играет сцена с аудио, кампанийные треки ставятся на паузу и могут возобновиться, когда сцена без своей музыки или после вашего управления с пульта.',
|
'«Аудио игры» в блоке «Свойства игры» — музыка всей кампании: тема, фон, атмосфера. Она не привязана к одной сцене.\n\n1) Нажмите «Загрузить» и выберите файлы.\n2) Для каждого трека отметьте «Авто» и «Цикл» по желанию.\n3) Удалить трек — иконка корзины.\n\nНа пульте музыка сцены важнее общей: пока играет трек сцены, кампанийная музыка приглушается. Когда у сцены нет своего звука или вы переключитесь вручную — общая музыка снова может играть.',
|
||||||
|
|
||||||
'help.section.session.title': 'Запуск сессии',
|
'help.section.session.title': 'Запуск сессии',
|
||||||
'help.section.session.body':
|
'help.section.session.body':
|
||||||
'Когда кампания готова, назначьте начальную сцену на графе (ПКМ по узлу → «Начальная сцена»). Кнопка «Запустить» в шапке редактора станет активной.\n\n«Запустить» открывает окно «Презентация» (для игроков) и «Пульт управления» (для мастера). Редактор показывает затемнение: «Презентация запущена» — это нормально, пока идёт сессия.\n\nЧтобы вернуться к редактированию, на пульте нажмите «Выключить демонстрацию» или «Завершить показ» (если нет дальнейших переходов). Оба окна должны закрыться — тогда блокировка редактора снимется.\n\nПеретащите окно презентации на второй монитор, проектор или ТВ и разверните на весь экран (F11 в окне или стандартные средства ОС). Игроки видят только карту/видео и эффекты, без интерфейса мастера.',
|
'Когда кампания готова, можно начать игру.\n\n1) На карте связей щёлкните правой кнопкой по карточке старта → «Начальная сцена».\n2) Нажмите «Запустить» в шапке редактора.\n3) Откроются «Презентация» (для игроков) и «Пульт управления» (для вас).\n\nРедактор на время показа затемняется — так и должно быть.\n\nВернуться к подготовке:\n1) На пульте нажмите «Выключить демонстрацию» или «Завершить показ» (если дальше некуда переходить).\n2) Дождитесь закрытия обоих окон.\n\nОкно «Презентация» перенесите на второй монитор, проектор или ТВ и разверните на весь экран (F11). Игроки увидят только картинку, видео и эффекты — без ваших кнопок.',
|
||||||
|
|
||||||
'help.section.controlPanel.title': 'Пульт управления',
|
'help.section.controlPanel.title': 'Пульт управления',
|
||||||
'help.section.controlPanel.body':
|
'help.section.controlPanel.body':
|
||||||
'Пульт — главное рабочее место мастера во время игры. Слева — инструменты эффектов и сюжетная линия; справа — предпросмотр экрана игроков, варианты переходов и музыка.\n\n«Предпросмотр экрана» показывает то же, что видят игроки, в уменьшенном виде. Здесь же можно рисовать эффекты кистью (для сцен с изображением-превью).\n\n«Выключить демонстрацию» закрывает презентацию и пульт и разблокирует редактор.\n\nБлок «Сюжетная линия» — история посещённых узлов графа в текущей сессии. Текущая сцена помечена «ТЕКУЩАЯ СЦЕНА». Клик по пройденному шагу перематывает партию на ту точку графа без добавления нового шага в историю.',
|
'Пульт — ваш стол во время игры. Игроки смотрят на презентацию, вы управляете всем отсюда.\n\nСлева — эффекты и ход сюжета, справа — мини-копия экрана игроков, варианты переходов и музыка.\n\n«Предпросмотр экрана» показывает то же, что видят игроки. На сценах с картинкой здесь же рисуют эффекты — они сразу появляются на большом экране.\n\n«Сюжетная линия» — цепочка пройденных эпизодов. Текущая сцена помечена «ТЕКУЩАЯ СЦЕНА». Клик по прошлому шагу откатывает партию к тому месту на карте без новой записи в истории.\n\n«Выключить демонстрацию» — закончить показ и вернуться в редактор.',
|
||||||
|
|
||||||
'help.section.transitions.title': 'Переходы между сценами',
|
'help.section.transitions.title': 'Переходы между сценами',
|
||||||
'help.section.transitions.body':
|
'help.section.transitions.body':
|
||||||
'Исходящие связи от текущего узла графа отображаются на пульте в блоке «Варианты ветвления» — карточки «ОПЦИЯ 1», «ОПЦИЯ 2» и т.д. с названием целевой сцены.\n\nНажмите «Переключить» на нужной опции — презентация и музыка перейдут к выбранной сцене; в сюжетной линии появится новый шаг.\n\nЕсли исходящих связей нет (конец ветки или тупик), отображается «Нет вариантов перехода» и кнопка «Завершить показ» — она закрывает окна показа.\n\nПереходы задаются только теми связями, которые вы провели на графе в редакторе от текущего узла к другим узлам.',
|
'Куда можно пойти дальше — видно на пульте в «Варианты ветвления». Это исходящие стрелки с текущей карточки на карте.\n\n1) Посмотрите карточки «ОПЦИЯ 1», «ОПЦИЯ 2» — там названия целевых сцен.\n2) Нажмите «Переключить» у нужного варианта.\n3) На презентации сменятся картинка и музыка, в сюжетной линии появится новый шаг.\n\nЕсли вариантов нет (конец ветки) — «Нет вариантов перехода». Нажмите «Завершить показ», чтобы закрыть окна.\n\nВарианты появляются только там, где вы провели стрелки на карте в редакторе.',
|
||||||
|
|
||||||
'help.section.music.title': 'Музыка на пульте',
|
'help.section.music.title': 'Музыка на пульте',
|
||||||
'help.section.music.body':
|
'help.section.music.body':
|
||||||
'Раздел «Музыка» на пульте разделён на «Музыка сцены» и «Музыка игры» — те же треки, что вы настроили в редакторе.\n\nУ каждого трека отображаются режимы «Авто»/«Ручн.» и «Цикл»/«Один раз», а также статус воспроизведения. Кнопки ▶ / ⏸ / ⏹ управляют воспроизведением вручную.\n\nПолоска прогресса — клик по ней перематывает трек (если известна длительность). Стрелки ← → на полоске (при фокусе) перематывают на 5 секунд.\n\nЕсли браузер/Electron блокирует автозапуск, нажмите «Воспроизведение» вручную — после действия пользователя звук обычно разрешается. При ошибке формата проверьте файл (поддерживаются распространённые аудиоформаты).',
|
'Блок «Музыка» повторяет треки из редактора — отдельно «Музыка сцены» и «Музыка игры».\n\n▶ — воспроизвести, ⏸ — пауза, ⏹ — остановить. «Авто»/«Ручн.» и «Цикл»/«Один раз» показывают, как трек настроен в редакторе.\n\nКлик по полоске прогресса — перемотка (если известна длина). Стрелки ← → на полоске (когда она в фокусе) — на 5 секунд назад или вперёд.\n\nЕсли музыка не стартует сама — один раз нажмите ▶: после вашего действия звук обычно разрешается. Не играет файл — проверьте формат (MP3, WAV и т.п.).',
|
||||||
|
|
||||||
'help.section.effects.title': 'Эффекты поля и действий',
|
'help.section.effects.title': 'Эффекты поля и действий',
|
||||||
'help.section.effects.body':
|
'help.section.effects.body':
|
||||||
'Эффекты доступны на пульте для сцен с изображением-превью (не для видео). Рисуйте прямо в области «Предпросмотр экрана» — эффекты синхронно появляются на презентации.\n\n«Инструменты»: ластик 🧹 — клик или проведение по эффекту удаляет его; «Очистить эффекты» — убрать все эффекты сразу.\n\n«Эффекты поля»: туман, дождь, огонь, вода — зажмите левую кнопку мыши и ведите кистью по карте.\n\n«Эффекты действий»: молния, луч света, заморозка, облако яда — короткий клик или штрих; у молнии и некоторых эффектов есть звук и ограниченная длительность анимации.\n\n«Радиус кисти» — ползунок под панелью эффектов; меняет размер области рисования. Чем больше значение, тем шире мазок.',
|
'Эффекты работают на сценах с картинкой, не на видео. Рисуйте в «Предпросмотр экрана» — игроки увидят то же на презентации.\n\nВыберите инструмент слева:\n• Эффекты поля (туман, дождь, огонь, вода) — зажмите левую кнопку и ведите по карте.\n• Эффекты действий (молния, луч света, заморозка, облако яда) — короткий клик или штрих; у некоторых есть звук.\n\nЛастик 🧹 — клик или проведение по эффекту, чтобы убрать. «Очистить эффекты» — снять всё сразу.\n\n«Радиус кисти» под панелью — чем больше число, тем шире мазок.',
|
||||||
|
|
||||||
'help.section.presentation.title': 'Экран презентации',
|
'help.section.presentation.title': 'Экран презентации',
|
||||||
'help.section.presentation.body':
|
'help.section.presentation.body':
|
||||||
'Окно «Презентация» показывает игрокам превью текущей сцены: изображение карты (с учётом поворота из редактора) или видео с автостартом/циклом по настройкам.\n\nПоверх карты отображаются нарисованные мастером эффекты. Интерфейса редактора и пульта на этом экране нет.\n\nПри смене сцены с пульта презентация обновляется автоматически. Разместите окно на экране, который видят игроки, и скройте панель задач при необходимости.\n\nЕсли превью не задано, экран может оставаться пустым или тёмным — задайте превью в свойствах сцены в редакторе.',
|
'«Презентация» — то, что видят игроки: картинка сцены (с учётом поворота из редактора) или видео по вашим настройкам.\n\nЭффекты с пульта накладываются поверх. Меню и кнопки мастера здесь не показываются.\n\nПри смене сцены с пульта картинка обновляется сама. Перенесите окно на экран для игроков и при необходимости спрячьте панель задач.\n\nПустой или тёмный экран — скорее всего, у сцены нет превью. Добавьте картинку в свойствах сцены в редакторе.',
|
||||||
|
|
||||||
'help.section.importExport.title': 'Импорт и экспорт',
|
'help.section.importExport.title': 'Импорт и экспорт',
|
||||||
'help.section.importExport.body':
|
'help.section.importExport.body':
|
||||||
'Проект хранится как архив .ttrpg.zip в папке данных приложения. «Проект» → «Экспорт» создаёт копию архива: выберите проект в списке, нажмите «Сохранить как…» и укажите путь — удобно для резервной копии или переноса на другой ПК.\n\n«Проект» → «Импорт» открывает диалог выбора .ttrpg.zip. После импорта проект появится в списке на начальном экране. Импорт и экспорт показывают прогресс-бар при больших архивах.\n\nМедиафайлы (картинки, аудио, видео) упакованы внутрь проекта при загрузке в редактор — отдельно их переносить не нужно, если вы передаёте целый .ttrpg.zip.',
|
'Проект хранится как файл .ttrpg.zip — внутри уже все картинки, звуки и настройки.\n\nРезервная копия или перенос на другой ПК:\n1) «Проект» → «Экспорт».\n2) Выберите проект и куда сохранить.\n3) Скопируйте .ttrpg.zip на флешку, в облако или на другой компьютер.\n\nЗагрузить бэкап:\n1) «Проект» → «Импорт».\n2) Выберите .ttrpg.zip.\n3) Проект появится в списке на начальном экране.\n\nПри больших архивах показывается прогресс. Картинки и музыку отдельно переносить не нужно — всё внутри архива.',
|
||||||
|
|
||||||
'help.section.settings.title': 'Настройки, язык и обновления',
|
'help.section.settings.title': 'Настройки, язык и обновления',
|
||||||
'help.section.settings.body':
|
'help.section.settings.body':
|
||||||
'«Настройки» → «Указать ключ» — смена или первичный ввод лицензии. «О лицензии» — статус и срок. «Проверить обновления» (в установленной версии при активной лицензии) — поиск новой версии на сервере; при наличии обновления можно загрузить и перезапустить приложение.\n\n«Язык» → «Русский» или «English» — переключает интерфейс редактора, пульта и системных сообщений. Выбор сохраняется между запусками.\n\nВерсия приложения отображается в шапке справа от меню (например, v1.0.22). «О приложении» → «О программе» — описание продукта и контакты разработчика.',
|
'«Настройки» → «Указать ключ» — ввести или сменить лицензию. «О лицензии» — проверить статус и срок.\n\n«Проверить обновления» (в установленной версии при активной лицензии) — если есть новая версия, можно скачать и перезапустить программу.\n\n«Язык» → «Русский» или «English» — меняет язык интерфейса. Выбор сохраняется между запусками.\n\nНомер версии — в шапке справа от меню. «О приложении» → «О программе» — о продукте и контактах поддержки.',
|
||||||
|
|
||||||
'updates.dialogTitle': 'Обновления',
|
'updates.dialogTitle': 'Обновления',
|
||||||
'updates.checking': 'Проверка наличия обновлений…',
|
'updates.checking': 'Проверка наличия обновлений…',
|
||||||
@@ -460,63 +460,63 @@ export const EDITOR_MESSAGES: Record<EditorLocale, Record<string, string>> = {
|
|||||||
|
|
||||||
'help.section.overview.title': 'App overview',
|
'help.section.overview.title': 'App overview',
|
||||||
'help.section.overview.body':
|
'help.section.overview.body':
|
||||||
'TTRPG Player uses three windows: Editor (campaign prep), Control panel (running the session) and Presentation (player screen). The editor opens at launch; the control panel and presentation appear after you click Run in the editor header.\n\nIn the editor, the left column lists scenes, the center shows the scene graph, and the right column holds game and scene properties. While presentation windows are open, the editor is locked — close presentation and control to edit again.\n\nInternet is only needed for license activation and update checks. Projects and media are stored locally on your computer.',
|
'When you launch the app, you land in the Editor — where you prepare your campaign: scenes, images, music, and how episodes connect. When it is time to play, click Run. That opens Presentation for your players and the Control panel for you.\n\nIn the editor, the left column lists scenes, the center shows the story map, and the right column holds game and scene settings.\n\nWhile a session is running, the editor is temporarily locked — that is normal. Close presentation and the control panel to edit again.\n\nInternet is only needed for license activation and update checks. All projects and files stay on your computer.',
|
||||||
|
|
||||||
'help.section.license.title': 'License and first launch',
|
'help.section.license.title': 'License and first launch',
|
||||||
'help.section.license.body':
|
'help.section.license.body':
|
||||||
'On first launch, open Settings → Enter license key. If the EULA has not been accepted yet, you will see the agreement first — accept it, paste your product key (TTRPG-… or DND-… format) and click Save.\n\nUntil the license is active, only Settings is available. Creating and opening projects, editing scenes and running a session unlock after successful activation.\n\nLicense status, expiry and device binding are under Settings → About license. The key is bound to your computer; a new PC may require re-activation per your purchase terms.',
|
'Before you can work with projects, activate your license once.\n\n1) Open Settings → Enter license key.\n2) If you see the license agreement, read and accept it.\n3) Paste the key from your email (TTRPG-… or legacy DND-…) and click Save.\n\nUntil activation succeeds, only Settings is available. After that, projects, scenes, and running a session unlock.\n\nStatus, expiry, and device binding are under Settings → About license. The key is tied to this PC; another computer may need a separate activation per your purchase terms.',
|
||||||
|
|
||||||
'help.section.projects.title': 'Projects',
|
'help.section.projects.title': 'Projects',
|
||||||
'help.section.projects.body':
|
'help.section.projects.body':
|
||||||
'On the home screen (no project open), the left column shows Projects. Enter a name and click Create project, or click an existing project to open it.\n\nProject → Home closes the current project and returns to the list. Clicking the app logo and title in the header does the same.\n\nProject → Import loads a .ttrpg.zip archive from another machine. Project → Export saves a copy of the selected project to a folder you choose.\n\nFile → Rename project (with a project open) changes the display name and on-disk file name. At least 3 characters; file names cannot contain <>:"/\\|?*.\n\nIn the project list, the ⋯ button on a card opens delete. Deletion permanently removes the project file and cache from disk.',
|
'A project is your whole campaign: scenes, media, and connections between them.\n\nCreate a new campaign:\n1) On the home screen, type a name in the field on the left.\n2) Click Create project.\n\nOpen an existing one — click its name in the list. Return to the list: Project → Home, or click the app title in the header.\n\nMove a campaign to another computer:\n1) Project → Export — save a copy as .ttrpg.zip.\n2) On the other PC — Project → Import and pick that file.\n\nRename an open project: File → Rename project (at least 3 characters; file names cannot contain <>:"/\\|?*).\n\nThe ⋯ button on a project card deletes it permanently — use with care.',
|
||||||
|
|
||||||
'help.section.scenes.title': 'Scenes',
|
'help.section.scenes.title': 'Scenes',
|
||||||
'help.section.scenes.body':
|
'help.section.scenes.body':
|
||||||
'A scene is a campaign unit: a location, beat or story frame with preview, description and audio. In the editor left column, click + New scene to create an empty scene.\n\nThe Search scenes… field filters the list by title. Click a scene card to select it and edit properties on the right; the same scene is highlighted on the graph.\n\nRight-click a list card for Delete. Deleting a scene removes it from the list and graph including links. You can drag a scene from the list onto the graph (see Scene graph).',
|
'A scene is one episode: a location, story beat, or dialogue. It has a title, an image or video for players, notes for the GM, and its own music.\n\nAdd a scene:\n1) In the left column, click + New scene.\n2) Set the title and adjust properties on the right (see Scene properties).\n\nSearch scenes… helps you find one quickly. Click a card to select it — it will also highlight on the story map.\n\nDelete: right-click a list card → Delete. The scene disappears from the list and map, including all links.\n\nDrag a scene from the list onto the map to place it as a node (see Scene graph).',
|
||||||
|
|
||||||
'help.section.graph.title': 'Scene graph',
|
'help.section.graph.title': 'Scene graph',
|
||||||
'help.section.graph.body':
|
'help.section.graph.body':
|
||||||
'The graph is a visual map of your campaign. Each node is a scene instance; the same scene can appear on the graph more than once (e.g. returning to a location).\n\nDrag a scene from the left list onto empty graph space to create a node. Drag nodes to arrange the layout. Connect two nodes: pull from the bottom handle of one node to the top handle of another — a transition arrow appears. One card can have several outgoing links (branching).\n\nYou cannot add a second link to the same target from the same source. Regular clicks and double-clicks on a line do nothing. To remove a link, right-click the line and choose Delete in the context menu.\n\nRight-click a node: Start scene — where the party begins when you Run; Delete — remove the node from the graph (the scene stays in the list). The start node shows a START badge.\n\nThe zoom bar at the bottom: zoom in, zoom out, fit view. The mouse wheel over the graph also zooms.',
|
'The map in the center shows how episodes connect. Each box is a spot on your story; the same scene can appear more than once (for example, players return to the tavern).\n\nPlace a scene on the map:\n1) Grab a scene in the left list.\n2) Drag it onto empty space on the map.\n\nConnect two scenes:\n1) Point at the bottom dot on the first card.\n2) Drag a line to the top dot on the second and release — an arrow appears.\n\nOne scene can have several outgoing arrows — that is how you branch the story. You cannot draw a second arrow between the same pair.\n\nRemove an arrow: right-click the line → Delete. A normal click on the line does nothing.\n\nSet where the game starts: right-click a card → Start scene (a START badge appears). Remove a card from the map without deleting the scene from the list: right-click → Delete.\n\nZoom with the buttons at the bottom or the mouse wheel. Fit view shows the whole map.',
|
||||||
|
|
||||||
'help.section.sceneProps.title': 'Scene properties',
|
'help.section.sceneProps.title': 'Scene properties',
|
||||||
'help.section.sceneProps.body':
|
'help.section.sceneProps.body':
|
||||||
'The right column Scene properties is active when a scene is selected. Scene title and Description are for the GM; description appears on the control panel storyline block.\n\nScene preview is the main image or video for players. Click Upload or Change and pick a file (images: PNG, JPG, WebP, GIF, etc.). For images, Rotate turns the preview in 90° steps. Clear removes the preview.\n\nFor video preview, check Autostart if the clip should start on the presentation screen. On video scenes, brush effects on the control panel are disabled (same as on presentation).\n\nScene audio — music and sounds for this scene. Upload adds files. Per track: Auto (play when entering the scene on the control panel) and Loop. The trash icon removes a track from the scene.\n\nThe Branching block reminds you that links are drawn on the graph, not in the inspector.',
|
'Select a scene in the left list — its properties open on the right.\n\nScene title and Description are for the GM. The description appears in the storyline on the control panel.\n\nImage or video for players:\n1) Under Scene preview, click Upload or Change.\n2) Pick a file (PNG, JPG, WebP, GIF, etc.).\n3) For images, use Rotate (90° steps). Clear removes the preview.\n\nFor video, enable Autostart if the clip should start on its own on the player screen. Brush effects are not available on video scenes.\n\nScene audio — music and sounds for this episode. Upload adds files. Per track: Auto (play when entering the scene) and Loop. The trash icon removes a track.\n\nLinks between scenes are drawn on the map, not here — see Scene graph.',
|
||||||
|
|
||||||
'help.section.campaignAudio.title': 'Game audio',
|
'help.section.campaignAudio.title': 'Game audio',
|
||||||
'help.section.campaignAudio.body':
|
'help.section.campaignAudio.body':
|
||||||
'In the right column, Game properties → Game audio holds campaign-wide music (theme, ambient) not tied to a specific scene.\n\nClick Upload and choose audio files. Set Auto and Loop per track like scene audio. Remove with the trash icon.\n\nOn the control panel, scene music takes priority over game music: while a scene with audio is active, campaign tracks pause and may resume when you move to a scene without its own music or after manual control.',
|
'Game audio under Game properties is music for the whole campaign: theme, ambience, background. It is not tied to one scene.\n\n1) Click Upload and choose files.\n2) Set Auto and Loop per track as you like.\n3) Remove a track with the trash icon.\n\nOn the control panel, scene music comes first: while a scene track plays, campaign music pauses. When the scene has no track or you take manual control, campaign music can play again.',
|
||||||
|
|
||||||
'help.section.session.title': 'Starting a session',
|
'help.section.session.title': 'Starting a session',
|
||||||
'help.section.session.body':
|
'help.section.session.body':
|
||||||
'When the campaign is ready, set a start scene on the graph (right-click a node → Start scene). The Run button in the editor header becomes enabled.\n\nRun opens Presentation (for players) and Control panel (for the GM). The editor shows a dimmed overlay — Presentation running — which is expected during a session.\n\nTo edit again, click Stop presentation or End presentation on the control panel (when there are no further transitions). Both windows must close before the editor unlocks.\n\nMove the presentation window to a second monitor, projector or TV and fullscreen it (F11 or OS controls). Players see only the map/video and effects, not the GM UI.',
|
'When your campaign is ready, you can start playing.\n\n1) On the story map, right-click the starting card → Start scene.\n2) Click Run in the editor header.\n3) Presentation (for players) and the Control panel (for you) open.\n\nThe editor dims while the show runs — that is expected.\n\nReturn to prep:\n1) On the control panel, click Stop presentation or End presentation (when there is nowhere left to go).\n2) Wait until both windows close.\n\nMove the Presentation window to a second monitor, projector, or TV and go fullscreen (F11). Players see only the image, video, and effects — not your buttons.',
|
||||||
|
|
||||||
'help.section.controlPanel.title': 'Control panel',
|
'help.section.controlPanel.title': 'Control panel',
|
||||||
'help.section.controlPanel.body':
|
'help.section.controlPanel.body':
|
||||||
'The control panel is the GM’s main workspace during play. On the left: effect tools and storyline; on the right: screen preview, branch options and music.\n\nScreen preview shows what players see, scaled down. You can paint effects here (for scenes with an image preview).\n\nStop presentation closes presentation and control and unlocks the editor.\n\nStoryline lists graph nodes visited in the current session. The current scene is marked CURRENT SCENE. Click a visited step to rewind the party to that graph point without adding a new history entry.',
|
'The control panel is your desk during play. Players watch presentation; you run everything from here.\n\nOn the left: effects and storyline. On the right: a mini copy of the player screen, branch options, and music.\n\nScreen preview shows what players see. On image scenes, paint effects here — they appear on the big screen right away.\n\nStoryline lists episodes you have visited. The current scene is marked CURRENT SCENE. Click an earlier step to rewind the party to that spot without adding a new history entry.\n\nStop presentation ends the show and unlocks the editor.',
|
||||||
|
|
||||||
'help.section.transitions.title': 'Scene transitions',
|
'help.section.transitions.title': 'Scene transitions',
|
||||||
'help.section.transitions.body':
|
'help.section.transitions.body':
|
||||||
'Outgoing links from the current graph node appear on the control panel under Branch options — cards OPTION 1, OPTION 2, etc. with the target scene title.\n\nClick Switch on the desired option — presentation and music move to that scene; storyline gains a new step.\n\nIf there are no outgoing links (end of branch or dead end), you see No transitions available and End presentation — it closes the show windows.\n\nTransitions are only those links you drew on the graph in the editor from the current node to other nodes.',
|
'Where you can go next appears under Branch options on the control panel. These are outgoing arrows from the current card on the map.\n\n1) Read the OPTION 1, OPTION 2 cards — they show target scene names.\n2) Click Switch on the choice you want.\n3) Presentation updates image and music; storyline adds a new step.\n\nIf there are no options (end of a branch), you will see No transitions available. Click End presentation to close the show windows.\n\nOptions only exist where you drew arrows on the map in the editor.',
|
||||||
|
|
||||||
'help.section.music.title': 'Music on the control panel',
|
'help.section.music.title': 'Music on the control panel',
|
||||||
'help.section.music.body':
|
'help.section.music.body':
|
||||||
'The Music section splits into Scene music and Game music — the same tracks configured in the editor.\n\nEach track shows Auto/Manual and Loop/Once modes plus playback status. ▶ / ⏸ / ⏹ control playback manually.\n\nThe progress bar — click to seek (when duration is known). ← → on the bar (when focused) seek by 5 seconds.\n\nIf autoplay is blocked, press Play manually — after a user gesture audio usually works. On format errors, check the file (common audio formats are supported).',
|
'The Music section mirrors what you set in the editor — Scene music and Game music separately.\n\n▶ play, ⏸ pause, ⏹ stop. Auto/Manual and Loop/Once show how each track was configured in the editor.\n\nClick the progress bar to seek (when duration is known). ← → on the bar (when focused) skip 5 seconds back or forward.\n\nIf music does not start on its own, press ▶ once — after your click, sound is usually allowed. If a file still will not play, check the format (MP3, WAV, etc.).',
|
||||||
|
|
||||||
'help.section.effects.title': 'Field and action effects',
|
'help.section.effects.title': 'Field and action effects',
|
||||||
'help.section.effects.body':
|
'help.section.effects.body':
|
||||||
'Effects are available on the control panel for scenes with an image preview (not video). Paint in the Screen preview area — effects sync to presentation.\n\nTools: eraser 🧹 — click or drag over an effect to remove it; Clear effects removes all effects at once.\n\nField effects: fog, rain, fire, water — hold the left mouse button and brush on the map.\n\nAction effects: lightning, sunbeam, freeze, poison cloud — click or short stroke; lightning and some effects include sound and limited animation duration.\n\nBrush radius — slider under the effects panel; changes stroke size. Higher values mean a wider brush.',
|
'Effects work on image scenes, not video. Paint in Screen preview — players see the same on presentation.\n\nPick a tool on the left:\n• Field effects (fog, rain, fire, water) — hold the left button and brush on the map.\n• Action effects (lightning, sunbeam, freeze, poison cloud) — click or short stroke; some include sound.\n\nEraser 🧹 — click or drag over an effect to remove it. Clear effects removes everything at once.\n\nBrush radius under the panel — higher values mean a wider stroke.',
|
||||||
|
|
||||||
'help.section.presentation.title': 'Presentation screen',
|
'help.section.presentation.title': 'Presentation screen',
|
||||||
'help.section.presentation.body':
|
'help.section.presentation.body':
|
||||||
'The Presentation window shows players the current scene preview: map image (with rotation from the editor) or video with autostart/loop per settings.\n\nPainted GM effects appear on top of the map. There is no editor or control UI on this screen.\n\nWhen you switch scenes from the control panel, presentation updates automatically. Place the window on the display players watch and hide the taskbar if needed.\n\nIf no preview is set, the screen may stay empty or dark — set preview in scene properties in the editor.',
|
'Presentation is what players see: the scene image (with rotation from the editor) or video according to your settings.\n\nEffects from the control panel draw on top. There are no GM menus or buttons here.\n\nWhen you switch scenes from the control panel, the image updates automatically. Move the window to the display players watch and hide the taskbar if needed.\n\nA blank or dark screen usually means the scene has no preview — add one in scene properties in the editor.',
|
||||||
|
|
||||||
'help.section.importExport.title': 'Import and export',
|
'help.section.importExport.title': 'Import and export',
|
||||||
'help.section.importExport.body':
|
'help.section.importExport.body':
|
||||||
'A project is stored as a .ttrpg.zip archive in the app data folder. Project → Export creates a copy: pick a project, click Save as… and choose a path — useful for backup or moving to another PC.\n\nProject → Import opens a .ttrpg.zip picker. After import the project appears on the home screen. Import and export show a progress bar for large archives.\n\nMedia (images, audio, video) is packed into the project when you upload in the editor — you do not need to move files separately if you share the whole .ttrpg.zip.',
|
'A project is stored as a .ttrpg.zip file — images, sounds, and settings are already inside.\n\nBackup or move to another PC:\n1) Project → Export.\n2) Choose the project and where to save.\n3) Copy the .ttrpg.zip to a USB drive, cloud, or another computer.\n\nLoad a backup:\n1) Project → Import.\n2) Select the .ttrpg.zip.\n3) The project appears on the home screen.\n\nLarge archives show a progress bar. You do not need to move images and music separately — everything is in the archive.',
|
||||||
|
|
||||||
'help.section.settings.title': 'Settings, language and updates',
|
'help.section.settings.title': 'Settings, language and updates',
|
||||||
'help.section.settings.body':
|
'help.section.settings.body':
|
||||||
'Settings → Enter license key — change or enter your license. About license — status and expiry. Check for updates (installed build with active license) — searches for a new version; you can download and restart when an update is available.\n\nLanguage → Русский or English switches the editor, control panel and system messages. The choice persists between launches.\n\nThe app version appears in the header to the right of the menus (e.g. v1.0.22). About → About opens product info and developer contacts.',
|
'Settings → Enter license key — add or change your license. About license — check status and expiry.\n\nCheck for updates (installed app with active license) — if a new version exists, you can download and restart.\n\nLanguage → Русский or English changes the interface. Your choice is saved between launches.\n\nThe version number is in the header, right of the menus. About → About opens product info and support contacts.',
|
||||||
|
|
||||||
'updates.dialogTitle': 'Updates',
|
'updates.dialogTitle': 'Updates',
|
||||||
'updates.checking': 'Checking for updates…',
|
'updates.checking': 'Checking for updates…',
|
||||||
|
|||||||
Reference in New Issue
Block a user