コンテンツにスキップ

里々マニュアル

伺か(ukagaka)の SHIORI「里々(SATORI)」と、同梱の SAORI「ssu」の仕様書です。里々のソースコード(Unicode 版)から読み取れる動作をまとめています。

間違いやわかりにくいところを見つけたら、整備班BTS(報告フォーム)で教えてください。GitHub に慣れている方は、Issues や Pull Request でも構いません。

ダウンロード・ソース

はじめての方へ

  • 従来の里々(Mc1XX)から Unicode 版(Mc202-1)に移るときの、実質的な違いを知りたい → 里々 Unicode 版(Mc202-1)公開
  • 里々って何? → 里々とは
  • はじめてゴーストを作りたい → はじめてのゴースト
  • 動くサンプルのゴーストから始めたい → ポストと狛犬 V2(Unicode 版向けのテンプレート。バイブコーディング対応。Releases から nar を入手。バイブコーディングで書くなら、AI ツール向けの里々開発支援 ukagaka-satori-helper も参照)
  • 書き方をざっと確認したい → チートシート
  • ACP 版(Mc1XX)から Unicode 版(Mc2XX)に移りたい → ACP 版との違い(satori.dll を置き換えるだけで、辞書もセーブデータもそのまま動きます。気をつける点はセーブデータの文字コードなど数点だけです)

調べたいとき

ページ上部の検索窓からも探せます。


はじめに (startup/)

ファイル 内容
what-is-satori.md 里々とは
getting-started.md はじめてのゴースト
cheatsheet.md チートシート

文法 (grammar/)

ファイル 内容
01-dictionary-files.md 辞書ファイルと読み込み
02-talks-and-words.md 文と単語群
03-preprocess.md 前処理(エスケープ・コメント・置換)
04-script-lines.md 文の行の書き方
05-kakko.md ()の展開
06-variables.md 変数
07-expressions.md 式
08-flow-control.md 制御構造
09-choices.md 選択肢
10-speaker-and-surface.md スコープとサーフェス
11-auto-insert.md 自動挿入(ウェイト・改行・アンカー)
12-overlap-avoidance.md 重複回避
13-sakura-script.md さくらスクリプトの扱い
14-charset.md 文字コード
15-save-data.md セーブデータ

SHIORI としての動作 (shiori/)

ファイル 内容
protocol.md プロトコルとリクエスト処理
events.md イベントの処理
default-behaviors.md デフォルトの動作
satori-events.md 里々独自のイベントと文
random-talk.md ランダムトークとタイマ
communicate.md コミュニケート
notify.md NOTIFY の保存
debug.md ShioriEcho とデバッグ

システム変数・組み込み名 (system/)

ファイル 内容
index.md 概要
vars-talk.md 喋りとトーク予約
vars-script.md スクリプトへの付加
vars-surface.md サーフェス
vars-auto.md 自動挿入
vars-limits.md 制限値
vars-mouse.md マウス反応
vars-save.md セーブ・辞書・タイマ・重複回避
vars-debug.md ログ・デバッグ
vars-misc.md その他
names-refs.md 引数・参照値の名前(R・A・S・H・C)
names-time.md 時刻・経過時間・乱数
names-state.md 状態・存在確認

()内蔵関数 (functions/)

一覧は functions/index.md にあります。

種類 関数
変数・呼び出し set call vncall loop equal nop sync remember 変数の一括削除 変数の一括コピー 変数の列挙 split_to
特殊形式 when whenlist times while for
単語・文字 バイト値 合成単語群 文の数 単語の追加 追加単語の削除 追加単語の全削除
本体との連携 get_property set_property load_saori

ssu(同梱 SAORI) (ssu/)

一覧は ssu/index.md にあります。

種類 関数
計算 calc calc_float
条件分岐 if unless nswitch switch iflist
文字列 substr at split split_string join reverse replace replace_first erase erase_first count
正規表現 書き方 regex_match regex_find regex_findall regex_count regex_replace regex_replace_first regex_erase regex_erase_first regex_split regex_escape
比較・判定 compare compare_case compare_head compare_head_case compare_tail compare_tail_case length is_empty is_digit is_alpha
変換 zen2han han2zen hira2kata kata2hira sprintf
その他 choice lsimg mkdir

その他 (other/)

ファイル 内容
satori2-launch.md 里々 Unicode 版(Mc202-1)公開
saori.md SAORI の呼び出し
unicode-changes.md ACP 版との違い
error-messages.md エラーメッセージ・警告