里々マニュアル¶
伺か(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を置き換えるだけで、辞書もセーブデータもそのまま動きます。気をつける点はセーブデータの文字コードなど数点だけです)
調べたいとき¶
- 辞書の書き方を知りたい → 文法
- イベントの動作を知りたい → SHIORI としての動作
- システム変数を調べたい → システム変数
()の中で使える関数を調べたい → ()内蔵関数、ssu の関数- エラーメッセージを調べたい → エラーメッセージ・警告
ページ上部の検索窓からも探せます。
はじめに (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 にあります。
その他 (other/)¶
| ファイル | 内容 |
|---|---|
| satori2-launch.md | 里々 Unicode 版(Mc202-1)公開 |
| saori.md | SAORI の呼び出し |
| unicode-changes.md | ACP 版との違い |
| error-messages.md | エラーメッセージ・警告 |