ビルトイン関数

数値・算術

自然対数は ln です。log は対数ではなくデバッグ出力用の関数（制御・ユーティリティ）なので注意してください。

三角関数

文字列

count contains starts_with ends_with は大文字・小文字を区別します。 大文字小文字を無視して比較したい場合は to_lower で統一してから使ってください。

// 大文字小文字を無視してカウントする例
let n = count(to_lower("Pineapple"), "p")
// n == 3

正規表現

OnBoot => {
    let s = "2026年1月1日"
    let caps = regex_captures(s, "(\d+)年(\d+)月(\d+)日")
    湊: ${caps[1]}年${caps[2]}月${caps[3]}日ですね。
}

湊の文字列リテラルの中では \ はそのまま1文字として扱われます。 正規表現の \d などは \\d ではなく \d と書いてください （\\d と書くと \ が2文字残り、意図したパターンに一致しません）。

配列

push pop sort reverse unique は元の配列を変更しません。新しい配列を返します。配列以外を渡すと、sort reverse unique は空配列を返します。

sortのモード

第2引数で並べ方を選びます。

• 省略、または "kana" "desc" 以外の文字列（"asc" など）のときは昇順です。エラーにはなりません。
• 昇順・降順では、数値同士は数値の大小で比べます。それ以外は文字列表示のコードポイント順で比べます（sort([10,9,2]) は [2,9,10] ですが、sort(["10","9","2"]) は ["10","2","9"] です）。
• "kana" では、数値も文字列表示で比べます（sort([10,9], "kana") → [10,9]）。
• "desc" と "kana" は同時に指定できません。逆かな順は reverse(sort(arr, "kana")) と書きます。

かな順の基準

"kana" は、各要素の文字列表示を次のように読み替えたキーで、コードポイント順に並べます。

• カタカナはひらがなとして比べます（イ=い）。
• 濁音・半濁音は清音と同じ扱いです（が=か、ぱ=は）。
• 小書き文字は大きい字と同じ扱いです（ゃ=や、っ=つ）。
• 長音「ー」は「あ」として比べます。「らあめん」と「らーめん」は同じキーです。
• キーが同じ項目は、元の並びのままです（安定ソート）。
• 漢字は読みに変換されず、コードポイント順で並びます（sort(["柿","梨","あ"], "kana") → ["あ","柿","梨"]）。
• 「ゐ」「ゑ」「ヴ」「ヵ」「ヶ」は読み替えの対象外です。「ヴ」は「う」と同じ扱いにならず、ひらがなの後ろに並びます（sort(["ヴ","う","え"], "kana") → ["う","え","ヴ"]）。

漢字まじりの項目を五十音順に並べる

漢字は読みに変換されないので、読みをキーにしたマップを作り、キーを "kana" で並べます。表示名は値に持たせます。

OnBoot => {
    // 読み → [表示名, 説明]
    let 一覧 = {
        "ふれいむ": ["フレイム", "炎を放つ魔法。"],
        "ばりあー": ["バリアー", "身を守る障壁を張る。"],
        "あいすばーぐ": ["アイスバーグ", "巨大な氷塊を呼び出す魔法。"]
    }
    let 読み = sort(keys(一覧), "kana")
    foreach 読み as i, よみ {
        湊: ${一覧[よみ][0]}
    }
}

アイスバーグ、バリアー、フレイムの順に表示されます。

OnBoot => {
    global save.履歴 ?= []
    global save.履歴 = push(save.履歴, "起動")
}

マップ

get は配列にも使えます（get(arr, 添字, default)）。範囲外の添字や負の添字でも警告を出さず、default を返します。 data["age"] のように直接参照すると、存在しないキーや範囲外の添字では通知や警告が出ます。

日付・時刻

存在しない日付（2026, 2, 30 など）を渡すと、どちらも null を返します。

OnBoot => {
    let days = days_since(2026, 1, 1)
    湊: 2026年1月1日から${days}日経ちました。
}

制御・ユーティリティ

log は、debug_log が有効なときだけ、ゴーストフォルダの minato_debug.log に [SCRIPT] メッセージ の形で書き込みます。 複数の値を渡すと , でつないで1行にします。無効なときは何もしません。

システム連携

saori の詳細はSAORI連携を参照してください。

get_property

SSPに、そのプロパティの値を問い合わせます（SSTPの GetProperty）。プロパティ名はSSPのドキュメントを見てください。

OnBoot => {
    let name = get_property("currentghost.name")
    湊: いまのゴーストは${name}です。
}

• 戻り値はいつも文字列です。SSPにつながらない、応答が遅い、そのプロパティがない、といった理由で取れなかったときは、空文字列 "" が返ります。エラーや警告にはなりません。
• 問い合わせのあいだ、湊は応答を待ちます。待つのは通常、長くても1回あたり1秒前後ですが、そのあいだSSPが固まったように見えることがあります。ランダムトークのたびに呼ぶような使い方は避けてください。

外部呼び出しは1イベント10回まで

get_property() と saori() は、合わせて1イベントあたり10回までしか呼べません。 SSPやSAORIの応答を待つあいだにSSP全体が止まるのを、ループで何度も繰り返さないための上限です。

11回目以降は実際には呼び出されず、get_property() は空文字列、saori() は空の配列を返します。

数はイベントごとに0に戻ります。トークの条件フィルタの中で呼んだ分も数えます。 ループの中で呼ぶ必要があるときは、ループの前に1回だけ呼んで、結果を let に入れて使ってください。

OnBoot => {
    // NG: 11回目から空になる
    for (let i = 0; i < 20; i++) {
        let r = saori("calc.dll", i)
    }

    // OK: 1回だけ呼んで使い回す
    let name = get_property("currentghost.name")
    for (let i = 0; i < 20; i++) {
        湊: ${name}
    }
}

型の判定

• 調べるのは今の値の型だけです。"42" のような数字の文字列は文字列なので、is_num("42") は false です。
• 未定義の変数は null になるので、is_null(save.未定義) は true、type_of(save.未定義) は "null" です。
• 引数を省略すると null を渡したのと同じ扱いになります。

JSONから読み込んだ値を使う前に確かめるときに便利です。

let data = json_parse(file_read("ghost/master/config.json"))
if (is_num(data.回数)) {
    湊: ${data.回数}回目です。
}

JSON

ファイル操作

書き込みできる場所の制限や使用例はファイルとJSONを参照してください。