対話式オンボーディング

このガイドが必要なのは、ほかの人が遊ぶためのカードを作る場合だけです。対話式オンボーディングを使うと、プレイヤーがRoleplayのチャットを始めるときにキャラクターカードが質問をし、その回答からペルソナを作ります。作者はCharacter Editor(キャラクターエディター)で設定します。プレイヤーは新規チャットのウィザードで回答します。

機能の概要

ペルソナとは、チャットの中で自分を表すキャラクターカードです。ペルソナを参照してください。ふつうはプレイを始める前に、自分で書きます。オンボーディングでは、その代わりにカードがペルソナのテンプレートを同梱します。テンプレートは、プレイヤーが埋める空所の入ったペルソナの5つの欄(Description、Personality、Backstory、Appearance、Scenario)と、その空所を埋める質問からなります。

プレイヤーがそのカードでRoleplayのチャットを始めるときにCreate your persona(自分のペルソナを作る)を選んで質問に答えると、新しい通常のペルソナができあがります。回答は一度だけ文章に書き込まれます。プレイヤーは、ほかのペルソナと同じようにこのペルソナを編集したり、残したり、削除したりできます。カードは変わりません。

カードはキャラクターの質問を出すこともできます。その回答はペルソナではなく、そのチャット1つに保存されます。キャラクターの質問を参照してください。オンボーディングは既存のマクロ構文を使い、スクリプトは一切実行しません。

作者側での設定

Character Editorでキャラクターを開きます。キャラクターの作成と編集を参照してください。
Cardの隣にあるOnboarding(オンボーディング)タブを開きます。
Interactive onboarding(対話式オンボーディング)をオンにします。スイッチの下に、短いガイドのHow onboarding works(オンボーディングの仕組み)が表示されます。

スイッチをオフにするとオンボーディングの欄は隠れますが、書いた内容は残ります。

Professor Mariに書いてもらう

Professor Mariに頼みます。たとえば「Ayrene女王の楽しいオンボーディングを、ペルソナのテンプレート付きで書いて」と伝えます。Professor Mariは質問とペルソナの欄を書き、オンボーディングをオンにします。保存する前に、アプリが内容を確認します。綴りを間違えた名前、質問のない{{name}}、#が抜けた条件は、Professor Mariに差し戻されて修正されます。キャラクターの質問の場合は、その{{name}}をカード自身の欄のどれかにも追加します。Professor Mariの変更は変更カードに表示され、確認したり元に戻したりできます。

ペルソナの質問の追加

Persona Questions(ペルソナの質問)の下でAdd Question(質問の追加)をクリックします。各質問はプリセット変数と同じように動作します。プリセット変数とは、回答で埋まる名前付きの空所です。プリセットを参照してください。1枚のカードに入れられる質問は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という名前の質問は、ペルソナの名前を決めます。この質問がない場合、プレイヤーは最初に名前を尋ねられます。名前が空のとき、無効なとき、重複しているとき、組み込みマクロと同じ名前のとき、そしてどの欄でも使われていない質問があるときは、エディターが警告します。

ペルソナの欄の記入

5つの欄は自分のペルソナと同じように書き、回答を入れたい場所に{{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(展開後のプレビュー)には、例の回答から組み立てたペルソナが表示され、尋ねられる質問が順番に一覧になります。

キャラクターの質問

同じタブには、2つ目のリストCharacter Questions(キャラクターの質問)があります。ペルソナの質問と同じように動作しますが、回答はペルソナではなくチャットに保存されます。名前は、カード自身の欄(Description、Personality、Backstory、Appearance、Scenario)のどれかに入れてください。モデルが読むのはこれらの欄だからです。

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

挨拶メッセージではキャラクターの質問の{{name}}を使え、プレイヤーの回答が表示されます。Ah, so you are a {{class}}のように、ペルソナの質問の{{name}}も挨拶メッセージで使えます。ただし値が入るのは、プレイヤーが新規チャットのウィザードでそのペルソナを作成したときだけで、対象は最初のメッセージと代替の挨拶メッセージです。既存のペルソナやQuick Startの場合、タグは書いたとおりに表示され、Character Editorが警告します。挨拶メッセージをクリックすると、そのAvailable variables(使える変数)に両方の種類がラベル付きで表示されます。

回答はチャット変数として保存されます。そのため、カードはチャットごとに別の値を読み取り、カードを編集する必要はありません。キャラクターの質問は、プレイヤーがペルソナを作るかどうかにかかわらず、そのカードがチャットにある限り尋ねられます。ウィンドウにAbout you(自分について)が表示されるのは、ペルソナを作成しているときだけです。

知っておくべき点が3つあります。

一度も入力されない回答は、タグのまま残ります。 デフォルトのない自由入力の質問には初期値が入らないため、ウィザードを使わずに始めたチャットでは{{name}}が書いたとおりに表示されます。選択式の質問は最初の選択肢が初期値になるので、多くのカードはこれで足ります。
1つのチャットで同じ名前を宣言する2枚のカードは、1つの値を共有します。 最後に保存された回答を両方が読みます。ウィンドウが警告します。
チャットから外れたカードは、自分の回答も一緒に持っていきます。 キャラクターを削除すると、そのキャラクターの質問が持つチャット変数も削除されます。ただし、チャット内の別のキャラクターが同じ名前を宣言している場合は削除されません。

プレイヤーとして質問に答える

Roleplayのチャットを新しく始めます。Persona & Characters(ペルソナとキャラクター)のステップでは、キャラクター一覧のうちオンボーディングのあるカードに、人型にプラスが付いた小さなアイコンが表示されます。
キャラクターを追加します。新しいペルソナを作るには、Your Persona(自分のペルソナ)の先頭にあるCreate your persona(自分のペルソナを作る)を選びます。この項目には、元のカードの名前が添えられています。None(なし)を含め、ほかの選択肢を選ぶとペルソナは作られません。
Next(次へ)をクリックします。チャット内のカードのどれかにキャラクターの質問があれば、ペルソナを作るかどうかにかかわらず、質問のウィンドウが開きます。
質問に答えます。最初にキャラクターの質問がカードごとのセクションで表示され、ペルソナを作成している場合はそのあとにAbout you(自分について)が表示されます。追加の質問は、回答によって必要になった時点で現れます。
Review persona(ペルソナを確認)をクリックすると、回答から作られる名前と各欄が表示されます。回答で埋まった部分は強調表示されます。プレビューでは何も保存されません。
Create persona(ペルソナを作成)をクリックします。ペルソナを作らない場合はSave answers(回答を保存)をクリックします。キャラクターの回答はチャットに保存され、ウィザードが先へ進みます。

うまくいかなかった場合: ペルソナが作成されたのに選択されていないときは、Your Personaで選んでください。回答を保存できなかったときは、チャットは代わりに各カード自身のデフォルトの文章を使います。

オンボーディングの質問が尋ねられるのは、Roleplayの新規チャットのウィザードです。Quick Start、Conversationの設定、キャラクターカードから直接チャットを始める方法では、まだ尋ねられません。その方法で始めたチャットでは各質問の最初の選択肢が入るため、{{relationshipToUser}}はタグのまま表示されず、値に置き換わります。ウィザードで回答すると、そのチャットに限ってこのデフォルトが置き換わります。

設定の後でも、Chat Settings(チャット設定)から回答できます。

RoleplayチャットのPersona(ペルソナ)のピッカーには、チャット内でペルソナの作成を用意しているカードごとにCreate your personaが並びます。ウィザードを飛ばしたときや、後から新しいペルソナが欲しくなったときに使ってください。チャットで使うペルソナの選択を参照してください。
Characters(キャラクター)でキャラクターの横にあるオンボーディングの印を押すと、そのカードのキャラクターの質問だけがもう一度開きます。チャットがすでに持っている回答が入った状態で開くので、1つを変えて保存しても、ほかの回答はそのまま残ります。保存すると、Chat Variables(チャット変数)から削除した回答も元に戻ります。ほかのカードの回答には触れません。ただし、2枚のカードが共有する名前は1つの値なので、両方のカードが新しい回答を読みます。

実行中のRoleplayチャットに、キャラクターの質問を持つカードをChat Settingsから、またはチャットへドロップして追加すると、まずその質問が尋ねられます。そのあと、回答を入れて印を付けた挨拶メッセージが提示されます。

オンボーディング付きのカードの共有

オンボーディングはカードと一緒に保存されます。Marinara NativeとCompatible PNG Cardのエクスポートでは保持されるため、カードをインポートしたプレイヤーにも質問が表示されます。Compatible JSONでは含まれません。質問が100個を超えるカードをインポートすると、最初の100個だけが残ります。キャラクターカードのインポートとエクスポートを参照してください。