Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

アクション行

クローディア(にっこり)

キャラクターたちが口を開く、いよいよその時が参りましたわね。

アンソニー(素)

お嬢様、少々お声が弾んでおられますね。

クローディア(高笑い)

当然ですわ! 「誰が、何を話すか」を書くアクション行――台本でいう台詞こそ、ゴーストの命。いちばん楽しいところですもの、張り切って参りましょう!


アクション行は、台本の台詞にあたる行である。「アクター名 : 台詞」の形で、誰が何を話すかを書く。台詞の中には、表情や間のようなト書きも、単語や変数と一緒に埋め込める。

%ぱすた
    @驚き:\s[2]
    @照れ:\s[1]

*会話
    ぱすた:@驚き えっ、見てたの?\w9@照れ ……ちょっと恥ずかしいな。

この例の台詞は、驚いた顔(@驚き)で話し始め、少し間を置いて(\w9)、照れた顔(@照れ)に変わる。

基本構文

アクター名:アクション内容

インデントした行頭にアクター名を書き、コロン(: / :)の後ろにアクション内容を書く。コロンの前後の空白は無視される。

*会話
    ぱすた:今日はいい天気だね
    ラザニア:そうですわね、散歩に参りましょうか
  • アクター名は識別子である(識別子)。空白や記号を含む任意の文字列は書けない。
  • アクター名には、アクター辞書(%名前)で定義した名前か、pasta.toml の [actor] に登録した名前を使う(アクター辞書)。登録していない名前を書いたときの挙動は 登録していないアクター名 で扱う。
  • アクター名が act(シーンの実行に使われるオブジェクト)のメソッド名・フィールド名(talk・word・var・save・actors など)と同じでも、アクション行ではそのアクターの発言として出力される。Lua から act.名前 で参照するときの制限は アクタープロキシ で扱う。
  • アクション行の行末に # を書いても、コメントにはならず本文として出力される(コメント)。

アクター名は会話だけでなく、さくらスクリプトによる表情指定などアクション全般を制御する。

アクターの省略

アクター名を書かず、インデントした行頭にコロン(: / :)を置いた行は継続行になる。継続行は直前のアクション行と同じアクターの発言として扱われ、前の発言に続けて出力される。

*長い会話
    ぱすた:今日はね
    :とてもいい天気なんだ
    :だから散歩に行こうと思ってるんだ

    ラザニア:よろしくてよ!
    :ご一緒いたしますわ!

継続行の規則は 行継続 で扱う。

登録していないアクター名

アクター辞書にも pasta.toml の [actor] にも無い名前(書き間違いなど)をアクター名に書いても、実行時エラーにはならない。その行は、名前を登録しないその場限りのアクターの発言として、立ち位置 0 で出力される。

%ぱすた

*挨拶
    ぱすた:こんにちは
    ぱすたー:はじめまして
    :よろしくね
  • 発言の先頭に、目印 【未登録アクター:名前】 がバルーンに表示される。上の例の 2・3 行目は「【未登録アクター:ぱすたー】はじめましてよろしくね」と表示される。目印は話者がその名前に切り替わるたびに 1 回付き、同じ名前の行(継続行を含む)が続く間は繰り返さない。
  • ログに警告(act:actor_proxy - unregistered actor)が 1 行出る。目印と警告の詳細は 実行時の失敗の出力 を参照する。
  • 行の中の単語参照・関数呼び出し・さくらスクリプトは、登録済みのアクターの行と同じく働く。アクター辞書が無いため、アクター辞書の段では見つからず、それ以外の段で探される(アクタースコープと単語参照の統合)。
  • 名前はアクターとして登録されない。後の % 行・アクション行・Lua からは、登録済みのアクターとして見えない。

インライン要素

アクション内容には次の要素を埋め込める。

要素構文説明
通常テキストこんにちは任意の文字列
単語参照@名前登録済み単語からランダム選択(単語定義)
関数呼び出し@名前(引数、引数)シーンの Lua 関数などを呼び出し、戻り値を出力する
グローバル関数呼び出し@*名前(引数、引数)GLOBAL テーブルの関数を呼び出し、戻り値を出力する
動的単語参照@$名前変数の値を単語キーとして単語を選ぶ(動的単語参照)
動的関数呼び出し@$名前(引数、引数)変数の値を関数名として関数を呼び出し、戻り値を出力する(動的関数呼び出し)
ローカル変数参照$名前変数値を展開
グローバル変数参照$*名前グローバル変数の値を展開
シーン引数参照$0・$1…シーンが受け取った引数を展開
プロパティ参照$%名前プロパティの値を展開
@エスケープ@@リテラルの「@」を 1 文字出力
$エスケープ$$リテラルの「$」を 1 文字出力
バックスラッシュのエスケープ\\「\」を 1 文字表示(さくらスクリプトのエスケープ)
パーセントのエスケープ\%「%」を 1 文字表示(さくらスクリプトのエスケープ)
さくらスクリプト\n \w8 \s[0]表情・タイミング制御(さくらスクリプト)
*いろいろ
    ぱすた:こんにちは、$player_name さん!\w8
    ぱすた:今日の天気は@weather_words ですね\n
    ぱすた:合計は@足す(10、20)です
    ぱすた:価格は$$100、連絡先は info@@example.com です
    ぱすた:保存先は C:\\new です
    ぱすた:達成率は100\%です
  • 関数呼び出しの括弧は全角・半角のどちらでもよい。引数は読点 、・全角カンマ ,・半角カンマ , で区切り、書いた順に位置で渡される。名前:値 の形も受理されるが、名前は捨てられ、値だけが位置で渡される。引数の書き方は 引数リスト と同じである。
  • 引数が式として正しくない場合(@挨拶(時間:朝) の 朝 のように、引用符の無い文字列を値に書いた場合など)は、関数呼び出しにならない。@挨拶 の単語参照と本文「(時間:朝)」として解釈される。動的関数呼び出しも同じで、@$名前(時間:朝) は @$名前 の動的単語参照と本文「(時間:朝)」になる。
  • 動的単語参照・動的関数呼び出しは、@ の後ろの名前の代わりに変数を書き、その時点の変数の値を単語キー・関数名に使う。変数にはグローバル変数(@$*名前)・シーン引数(@$0)も書ける。探し方と、値が使えないときの挙動は 動的単語参照 で扱う。
  • @@・$$ は、全角・半角を混ぜて書いても(@@・$$)2 文字目の 1 文字を出力する。
  • \\ は、さくらスクリプトで \ を 1 文字表示するエスケープである。2 文字のまま出力され、ベースウェアが \ 1 文字として表示する。直後の文字とタグにはならないため、C:\\new は「C:\new」と表示され、\n の改行にはならない。行末に書いても \ を表示してからスクリプトが終わり、\\\\ と重ねると \ が 2 文字表示される。ウェイトの自動挿入や改行位置の推定で、\\ の 2 文字の間に何かが入ることはない。
  • 同じく、見た目の 1 文字(拡張書記素クラスタ)の途中にも、ウェイトや改行は入らない。組み合わせの絵文字(🙆‍♀️・👍🏽・🇯🇵)や結合文字の付いた文字は、いくつかのコードポイントでできていても 1 文字として扱われ、ウェイトは後ろに 1 つだけ入る。半角カナと半角の濁点・半濁点の並び(ガ・パ など)も 1 文字である(文字の分類)。
  • \% は、さくらスクリプトで % を 1 文字表示するエスケープである。\\ と同じく 2 文字のまま出力され、ベースウェアが % 1 文字として表示する。直後の文字とタグにはならず、2 文字の間に何かが入ることもない。
  • さくらスクリプトの囲み(\_?…\_?)の中では、@・$・\ で始まるインライン要素は展開されず、書いたとおりに出力される(タグをそのまま表示する囲み)。
  • 変数の種類・プロパティ参照・シーン引数は 変数・スコープ で扱う。
%ぱすた

@果物:りんご、みかん、ぶどう

*動的参照
    $種類=「果物」
    ぱすた:今日の$種類 は@$種類 です

この例の @$種類 は、@果物 と書いた場合と同じく「りんご」「みかん」「ぶどう」から 1 つを選ぶ。

重要: アクション内では変数の参照($名前)のみ可能。変数の代入($名前=式)は専用の変数代入行で行う(変数・スコープ)。

台詞と連結演算子

台詞(継続行を含む)に書いた &/& は、連結演算子にならず、文字のまま出力される。一方、台詞の中の関数呼び出し(@名前(…)・@*名前(…)・@$名前(…))の引数は式であり、引数に書いた & は連結演算子になる(連結の評価)。

%ぱすた

*連結と台詞
    $a=「りんご」
    $b=「みかん」
    ぱすた:$a&$b です
    ぱすた:@かぎ括弧($a&「と」&$b)です

```lua
function SCENE.かぎ括弧(actor, s)
    return "「" .. s .. "」"
end
```

この例の 1 つ目のアクション行は、$a の値・&・$b の値を並べて「りんご&みかんです」と表示する。2 つ目のアクション行は、$a&「と」&$b をつないだ りんごとみかん を関数 かぎ括弧 に渡し、「「りんごとみかん」です」と表示する。

インライン要素の区切り

行は左から右へ走査され、マーカー文字(\ @ $)で分岐して各要素が最長一致で切り出される。同じ位置で複数の要素に当てはまる場合は、エスケープ(@@・$$・\\・\%)→ 関数呼び出し(動的関数呼び出しを含む)→ 単語参照(動的単語参照を含む)→ 変数参照 → さくらスクリプト → 通常テキストの順に判定する。識別子の終端は、空白による区切り、または識別子に含まれない文字の出現で決まる。

空白による区切り

単語参照(動的単語参照を含む)・変数参照の直後の空白はトークン区切りとして認識され、空白の数に関係なく 1 つの区切りとして扱われる。区切りの空白は出力に含まれない。

@挨拶 みんな!      → 単語参照「挨拶」+ 通常テキスト「みんな!」
@挨拶   みんな!  → 同じ出力(空白数は無関係)
$name さん         → 変数参照「name」+ 通常テキスト「さん」
@時刻() です     → 関数呼び出し「時刻」+ 通常テキスト「 です」
@$種類 です       → 動的単語参照「$種類」+ 通常テキスト「です」

関数呼び出し(@名前()・@*名前()・@$名前())は閉じ括弧で終わるため、直後の空白は区切りとして消えず、本文に残る。

空白がない場合(最長一致)

空白で区切られない場合、識別子に含まれない文字が現れるまでを最長一致で取り込む。

@挨拶、みんな!        → 単語参照「@挨拶」+ 通常テキスト「、みんな!」(読点は識別子外)
$name!                → 変数参照「$name」+ 通常テキスト「!」
@weather_wordsですね  → 識別子「@weather_wordsですね」として吸収(意図しない例)

意図せず後続が吸収されるのを防ぐには、空白で区切る(@weather_words ですね)か、読点など識別子に含まれない記号で区切る(@weather_words、ですね)。

行継続

長い発言は、継続行(インデント+:)で複数行に分けて書ける。継続行の内容は、直前のアクション行のアクターの発言として前の発言に続けて出力される。

*長文
    ぱすた:長い台詞は
    :複数行に分けて
        :記述できます

上の例の出力は「長い台詞は複数行に分けて記述できます」となる。

  • 継続行は、インデントの後にコロン(: / :)を置いて始める。コロンを置かずにテキストだけを書いた行は継続行にならず、パースエラーになる。
  • 継続行のインデントの深さは問わない。直前の行より深くても浅くてもよい。
  • 継続行のアクターは、同じシーン(暗黙の開始ブロック、またはローカルシーン)の中で直前に書いたアクション行のアクターである。間に変数代入行・Call 行・空行・コメント行があってもよい。
  • 同じシーンの中に先行するアクション行が無い位置(ローカルシーンの先頭など)に継続行を書くと、トランスパイルエラーになる。親のグローバルシーンのアクション行は引き継がれない。
  • 継続行の行末に # を書いても、コメントにはならず本文として出力される。
  • 継続行と、同じアクターを書き直したアクション行は、既定では前の発言に続けて出る。pasta.toml の [ghost] に line_newlines を書くと、同じ話し手の行の前に改行が入る(改行)。

改行

出力に改行を入れるには、さくらスクリプトの \n を使う。\n は常に「改行」として解釈される。

*改行例
    ぱすた:1行目。\n
    :2行目。

    :3行目。

上の例の出力は「1行目。」の後に改行が 1 つ入り、「2行目。3行目。」が続く。継続行の間の空行は何も出力せず、改行にもならない。空行は、継続行の間を含めてどこに置いても無視される。

pasta.toml の [ghost] に line_newlines を書くと、同じ話し手の行(継続行・同じアクターを書き直したアクション行)の前に、書いた幅の改行が入る。既定(0.0)では改行は入らず、前の発言に続けて出る。

*OnTalk
 さくら:やあ。
    :元気?

この例の出力は、既定では やあ。\_w[950]元気? と続き、line_newlines = 1.8 では やあ。\_w[950]\n[180]元気? になる。

  • 字を出さない行(表情の単語だけの行など)も 1 行と数える。その行の分の改行も入るので、空の行が 1 つできる。
  • 空行・コメント行・変数代入行・Call 行は行に数えない。
  • 次の場合は改行が入らない。
    • 話し手が替わった後の行(話し手の切り替えの改行だけが入る)。
    • 選択肢の後の行(選択肢の後の区切りだけが入る)。
    • 行の最初の字より前に、行の頭の位置を決めるタグ(\n・\n[…]・\_l[…]・引数の無い \c)があるとき。
    • 前の出力が、末尾の位置を決めるタグ(同じタグ)で終わるとき。
    • その吹き出しに字が無いとき(1 回の出力の最初の行や、\c で消した後)。
  • 細かい規則は line_newlines を参照。

細かいタイミング制御には、さくらスクリプトの \w 等を使うのが推奨される(さくらスクリプト)。


クローディア(目閉じ)

これでキャラクターが生き生きと喋り出しますわ。変数や単語を混ぜれば、表現は無限に広がりますのよ。

アンソニー(素)

次は、その台詞を話す登場人物――「アクター辞書」でございます。