YAYA マニュアル¶
伺か(ukagaka)の SHIORI「YAYA」の使い方と仕様をまとめたマニュアルです。YAYA と、その前身である AYA に関する情報や Tips も集めています。
プログラミングをしたことがない方にもわかるように書くことを目指しています。わかりにくいところや間違いを見つけたら、整備班BTS(報告フォーム)で気軽に教えてください。GitHub に慣れている方は、Issues や Pull Request でも構いません。
ダウンロード¶
YAYA v6 (通称Tc600系)¶
- steve green氏の開発ブランチを取り込み、互換性を調整し、大幅強化版としてリリースしたものです。
- 変数の柔軟性、高速ヘッダ解析、XML/JSONなどのパーサ、DB(SQLite)など、500系と高い互換性を保ちながら大幅な改修が行われています。
- まずはざっくり知りたい → YAYA 6 登場
- YAYA Tc5xx-x から Tc6xx-x (v5系からv6系) に移行したい →600 での変更点(
yaya.dllを置き換えるだけで、辞書もセーブファイルもそのまま動きます。気をつける点は関数名の衝突など数点だけです)
はじめての方へ¶
- YAYA や AYA って何? → YAYAについて
- YAYA の書き方をざっと確認したい → チートシート
- はじめてゴーストを作りたいんだけど? → ゴーストの作り方
- AYA でゴーストを作っていたけど、YAYA に移りたい → AYAからの移行
- 里々から YAYA に移りたい → 里々からの移行
調べたいとき¶
- プログラミングをしたことがない! → 基本
- YAYA の文法を知りたい → 文法、チートシート
- どんな組み込み(システム)関数があるの? → 用途別の関数一覧
- 関数を名前から探したい → システム関数一覧
- エラーを調べたい・処理したい → エラー処理関数
ページ上部の検索窓からも探せます。
システム辞書・テンプレート¶
- システム辞書について → yaya_shiori3.dic、yaya_optional.dic
- テンプレートゴーストについて → ゴーストの作り方、シンプルなYAYAテンプレート
- トークを手軽に書きたい → talklib
- SHIORI 以外の使い方 → SAORIとしてのYAYA、MAKOTOとしてのYAYA、プラグインとしてのYAYA
困ったとき¶
- いろいろなノウハウを知りたい → Tips
- 作っていて困ったことがあったら → トラブルシューティング
- それでも解決しないときや、YAYA の不具合らしいときは → 整備班BTS(報告フォーム)で聞いてみましょう。GitHub に慣れている方は、yaya-shiori の Issues や Pull Request でも構いません
- 開発情報検索 で検索すると、答えが見つかるかもしれません
関連ツール¶
- 紺野ややめ — YAYA のテンプレートゴースト
- 玉(tama) — 辞書のエラーチェックやデバッグに使うツール
- yaya-CI-check — GitHub Actions で辞書を検査する CI ツール
- ukagaka-doc-mcp - AIによる開発で伺か関連の仕様を勝手に探してもらうためのツール
文法 (grammar/)¶
| ファイル | 内容 |
|---|---|
| 01-basic-settings.md | 基本設定 |
| 02-functions.md | 関数 |
| 03-values-and-variables.md | 値と変数 |
| 04-arithmetic.md | 算術演算 |
| 05-arrays.md | 配列 |
| 06-string-embedding.md | 文字列埋め込み |
| 07-flow-control.md | フロー制御 |
| 08-preprocessor.md | プリプロセッサ |
| 09-reserved-words.md | 予約語 |
| 10-yaya-as-windows-dll.md | Windows DLLとしてのYAYA |
| 11-character-encoding.md | 文字コード |
| 12-hash.md | ハッシュ(Tc600-3以降) |
| 13-nesting.md | 値の入れ子と多次元代入(Tc600-3以降) |
基本 (basic/)¶
| ファイル | 内容 |
|---|---|
| variables.md | 変数 |
| functions.md | 関数 |
| branching.md | 条件分岐 |
| loops.md | ループ |
| arrays.md | 配列 |
| operators.md | 演算子 |
システム辞書 (system/)¶
| ファイル | 内容 |
|---|---|
| yaya-shiori3-dic.md | yaya_shiori3.dic |
| yaya-optional-dic.md | yaya_optional.dic |
| system-functions-index.md | システム関数一覧 |
| error-handling-functions.md | エラー処理関数 |
| shiori-OnCallLimit.md | OnCallLimit |
| shiori-OnLoopLimit.md | OnLoopLimit |
| shiori-OnMemoryError.md | OnMemoryError |
| shiori-OnMemoryLimit.md | OnMemoryLimit |
StartUp / チュートリアル (startup/)¶
| ファイル | 内容 |
|---|---|
| cheatsheet.md | チートシート |
| creating-ghost.md | ゴーストの作り方 |
| tutorial-01-preparation.md | チュートリアル1: 準備 |
| tutorial-02-writing-dialogue.md | チュートリアル2: セリフを書く |
| tutorial-03-variables.md | チュートリアル3: 変数 |
| migration-from-aya.md | AYAからの移行 |
| migration-from-satolili.md | 里々からの移行 |
その他 (other/)¶
| ファイル | 内容 |
|---|---|
| yaya.md | YAYAについて |
| yaya-as-saori.md | SAORIとしてのYAYA |
| yaya-as-makoto.md | MAKOTOとしてのYAYA |
| yaya-as-plugin.md | プラグインとしてのYAYA |
| saori-usage.md | SAORIの使い方 |
| talklib.md | talklib |
| simple-yaya-template.md | シンプルなYAYAテンプレート |
| troubleshooting.md | トラブルシューティング |
| lint-functions.md | LINT系関数の仕様と制約 |
| changes-600.md | 600 での変更点(Tc600-3以降) |
| yaya6-launch.md | YAYA 6 登場(600 系の紹介) |
システム関数(組み込み関数) (functions/)¶
型取得/変換¶
配列操作¶
| ファイル | 関数 |
|---|---|
| ARRAYSIZE.md | ARRAYSIZE |
| ARRAYDEDUP.md | ARRAYDEDUP |
| ASEARCH.md | ASEARCH |
| ASEARCHEX.md | ASEARCHEX |
| ASORT.md | ASORT |
| SETDELIM.md | SETDELIM |
| GETDELIM.md | GETDELIM |
| IARRAY.md | IARRAY |
ハッシュ操作¶
| ファイル | 関数 |
|---|---|
| IHASH.md | IHASH |
| HASH_KEYS.md | HASH_KEYS |
| HASH_VALUES.md | HASH_VALUES |
| HASH_SPLIT.md | HASH_SPLIT |
| HASH_EXIST.md | HASH_EXIST |
| HASH_SIZE.md | HASH_SIZE |
文字列操作¶
正規表現¶
数学関数¶
ビット演算¶
| ファイル | 関数 |
|---|---|
| BITWISE_AND.md | BITWISE_AND |
| BITWISE_OR.md | BITWISE_OR |
| BITWISE_XOR.md | BITWISE_XOR |
| BITWISE_NOT.md | BITWISE_NOT |
| BITWISE_SHIFT.md | BITWISE_SHIFT |
ファイル操作¶
データベース¶
| ファイル | 関数 |
|---|---|
| SQLOPEN.md | SQLOPEN |
| SQLCLOSE.md | SQLCLOSE |
| SQLEXEC.md | SQLEXEC |
| SQLQUERY.md | SQLQUERY |
外部ライブラリ¶
| ファイル | 関数 |
|---|---|
| LOADLIB.md | LOADLIB |
| UNLOADLIB.md | UNLOADLIB |
| REQUESTLIB.md | REQUESTLIB |
| FUNCTIONEX.md | FUNCTIONEX |
| CHARSETLIB.md | CHARSETLIB |
| CHARSETLIBEX.md | CHARSETLIBEX |
システム情報¶
| ファイル | 関数 |
|---|---|
| GETTIME.md | GETTIME |
| GETTIMEZONE.md | GETTIMEZONE |
| GETTICKCOUNT.md | GETTICKCOUNT |
| GETSECCOUNT.md | GETSECCOUNT |
| GETMEMINFO.md | GETMEMINFO |
| GETENV.md | GETENV |
| READFMO.md | READFMO |
メタ操作・特殊関数¶
通信・プロセス間通信¶
| ファイル | 関数 |
|---|---|
| DIRECTSSTP.md | DIRECTSSTP |