3. イベント

里々のイベントには3種類あります。湊での扱いは、種類によって大きく違います。

① SSPのイベントはそのまま書ける

＊OnBoot は OnBoot => に、（Ｒ０） は reference["0"] に置き換えます。

OnMouseDoubleClick => {
    if (reference["4"] == "Head") {
        湊: 頭をつつかないでください。
    } else {
        湊: ${reference["4"]}ですね。
    }
}

\0頭をつつかないでください。\e
\0Bustですね。\e

OnMouseDoubleClick の Reference4 は当たり判定名です。どのイベントにどの Reference が付くかは、SSPのドキュメント（UKADOC）に従います。

Reference は文字列

reference は、キーが文字列の番号（"0", "1", …）のマップで、値はすべて文字列です。reference.0 とも書けます。

OnFoo => {
    湊: ${reference.0}/${reference["1"]}
}

\0abc/def\e

値が文字列なので、数値のつもりで + を使うと連結になります。

OnMouseClick => {
    湊: ${reference["0"] + 1}|${to_num(reference["0"]) + 1}
}

\031|4\e

reference["0"] + 1 は "3" + 1 で 31 になります。里々の （Ｒ０）＋１ は 4 でした。数値として扱いたいときは to_num() を通してください。 比較の < >= は自動で数値化されるので、そのまま使えます（詳しくは5. 変数）。

起動系のイベント

SSPは、OnFirstBoot、OnGhostChanged、OnGhostCalled に何も返さなかった（204）ときに、続けて OnBoot を送ります（SSPの仕様）。里々が持っていた「未定義なら OnBoot を代用する」動きは、SSP上ではそのまま期待できます。湊自身は代用処理をしません。

OnFirstBoot を使うなら、OnFirstBoot => を定義します。初回に何か喋った場合、SSPは OnBoot を続けて送りません。初回のあとにも通常の起動トークを出したいときは、OnFirstBoot の中から call 起動 のように呼びます。

② ランダムトーク

里々では、名前のない ＊ が「ランダムトーク」になり、間隔は ＄喋り間隔 で決まりました。湊では、OnRandomTalk という名前のトークを書きます。同名を複数書けば、その中から選ばれます。

OnRandomTalk => {
    湊: 今日もいい天気ですね。
}

OnRandomTalk => {
    湊: 何か用ですか？
}

\0今日もいい天気ですね。\e
\0何か用ですか？\e

発火のしくみ

• SSPが1分ごとに送る OnMinuteChange を、湊が数えます。前回から talk_interval_secs（既定300秒）＋ 0〜talk_jitter_secs（既定180秒）が経っていれば、OnRandomTalk を実行します。
• 起動直後にも、この間隔が適用されます。起動してから最初のランダムトークまで、最短でも5分かかります。
• 間隔は config.toml に書きます。ただし、一度でも起動して save.json ができると、config.toml の値は無視されます（9. セーブデータ）。

OnMinuteChange と OnAITalk は自分で定義できない

湊は、この2つのイベントを内部で処理します。自分で OnMinuteChange => や OnAITalk => を書いても、呼ばれません。

• OnMinuteChange は、上記のとおりランダムトークの発火に使われます。
• OnAITalk（SSPのメニューなどからユーザーが手動でランダムトークを求めたとき）は、OnRandomTalk に読み替えて実行されます。

OnAITalk => {
    湊: OnAITalkは呼ばれない
}

OnRandomTalk => {
    湊: OnRandomTalkが呼ばれる
}

OnMinuteChange => {
    湊: OnMinuteChangeも呼ばれない
}

\0OnRandomTalkが呼ばれる\e
\e

2行目の \e は、OnMinuteChange に対して湊が「何も喋らない」で返した応答です。OnSecondChange など、他のイベントは普通に自分で定義できます。

③ 里々独自のイベントは自分で作る

里々が用意してくれていた独自イベントは、湊にはありません。SSPのイベントを組み合わせて作ります。

撫で反応を作る

撫で反応は、OnMouseMove が続けて来た回数を数えて作ります。セーブしたくないカウンタは global work.… に置きます（save 以外は保存されません。5. 変数）。

OnMouseMove => {
    if (reference["4"] == "Head") {
        global work.head += 1
        if (work.head >= 3) {
            global work.head = 0
            湊: くすぐったいです。
        }
    }
}

(204)
(204)
\0くすぐったいです。\e
(204)
{}

3回目で反応し、カウンタが0に戻ります。最後の {} は、終了時に書き出される save の中身です。work は保存されていません。

湊が勝手にやること

里々が勝手にやっていたことがあるように、湊にも、書いていないのにやることがあります。挙動を比べるときに必要なので、まとめておきます。

save.last_talk の実際の中身を確認しましょう。

OnRandomTalk => {
    湊: ふつうのトーク
}

\0ふつうのトーク\e
{"last_talk":"\\0ふつうのトーク"}

OnAITalk の応答は \0ふつうのトーク\e で、そこから末尾の \e を除いた文字列が、save.last_talk に入ります（上のJSON表示では \ が \\ と書かれています）。

OnTranslate を使うとき

里々の replace.txt の代わりに、SSPの OnTranslate イベント（さくらスクリプトを送信前に加工できる）を使うことができます。湊でも普通のイベントとして定義できます。

OnTranslate => {
    return replace(reference["0"], "あ", "い")
}

\0いいう\e\e

湊は、応答の末尾に必ず \e を付けます。 OnTranslate に渡されたスクリプトは末尾に \e を含むので、返す文字列の末尾は \e\e になります。SSPがこれをどう扱うかは、SSP側での検証が必要です（この点は実機のSSPでは未確認です）。

次は4. トークに進んでください。