Вопросы и ответы

Частые вопросы, типичные ошибки и словарь терминов.

Словарь терминов

Термин	Что это
Шаблон	Заготовка листа: набор виджетов, их расположение, стили и формулы. По шаблону создаются листы персонажей.
Лист	Экземпляр шаблона с данными конкретного персонажа. Структуру менять нельзя, данные — можно.
Виджет	Элемент листа: счётчик, текстовое поле, модификатор, подпись. Строительный блок шаблона.
Поле	Отдельное значение внутри виджета. У виджета «Модификатор» это, например, «модификатор» и «название».
Алиас	Человекочитаемое имя поля, по которому на него можно сослаться из формул: `[str]`, `[hp]`.
Дайсница	Панель бросков в правом нижнем углу экрана: кнопки кубов, поле ввода формулы и кнопка броска.
Лог бросков	Список результатов с расшифровкой, какие значения выпали на каждой кости.
Композиция	Режим, в котором бросок собирается кликами по нескольким виджетам и кидается один раз.
Beta / Stable	Черновая и опубликованная версии шаблона. Beta видите только вы, Stable — всё сообщество.

Формулы

В виджете вместо числа показано `~error~` (или пусто)

Так помечается переменная, которую не удалось найти: «Модификатор» и «Счётчик» покажут ~error~, «Текстовое поле» и «Подпись» просто останутся пустыми. Проверьте по порядку:

Опечатка в алиасе. Регистр не важен ([str] = [STR]), а вот лишний пробел или другая буква — важны.
Виджет не привязан. Чтобы читать значение чужого виджета, его нужно привязать на вкладке Связи. Собственные поля доступны без привязки — через префикс local-.
Алиас не задан. Без алиаса поле доступно только по техническому id вида modifier-663988958975.

Формула не считается или считается неправильно

Равенство пишется как ==. Одиночное = в условии if() не работает.
В условии if() нельзя бросать кости. if(1d20 > 10, …) не сработает: условие должно сводиться к числу. В ветках if() кости можно любые.
Сравнение строк не поддерживается — только числа.
Проверьте скобки. Незакрытая скобка — самая частая ошибка после опечатки в алиасе.

Подробнее: Нотация формул.

Метка броска не отображается или ломает формулу

Метка — это текст в круглых скобках в конце формулы: 1d20 + 5 (Атака). Перед скобкой должен быть пробел или оператор, иначе система примет её за математическую функцию. С операторами сортировки (sd, sa) метки работают некорректно.

Можно ли назвать алиас `composition`?

Нет, это зарезервированное слово: оно используется как плейсхолдер композиции.

Броски

Клик по виджету ничего не кидает

У виджета не включено «Действие по клику» → «Бросок» (вкладка Данные в настройках виджета). Действие доступно для «Текстового поля», «Подписи» и «Модификатора»; у «Модификатора» бросок включён по умолчанию.
Вы в режиме редактирования шаблона — там клик выделяет виджет, а не запускает действие. Проверяйте в превью или на листе.
В формуле броска допущена ошибка. Проверьте вкладку Связи на наличие ~error~.

Клик по виджету не кидает, а что-то дописывает в дайсницу

У виджета включён режим «Композиция»: бросок собирается из нескольких кликов и кидается кнопкой в дайснице. См. Композиция.

Клик по виджету-части композиции ничего не делает

Композиция ещё не начата. Первым всегда кликают базовый виджет — тот, в формуле которого есть [composition].

Как убрать одну часть из собранной композиции

Никак — поэлементного удаления пока нет. Кликните базовый виджет ещё раз: композиция начнётся заново. Либо поправьте строку прямо в поле ввода дайсницы.

Листы и шаблоны

Не получается изменить значение виджета на листе

Часть виджетов (например, «Модификатор») не редактируется прямо на листе. Включите редактирование виджетов через кнопку настроек в шапке листа. См. Работа с листами.

Где кнопка «Сохранить»

Её нет: изменения сохраняются автоматически. Статус синхронизации показывает иконка облака в шапке листа.

Я изменил шаблон — почему на листе ничего не поменялось

Листы не обновляются сами. После публикации новой версии шаблона на листе появляется иконка обновления, и правки нужно применить вручную. Правки в Beta-версии другим пользователям не видны вообще — публикуйте Stable.

Изменения в шаблоне сломают уже созданные листы?

Нет. Каждое изменение опубликованного шаблона создаёт новую версию, а существующие листы продолжают работать на своей, пока вы не примените обновление.

Как распечатать лист или сохранить его в PDF

Иконка принтера в шапке листа. Дайсница и другие служебные панели в печать не попадают.

Остались вопросы?

Спрашивайте в Гильдии в Telegram.