Расширения и интерфейс (HUD)

Что такое расширения

Расширение — готовая механика, которая ставится в новеллу целиком: свои шаги в блоке «Действия», свои условия, своё окно у читателя. Живут они во вкладке «Расшир.», и она видна всегда. Сейчас там два расширения: «Инвентарь» и «Журнал заданий».

После установки на карточке расширения появляются галка «Включено», раздел «Настройки» и список предметов или заданий. «Удалить…» предлагает два пути: «Выключить, данные оставить» — включить можно в любой момент, или «Удалить и вычистить» — данные уйдут, а шаги, которые на расширение ссылаются, останутся битыми. Второе доступно только владельцу новеллы.

«Пол» отдельным расширением больше не нужен: выбор пола встроен в редактор. Он включается во вкладке «Новелла», в разделе «Облики, образы и пол», галкой «Пол на выбор (Она | Он)» у героя. В списке «Расшир.» «Пол» остаётся только у новелл, где его раньше выключили, — чтобы было где включить обратно.

1. Откройте вкладку «Расшир.» в левой панели.
2. На карточке «Инвентарь» или «Журнал заданий» нажмите «Установить».
3. Раскройте «Настройки» и решите, нужна ли кнопка поверх экрана, как выглядит окно и какие уведомления увидит читатель.
4. Заведите первый предмет кнопкой «Предмет» или первое задание кнопкой «Задание».

Инвентарь

Инвентарь — предметы, которые читатель находит и тратит. У предмета название, описание, значок-эмодзи или картинка, категория. «Стакается» — копии собираются в одну ячейку, «Максимум в стаке» ограничивает их число. «Скрытый (квестовый флаг)» считается в условиях, но в окне не показывается. «Импорт из библиотеки» делает предметы из картинок пачкой: каждая станет предметом с именем файла.

ID предмета задаётся при создании и больше не меняется: на него ссылаются шаги, условия и скрипты.

Кнопка инвентаря поверх экрана по умолчанию выключена: обычно инвентарь ставят ради шагов и условий, а 🎒 у читателя — отдельное решение. Без неё окно открывает шаг «Открыть инвентарь». В «Настройках» же задаются число колонок и строк (не больше 24 ячеек), рамка окна и текст уведомления — по умолчанию «Получен: …».

Сделать предмет на сцене подбираемым можно без шагов: правый клик по нему — «Сделать подбираемым предметом…» и выбрать предмет. Тап читателя положит его в инвентарь и уберёт объект со сцены.

Журнал заданий

Журнал — задания, которые читатель берёт, выполняет или проваливает. У задания название, описание, значок и ID. «Скрытое задание» не видно в журнале — это служебный флаг сюжета.

Шаги журнала: «Взять задание», «Выполнить задание», «Провалить задание», «Снять задание», «Открыть журнал» и «Закрыть журнал». Читатель видит уведомления «Новое задание: …» и «Выполнено: …», их текст меняется в «Настройках». Кнопка журнала поверх экрана, как и у инвентаря, по умолчанию выключена.

Шаги и условия в сцене

Установленное расширение добавляет свой список во вкладку «Основные» блока «Действия»: «＋ Инвентарь» или «＋ Журнал заданий». Там его шаги — «Выдать предмет», «Убрать предмет», «Взять задание» и другие. У «Открыть инвентарь» есть галка «Ждать закрытия»: лента ждёт, пока читатель закроет окно.

Проверки — в условиях: у кнопки «if» на карточке и в ноде «Условие» появляются «Есть предмет», «Нет предмета», «Количество предмета», «Задание в работе», «Задание выполнено», «Задание провалено» и «Статус задания».

Если расширение выключить, его шаги в редакторе станут серыми, а у читателя молча пропустятся.

1. Установите «Инвентарь» и заведите предмет «Ключ» со значком 🔑.
2. В сцене находки добавьте блок «Действия» и выберите в «＋ Инвентарь» шаг «Выдать предмет» → «Ключ».
3. У двери сделайте два варианта выбора. Первому через «if» поставьте «Есть предмет» → «Ключ», второму — «Нет предмета» → «Ключ».
4. Нажмите «Сыграть» и пройдите оба пути.

Вкладка «Интерфейс» (HUD)

HUD — ваш слой поверх всех экранов новеллы: картинки, кнопки и надписи, которые читатель видит всё время. Вкладка «Интерфейс» по умолчанию скрыта и появляется после галки «Расширенные функции».

Наверху вкладки — для чего правим: «Вся новелла» или текущая глава. Глава сначала наследует HUD новеллы, «Сделать свой HUD» даёт ей собственный, «Вернуть наследование» — снимает его. Ниже — мини-экран 9:16: элементы на нём можно таскать мышью.

Всё остальное — в окне «Редактор HUD». В нём три кнопки: «Картинка» из библиотеки, «Кнопка-зона» — невидимая область для нажатия, и «Виджет» — плашка с текстом в рамке новеллы. В текст виджета можно вставить переменную: «Золото: {gold}» покажет текущее значение переменной gold. У выбранного элемента есть «Клик»: «Ничего», действие расширения вроде «Открыть/закрыть инвентарь», «Послать сигнал» или «Скрипт (JS)».

1. Откройте вкладку «Новелла», раздел «Геймплей», и отметьте «Расширенные функции».
2. Перейдите на появившуюся вкладку «Интерфейс» и нажмите «Редактор HUD».
3. Нажмите «Виджет» и впишите текст с переменной, например «Золото: {gold}».
4. Перетащите виджет на место и проверьте его в «Сыграть».

Статы у читателя

Переменную можно показать читателю. Шестерёнка «Настройки переменной» во вкладке «Перемен.» (или правый клик по строке) открывает меню: «Уведомлять при изменении» — всплывашка при каждой смене, «Показывать в меню плеера» — строка в «Статистике» в меню плеера, «Иконка у вариантов выбора» — значок стата на вариантах, которые его меняют.

«Иконка и текст уведомления…» в том же меню задаёт значок стата: встроенный, эмодзи, свой файл, картинка из библиотеки или генерация. Раздел «Иконки статов» под списком переменных держит общий эталон и стиль, чтобы сгенерированные иконки выглядели одной серией.

«Сердца» — переменная персонажа «Сердца / отношение», его отношение к читателю. В меню плеера они видны только после галки «Показывать «сердца»» в разделе «Геймплей» вкладки «Новелла». Рядом — «Уведомлять об изменении отношений».

Частые вопросы

Нет вкладки «Интерфейс» — где она? Она появляется после галки «Расширенные функции»: вкладка «Новелла», раздел «Геймплей».

Поставил инвентарь, а у читателя нет 🎒 — почему? Кнопка поверх экрана по умолчанию выключена. Включите её в «Настройках» инвентаря или откройте окно шагом «Открыть инвентарь».

Можно поменять ID предмета или задания? Нет: на ID ссылаются шаги, условия и скрипты, поэтому он задаётся один раз при создании.

Что будет, если удалить расширение? «Выключить, данные оставить» сохранит предметы, настройки и инвентарь читателей. «Удалить и вычистить» сотрёт всё, а шаги и условия, которые на него ссылаются, останутся битыми — редактор заранее покажет, сколько их.

А мини-игры здесь есть? Нет, мини-игры — это скрипты: готовые лежат в палитре редактора скриптов. Об этом — в статье «Скрипты и мини-игры».