Интерактивный онбординг

Эта функция нужна, только если вы делаете карточки, в которые будут играть другие люди. Интерактивный онбординг позволяет карточке персонажа задавать игроку вопросы, когда он начинает чат Roleplay, а затем собирает из ответов персону. Авторы настраивают его в редакторе персонажа. Игроки отвечают в мастере настройки нового чата.

Что он делает

Персона – это карточка персонажа, которая представляет вас в чате. См. Персоны. Обычно вы пишете ее сами, прежде чем начать игру. С онбордингом карточка вместо этого содержит шаблон персоны: пять полей персоны – Description (описание), Personality (личность), Backstory (предыстория), Appearance (внешность) и Scenario (сценарий) – с пропусками для игрока, а также вопросы, которые эти пропуски заполняют.

Начиная чат Roleplay с этой карточкой, игрок может выбрать Create your persona (создать свою персону), ответить на вопросы и получить новую обычную персону. Ответы вписываются в текст один раз. Игрок может редактировать, оставить или удалить эту персону, как любую другую. Карточка не меняется.

Карточка может также задавать вопросы о персонаже, ответы на которые сохраняются в этом одном чате, а не в персоне. См. Вопросы о персонаже. Онбординг использует существующий синтаксис макросов и не запускает никаких скриптов.

Настройка для автора

  1. Откройте персонажа в редакторе персонажа. См. Создание и редактирование персонажей.
  2. Откройте вкладку Onboarding (онбординг) рядом с Card (карточка).
  3. Включите Interactive onboarding (интерактивный онбординг). Под переключателем появится краткое руководство How onboarding works (как работает онбординг).

Выключение переключателя скрывает поля онбординга, но сохраняет написанное.

Пусть онбординг напишет Professor Mari

Попросите Professor Mari, например: "Напиши веселый онбординг для Queen Ayrene с шаблоном персоны." Она пишет вопросы и поля персоны и включает онбординг. Перед сохранением приложение проверяет ее работу. Имя с опечаткой, {{name}} без вопроса или условие без знака # возвращаются ей на исправление. Для вопроса о персонаже она также добавляет его {{name}} в одно из собственных полей карточки. Ее изменения появляются в карточке изменений, которую можно просмотреть или отменить.

Добавление вопросов о персоне

В разделе Persona Questions (вопросы о персоне) нажмите Add Question (добавить вопрос). Каждый вопрос работает как переменная пресета – именованный пропуск, который заполняет ответ. См. Редактор пресетов и управление промптами. У карточки может быть до 100 вопросов.

ПолеЧто делает
Variable Name (имя переменной)Имя, которое вы используете в полях, например faction. Используйте буквы, цифры и знаки подчеркивания; имя должно начинаться с буквы или знака подчеркивания. Регистр в именах важен: Gender и gender – разные имена.
Question (shown to user) (вопрос, который видит пользователь)Текст, который читает игрок. В нем можно использовать предыдущие ответы, например What does {{player}} look like?. {{char}} – имя карточки, а {{user}} – имя игрока.
Options (варианты)Превращают вопрос в выбор. Первый вариант выбран по умолчанию. Если вариантов нет, игрок вводит ответ свободным текстом.
Value (значение)То, что попадает в персону. Прописные и строчные буквы сохраняются так, как вы их ввели, а макросы в значении заполняются. Оставьте поле пустым, чтобы использовать подпись варианта. Если ответ стоит в середине предложения, используйте значение строчными буквами, например ranger.
Help text for players (подсказка для игроков)Необязательный текст под вариантом.
Allow own answer (разрешить свой ответ)Добавляет рядом с вашими вариантами выбор Write your own (написать свой).
Multi-Select (выбор нескольких вариантов)Позволяет игроку выбрать несколько вариантов, которые соединяются через разделитель.

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

Заполнение полей персоны

Напишите пять полей так же, как для собственной персоны, и поставьте {{name}} там, где должен стоять ответ. Нажмите на поле, чтобы увидеть его список Available variables (доступные переменные), и нажмите переменную, чтобы вставить ее в позицию курсора.

Name: {{player}}
Class: {{class}}
Role: {{player}} is a {{class}} sworn to {{faction}}.

Чтобы показывать текст только при некоторых ответах, используйте {{#if}}:

{{#if knowsHer == yes}}Grew up next door to {{char}}. {{relationToAna}}{{/if}}

Вопрос, который встречается только внутри {{#if}}, задается, только когда условие истинно. Здесь relationToAna – уточняющий вопрос, который появляется, когда игрок отвечает yes. Сравнения не учитывают регистр.

{{user}} и {{char}} остаются в созданной персоне макросами. Другие макросы (метки, которые заполняет Marinara, например {{random}} для случайного числа или {{time}} для времени) заполняются один раз при создании персоны или остаются пустыми, если в этот момент у них нет значения.

Rendered preview (предпросмотр результата) внизу показывает персону, собранную из примеров ответов, и по порядку перечисляет задаваемые вопросы.

Вопросы о персонаже

На той же вкладке есть второй список, Character Questions (вопросы о персонаже). Они работают как вопросы о персоне, но ответы сохраняются в чате, а не в персоне. Подставьте имя в одно из собственных полей карточки (Description, Personality, Backstory, Appearance или Scenario), потому что именно эти поля читает модель.

{{char}} treats {{relationshipToUser}} with open warmth.

В приветствии можно использовать {{name}} вопроса о персонаже, и там показывается ответ игрока. В приветствии можно использовать и {{name}} вопроса о персоне, например Ah, so you are a {{class}}, но он подставляется, только если игрок создает эту персону в мастере нового чата, и только в первом сообщении и его альтернативных приветствиях. С существующей персоной или в Quick Start тег показывается как написан, и редактор персонажа предупреждает об этом. Нажмите на приветствие, и в его списке Available variables будут оба вида вопросов с подписями.

Ответы хранятся как переменные чата, так что карточка в каждом чате читает свое значение, и ее никогда не нужно редактировать. Вопрос о персонаже задается всякий раз, когда карточка есть в чате, независимо от того, создает ли игрок персону. Раздел About you (о вас) окно показывает, только когда создается персона.

Стоит знать три вещи:

Ответы на вопросы для игрока

  1. Начните новый чат Roleplay. На шаге Persona & Characters (персона и персонажи) карточки с онбордингом отмечены в списке персонажей маленьким значком человечка с плюсом.
  2. Добавьте персонажа. Чтобы получить новую персону, выберите Create your persona в начале списка Your Persona (ваша персона). В этой строке указано название карточки, к которой она относится. Любой другой выбор, включая None (нет), пропускает создание персоны.
  3. Нажмите Next (далее). Окно с вопросами открывается всякий раз, когда у какой-либо карточки в чате есть вопросы о персонаже, независимо от того, создаете ли вы персону.
  4. Ответьте на вопросы. Сначала идут вопросы о персонаже, по одному разделу на карточку, затем About you, если создается персона. Уточняющие вопросы появляются, когда ваши ответы делают их уместными.
  5. Нажмите Review persona (просмотреть персону), чтобы увидеть имя и поля, которые дадут ваши ответы. Части, заполненные вашими ответами, выделены. Предпросмотр ничего не сохраняет.
  6. Нажмите Create persona (создать персону) или, если вы не создаете персону, Save answers (сохранить ответы). Ответы о персонаже сохраняются в чате, и мастер продолжает работу.

Если не получилось: если персона создана, но не выбрана, выберите ее в Your Persona. Если ответы не удалось сохранить, чат использует вместо них собственный текст каждой карточки по умолчанию.

Вопросы онбординга задаются в мастере настройки нового чата Roleplay. Quick Start, настройка Conversation и запуск чата прямо с карточки персонажа их пока не задают. Чат, начатый таким способом, заполняет первый вариант каждого вопроса, поэтому {{relationshipToUser}} превращается в значение, а не остается тегом. Ответ в мастере заменяет это значение по умолчанию только для этого чата.

Ответить можно и после настройки, из панели Chat Settings (настройки чата):

Если добавить карточку с вопросами о персонаже в уже идущий чат Roleplay из Chat Settings или перетащив ее в чат, сначала задаются ее вопросы. Затем предлагается ее приветствие с вашими ответами, подставленными и отмеченными.

Как делиться карточками с онбордингом

Онбординг хранится вместе с карточкой. Экспорт в форматах Marinara Native и Compatible PNG Card его сохраняет, поэтому игрок, который импортирует карточку, тоже получает вопросы. Формат Compatible JSON его не включает. Если у импортированной карточки больше 100 вопросов, остаются первые 100. См. Импорт и экспорт карточек персонажей.

Смежные руководства