KaedeRPG リファレンス#

この説明書は KaedeRPG 0.1.0（2026-10-21）のものです。

Unreal Engine の中で、2D の RPG とノベルゲームを作るプラグイン KaedeRPG の、エディタの全タブ・全項目の説明です。

• 買ってから見本のゲームを書き出すまでの手順は、導入ガイドにあります。初めての人はそちらから読んでください。
• English

目次#

1. このリファレンスの読み方
2. 作品フォルダ
3. エディタの画面
4. マップのタブ
5. イベントのタブと命令
6. 物語のタブ
7. データベースのタブ
8. キャラと素材のタブ
9. 変数のタブ
10. 画面のタブ
11. 検査のタブ（詰まない検査）
12. ゲームの操作（プレイヤー向け）
13. 生成 AI と一緒に作る
14. CLI（kaede-rpg.exe）
15. サーバーの機能（クラウドセーブ・記録の順位・遠隔の値・お知らせ）
16. まだできないこと
17. 同梱物の権利

1. このリファレンスの読み方#

エディタで見ている欄の名前から、その欄に何を書くか・取りうる値・書かないときの値を引くための文書です。

• 並び: 章はエディタのタブの並び（左から: マップ・イベント・物語・データベース・キャラと素材・変数・画面・検査＝§4〜§11）で、タブの中は副タブの並び（左から）、副タブの中は項目の表です。項目の表は、エディタの欄の並び（定義表の順）です。そのあとに、ゲームの操作・生成 AI・CLI・サーバーの機能などの章が続きます。
• 項目の表の列:

• 1 つの副タブで複数のまとまり（例: マップの設定と、その中の雰囲気）を使うときは、まとまりごとに太字の小見出しと表があります。小見出しの括弧の中は、そのまとまりの名前（JSON Schema の $defs の名前・CLI の schema の出力と同じ）です。
• 項目の表は、ツールの定義表から作っています（手で書いた表ではありません）。エディタの欄の名前と表の「項目」は同じです。

2. 作品フォルダ#

新しく作る: ツールの 新規… を押すと窓が開き、始め方と作品フォルダを選んで 作る を押します。

• 始め方: 見本から始める（おすすめ） が既定です。見本「ねずみ退治」のマップ・タイルセット・データベース・素材・物語が写され、すぐ遊べます（題名と id は作品フォルダの名前になり、セーブは見本と別になります）。題名・マップ・会話を自分の作品に直していきます。空から始める（上級） は、マップもタイルセットも仲間も無い作品です（タイルセットの画像・マップ・開始位置を自分で用意します）。
• 作品フォルダ: 既定は <プロジェクト>/Works/my_game（もうあれば my_game_2 …）。欄で名前を直せ、置き場を選ぶ… で場所を変えられます。作品フォルダはプロジェクトの中に置いてください（書き出すときに同梱するため）。外を選ぶと、窓にその場で知らせが出ます。

どちらでも、rpg.json・登録簿と AI 用のファイル（CLAUDE.md・AGENTS.md・.claude/。生成 AI と作るとき〔§13〕に AI が読むファイルで、触らなくてかまいません）ができます。

使える素材: 画像は PNG、音は OGG と WAV。タイルは 48×48px。

作品の中を探す: 台詞の一部・名前・変数の名前・id が作品のどこにあるかは、上の段の 探す の欄（§3）か CLI の search（§14）で探します。探すのは上の表の JSON（マップ・テンプレート・コモン・物語・データベース・変数・キャラ・素材・タイルセット・rpg.json など）と story/ の .ks で、英字の大文字小文字は区別しません。画面（ui/）・テーマ（themes/）・文言の表（strings/）は探しません。置き換え（一括の変更）はできません。

作品の言語: rpg.json の language（ja／en。書かなければ ja）で、ゲームの画面の決まった文言（メニューの「所持品」「技」・タイトルの「はじめから」・戦闘の「〜の攻撃！」・「〜を手に入れた」・セーブの文など）の言語が決まります。知らない値は検査の F-LANG-01（error）です。

• 文言は製品の表 Resources/Rpg/strings/ja.json・en.json（{"鍵": "文"}）にあります。鍵は画面の文言が t_<画面>_<意味>（t_menu_help）、共通が t_<意味>（t_close・t_items）、ゲームの文が m_<意味>（m_drop＝「{item}を手に入れた」）。{item} のような差し込みはそのまま残して訳します。
• 作品の strings/<言語>.json に同じ鍵を書くと、その鍵だけ製品の文を上書きします（例 {"t_close": "Done"}）。製品の表に無い鍵（綴り違い）は検査の R-STR-01（warning）です。
• 作品が書いたもの（台詞・名前・アイテムの説明）と、検査の文は替わりません。エディタの「新しい作品」は、UE の言語が日本語でなければ en で作ります。後から替えるには、データベースのタブの作品の設定の ゲームの画面の言語 で選びます（CLI なら new --language en）。

3. エディタの画面#

タブの中は、区切りごとに青い小見出し（「マップの一覧」「選んだマップの設定」「タイル」「命令」「選んだ命令の項目」など）が付いています。

色のテーマ: このツールの窓は UE のエディタのテーマと同じ色で表示されます。このプラグインは UE 用のテーマを 2 つ（Kaede Dark・Kaede Light）同梱しています。この説明書の絵は全部 Kaede Dark です。

• 上の段の テーマ の欄で選びます。UE の 編集 → エディタの環境設定 → 全般 → 外観 → テーマ と同じ設定で、UE 全体の色が替わります（UE 標準の「Dark」なども選べます）。

• ツールを初めて開いたとき、2 つのテーマを UE のユーザーのテーマのフォルダ（%LOCALAPPDATA%\UnrealEngine\Slate\Themes）に入れます。入れるだけで、選んでいるテーマは替えません。

• テーマの色は、エディタの環境設定でさらに直せます（直したものは上書きしません）。

• 入力欄: 名前が赤い欄は、必須なのに入っていない項目です。欄を空にすると、その項目は無くなります。選ぶ欄（キャラ・アイテム・素材など）は、作品にあるものだけが並びます。

• 一覧の欄は表で直す: 覚える技・行動・特徴・落とす物・品物などの一覧は表で出ます。1 行が 1 件で、各セルを直接直します。行の右の 消す で 1 件消し、下の ＋ 足す で空の行を足します（必須の欄は赤で知らせます）。JSON で書きたいときは JSON で直す を開くと、前と同じ 1 行の欄があります。

• 探す: 上の段の 探す の欄に文字（台詞の一部・名前・変数の名前・id）を入れて Enter を押すと、作品全体から探し、上の段の下に結果の一覧が出ます（「「長老」 13 件」）。1 行が 1 件で、場所（map:village/event:elder など。検査のタブと同じ書き方）・項目の名前・前後の文が並びます。行をダブルクリックすると、その場所のタブが開きます（台詞ならイベントのタブのその命令・アイテムならデータベースのタブのその行）。まだ保存していない変更も探せます（.ks の話は保存したファイルの行）。閉じる で一覧を消します。探す範囲は §2 の「作品の中を探す」。

• 元に戻すは 100 回まで。どのタブの変更も同じ履歴に入ります。

• 外での書き換え: AI や CLI、Git がファイルを書き換えると、未保存の変更が無ければ自動で読み直します。未保存があれば、上に「読み直す（変更を捨てる）」が出ます。

• 保存するたびに検査が走り、件数が上に出ます。

4. マップのタブ#

並びは昔ながらの RPG 制作ツールと同じです。

4.1 タイル#

道具（タイルのとき）

全部の層をそのまま描きます。いま塗っている層は、道具の行の 下／中／上 で分かります。

オートタイル: タイルの選び場の下の「オートタイル」の欄（A0 A1 …）から選んで塗ると、草・道・水・壁などの縁が、隣のマスに合わせて自動でつながります。形は塗ったあとも周りに合わせて描き直されるので、縁のタイルを 1 枚ずつ選ぶ必要はありません。水のようにコマのあるものはゲームで揺れます（エディタでは 1 コマ目）。オートタイルの絵の作り方は、下の「キャラと素材」のタイルセットを見てください。

タイトルとゲームオーバーの絵: データベースの 作品の設定 の タイトルの背景の絵・ゲームオーバーの絵 に背景の素材を選ぶと、画面いっぱいに出ます。

戦闘の背景: 「選んだマップの設定」の 戦闘の背景 に、床（下に描く）と壁（上に重ねる）の 2 枚の背景の素材を選びます。そのマップで始まる戦闘（エンカウントもイベントの戦闘も）の後ろに出ます。ボスなど、その敵の組だけ別の背景にするときは、データベースの 敵の組 の 戦闘の背景（床）・（壁） に書きます（マップより先に使います）。見本では、洞窟に洞窟の背景を入れてあります。

雰囲気（右の「選んだマップの設定」の「雰囲気」で 作る を押すと出ます）: 暗さ（0〜1。1 で真っ暗）・プレイヤーの明かりの半径・霧（濃さ・色・流れる速さ）・天候（雨・雪と強さ）・遠景（マップの下に重ねる絵。カメラに付いてくる割合と流れる速さ）・前景（キャラの上の絵）。暗いマップでは、プレイヤーの明かりと、イベントのページの 明かり の中だけが見えます。命令 weather・atmosphere で途中で変えられます（そのマップにいる間だけ）。

ピクチャ: マップ（雰囲気・前景を含む）の上、会話の窓とマップの HUD の下に、命令 picture で番号つきの絵（地図・手紙・一枚絵など）を出せます（§5 の「ピクチャの命令」）。マップを移っても消えず、戦闘の画面の間は描きません。

影: マップの shadows（マスごとの 0〜15。1 左上・2 右上・4 左下・8 右下の 4 分の 1 マスに影）を書くと、壁や建物の下に影が出ます（エディタで塗る道具はまだありません。JSON か CLI の set で書きます）。

maps/<id>.json（file:map）

戦闘の背景（床・壁）（battle_back）

雰囲気（暗さ・霧・天候・遠景・前景）（atmosphere）

霧（fog）

天候（weather）

遠景（下から重ねる）（layer）

層（layers）

4.2 通行#

通行: マスをクリックするたびに、そのマスの通行が「タイルどおり → ×（通れない）→ ○（通れる）」と替わります。タイルそのものの通行（木・水・岩は通れないなど）は、キャラと素材のタブのタイルセットで決めます。

4.3 イベント#

イベント: 空きマスをダブルクリックで新しいイベント、イベントをドラッグで移動、イベントをダブルクリックでイベントのタブへ。マスを右クリックすると:

• ここにイベントを足す／イベントを開く／複製／消す
• ここをプレイヤーの開始位置に（緑の S）
• ここからテストプレイ

「イベント」（event）の項目は §5.1 の表。

4.4 リージョン#

リージョン: マップの上の リージョン を押し、左上の番号の表（1〜255）から番号を選んで塗ると、マスに番号が付きます（番号ごとの色と数字で見えます。色は 8 色の繰り返し。道具の行の数の欄でも選べます。「消す」で 0 に戻します）。番号は、ランダムエンカウントの出る範囲と、命令の条件式の region（プレイヤーのいるマスの番号。例 region == 2）に使います。

ここから下は、欄に項目の名前（英語の語）と値を書いて決める設定です。使わなくても、マップは作れて遊べます。

床の効果: 右の「選んだマップの設定」（マップの設定 で出します）の 床の効果 に、リージョンの番号ごとに、1 歩ごとのダメージ（damage。HP 1 は残る・画面が赤く光る）・滑る床（slip。向いた方へ止まるまで進む）・エンカウントの率（encounterRate。0 で出ない）を書きます。見本では、洞窟の右奥が滑る床、右下の隅がダメージ床です。

ランダムエンカウント: 右の「選んだマップの設定」の ランダムエンカウント に、平均の歩数（steps）と出る敵の組（list: 敵の組・重み・出るリージョン）を書きます。歩数を 12 にすると、およそ 12 歩に 1 回戦闘になります。リージョンを書いた行は、その番号のマスでだけ出ます。エンカウントの戦闘は逃げられ、負けるとゲームオーバーです。イベントの命令 エンカウント（encounter）で止めたり戻したりできます。

maps/<id>.json（file:map）

床の効果（リージョンの番号 → 効果）（region_effect）

ランダムエンカウント（encounters）

出る敵の組（encounter_entry）

5. イベントのタブと命令#

5.1 マップのイベント#

• 左: いまのマップのイベントの一覧（マップはマップのタブで選びます）。上の切り替えで コモンイベント。
• 中の上: イベントの id・名前・位置。
• ページ: 1・2・3 … のタブ。＋（足す）・複製・← →（並べ替え）・消す。後ろのページから見て、出現条件を満たす最初のページが使われます。たとえば見本の長老は 3 ページで、1 ページ目「条件なし（頼む前）」・2 ページ目「頼みを受けた（quest_accepted が true）」・3 ページ目「ねずみの王を倒した（boss_defeated が true）」です。話が進むほど後ろのページの条件が満たされ、そちらが使われます。
• ページの設定:

• 下が命令の木。左上の種類を選んで ＋ 足す（選んだ命令の後ろへ。見出し〔「成り立つとき」など〕を選ぶとその中へ）、↑↓ で並べ替え、消す。選んだ命令の項目は右の欄で直します。

テンプレートイベント: 同じ中身のイベント（村人・看板・宝箱など）を何か所にも置くときは、1 つ作ってイベントのタブの テンプレートにする を押します（ページが templates/<id>.json に移ります）。あとはマップを右クリック →「テンプレート「…」を置く」で置けます。テンプレートを直すと、置いたイベント全部に効きます（イベントのタブの テンプレートを開く）。置いたイベントごとに、見た目（look）だけ上書きできます。

イベント（event）

templates/<id>.json（file:template）

ページ（テンプレートを使うなら書かない）（page）

出現条件（condition）

明かり（暗いマップで見える）（light）

見た目の上書き（テンプレートのページ全部）（look）

自律移動（move）

5.2 コモンイベント#

左の上の切り替えで コモンイベント にすると、作品のコモンイベント（common/<id>.json）の一覧になります。コモンイベントはページを持たない命令の列で、イベント・物語・ほかのコモンイベントから命令 call_common で呼びます。命令の木の使い方は §5.1 と同じです。

5.3 命令（60 種）#

命令の種類

文中の差し込み（text の本文・chatter）: {var:名前}（変数の値）・{item:id}（アイテムの名前）・{actor:id}（仲間の名前）・{gold}（お金）・{currency}（お金の単位）。{color:#ff4040}赤い字{/color} で本文の一部に色を付けます。知らない名前はそのまま出ます（検査 R-TEXT-01 が知らせます）。

条件式（if・選択肢の条件）: met_elder == true・gold >= 100・item.herb >= 1・self.done などを &&（かつ）・||（または）・!（でない）でつなぎます。比べ方は == != >= <= > <。変数は変数のタブで登録した名前です（gold・item.<id>・party.・actor.・region（プレイヤーのいるマスのリージョン）・quest.<id>.state・quest.<id>.ready は登録なしで使えます）。

入力の命令: 遊ぶ人に入れさせた結果を変数に入れます。変数は先に変数のタブで登録し、型を合わせます（合わないと検査 R-INP-01）。

名前に使える字の制限はありません（改行だけ除きます）。input_item は選んだアイテムを減らしません（渡すなら、続けて item の命令で減らします）。結果は {var:hero_name} のように文中で使います。

ピクチャの命令: 地図・手紙・一枚絵・自作の目盛りなどを、番号（1〜20）つきの絵として画面に出し、動かし、消します。座標は画面の 1280×720 の論理座標（画面の JSON と同じ。窓の大きさが変わっても同じ所）。番号の大きいものが上に重なります。

• 出したピクチャは、マップを移っても消えません（消すまで残ります）。セーブに入り、ロードで同じ位置・同じ濃さに戻ります（動いている途中なら続きから）。
• 戦闘の画面の間は描きません（戦闘が終わるとまた出ます）。
• 薄く出して濃くする: picture（opacity 0）→ picture_move（opacity 1・durationMs 400・wait）。見本の長老の机（王を倒したあと）がこの形です。
• w h を 0（絵の大きさ）のまま picture_move で w だけ書くと、0 から伸びるように見えます。大きさを動かすなら、先に picture で w h を書きます。
• 検査: 出していない番号を picture_move すると R-PIC-01（warn。作品のどこにもその番号の picture が無い）。無い素材は R-REF-01、種類の違う素材は R-REF-02。
• KS では @picture 1 pic_letter x=640 y=340 origin=center・@picture_move 1 opacity=1 durationMs=400 wait=true・@picture_clear no=1 と書きます。

命令ごとの項目は下の表です（並びはエディタの命令の種類の並び）。

text（会話）#

会話の窓を 1 つ出し、遊ぶ人が決定キーを押すまで待ちます。窓の形を balloon にすると、画面の下の窓の代わりに相手の頭の上のフキダシで出します。

text_clear（会話）#

会話の窓の文・話す人・顔を消します。

項目なし。

text_style（会話）#

これより後の会話の窓の色と名前の色を変えます。書かなかった色は元（画面とテーマの色）に戻ります。

choice（会話）#

選択肢を出して遊ぶ人に選ばせ、選んだ選択肢の命令を実行します。条件で 1 つも出ないときは、何も出さずに次の命令へ進みます。

選択肢（choice_option）

if（流れ）#

条件式が成り立つかどうかで、実行する命令の並びを分けます。

set_var（変数）#

変数に値を入れる・足す・引く命令です。変数は条件式・文中の差し込み・ページの出現条件で使えます。

set_self（変数）#

このイベントだけが持つフラグ（自分のフラグ）に値を入れます。ページの出現条件や条件式の self.名前 で見ます。

call_common（流れ）#

コモンイベントの命令を実行し、終わったらこの命令の次へ戻ります。

call_story（流れ）#

物語の話を実行し、終わったらこの命令の次へ戻ります。長い会話や、立ち絵・背景を使う場面に使います。

jump（流れ）#

同じイベント（または同じ話）の中の label の位置へ飛びます。

label（流れ）#

jump の行き先になる目印を置きます。label 自体は何もしません。

end_event（流れ）#

ここで命令の並びを終えます。call_common・call_story で呼ばれた中なら、呼んだ側の次の命令へ戻ります。

項目なし。

wait（流れ）#

決めた時間だけ待ってから次の命令へ進みます。

bg（ノベルの見た目）#

会話の背景の絵を出します（いまの背景と入れ替わります）。

bg_clear（ノベルの見た目）#

会話の背景の絵を消します。

ch（ノベルの見た目）#

キャラの立ち絵を、表情と位置（左・中央・右）を決めて出します。同じキャラが出ていれば置き換えます。

ch_hide（ノベルの見た目）#

1 人のキャラの立ち絵を消します。

ch_clear（ノベルの見た目）#

出ている立ち絵を全部消します。

ch_expr（ノベルの見た目）#

出ている立ち絵の表情を替えます。出ていないキャラには何もしません。

ch_move（ノベルの見た目）#

出ている立ち絵を別の位置（左・中央・右）へ時間をかけて動かします。動いている間も次の命令へ進みます。RPG のゲームの画面には描かれません（§16）。

effect（演出）#

画面の揺れ・光・暗転・白く飛ばす・暗転や白から戻す、の演出をします。演出が終わるまで次の命令へ進みません。RPG のゲームの画面では、揺れと光は時間だけ待ち、暗転・白への溶暗は時間が過ぎてから一度に替わります（§16）。

filter（演出）#

画面全体に色のフィルタ（モノクロ・セピアなど）をかけます。フィルタを空か none にすると外します。RPG のゲームの画面には描かれません（§16）。

transition（演出）#

KaedeVN のトランジション（TRANSITION）を始めます。終わるのを待たずに次の命令へ進みます。RPG のゲームの画面には描かれません（§16）。

mask（演出）#

画面全体を 1 色で覆います。mask_clear まで覆ったままです。RPG のゲームの画面には描かれません（§16）。

mask_clear（演出）#

mask で覆った色を外します。RPG のゲームの画面には描かれません（§16）。

picture（ピクチャ）#

番号（1〜20）つきの絵を画面に出します。同じ番号は置き換え、番号の大きいものが上に重なります。マップを移っても消えず、セーブに入ります。

picture_move（ピクチャ）#

出ているピクチャの位置・大きさ・不透明度を、書いた項目だけ時間をかけて変えます。

picture_clear（ピクチャ）#

ピクチャを 1 枚、または全部消します。

bgm（音）#

BGM を流します（いま流れている BGM と入れ替わります）。

bgm_stop（音）#

流れている BGM を止めます。

se（音）#

効果音を 1 回鳴らします。

se_stop（音）#

鳴っている効果音を止めます。

項目なし。

voice（音）#

ボイスを 1 回鳴らします。

transfer（移動）#

プレイヤーを別のマップ（または同じマップの別のマス）へ移します。移ると、命令で変えた天候・暗さとカメラは元に戻ります。

move_route（移動）#

プレイヤーかイベントを、手の列のとおりに動かします（歩く・向く・待つなど）。

erase_event（移動）#

この命令を実行しているイベントをマップから消します。消えるのは、プレイヤーがそのマップに入り直すまでです。

項目なし。

animation（演出）#

アニメ（素材）をプレイヤーかイベントの上で再生します。アニメに効果音があれば一緒に鳴ります。

quest（クエスト・記録）#

データベースのクエストを受ける・達成する・失敗にする・目標を満たしていれば達成する、を指示します。達成すると報酬が配られ、画面の上にお知らせが出ます。

encounter（戦闘など）#

ランダムエンカウントを止めたり戻したりします。セーブに入ります。

weather（演出）#

いまのマップの天候（雨・雪）と強さを変えます。マップにいる間だけ効き、マップを移ると元に戻ります。

atmosphere（演出）#

いまのマップの暗さを変えます。マップにいる間だけ効き、マップを移ると元に戻ります。

chatter（会話）#

止まらない会話です。プレイヤーを止めずに、誰かの上へ短い文を数秒出します。

camera（演出）#

カメラのズームの倍率を変え、プレイヤー・イベント・マスへ寄せます。マップを移ると元に戻ります。

camera_reset（演出）#

カメラを元（倍率 1・プレイヤーに付いていく）に戻します。

credits（戦闘など）#

作品フォルダの credits.txt を流す画面を開きます。閉じると次の命令へ進みます。

項目なし。

item（物）#

アイテムを増やすか減らします。0 より少なくはなりません。

gold（物）#

お金を増やすか減らします。0 より少なくはなりません。

party（物）#

仲間をパーティに加えるか外します。もう入っている仲間を加える・入っていない仲間を外すときは何も変わりません。

recover_all（物）#

HP と MP を最大にし、状態（戦闘不能を含む）を消します。

battle（戦闘など）#

敵の組と戦闘を始めます。勝った・負けた・逃げたときの命令をそれぞれ書けます。敵の組が無いなどで始められないときは、逃げたことにして進みます。

craft_screen（戦闘など）#

合成の画面を開きます。作業台などに置きます。閉じると次の命令へ進みます。

shop（戦闘など）#

店の画面を開き、品物を買えるようにします。閉じると次の命令へ進みます。

品物（shop_good）

record（クエスト・記録）#

値の式を計算して、cloud.json の記録（順位）へ送ります。Steam で出すゲームでは Steam へ送ります。待たずに次の命令へ進みます。

achievement（クエスト・記録）#

実績を取ります。まだ取っていないときだけ取り、Steam で出すゲームでは Steam へ送ります。待たずに次の命令へ進みます。

input_name（入力）#

名前を打たせる画面を開き、結果を文字の変数に入れます。取消すると最初の名前のまま進みます。

input_number（入力）#

数を桁ごとに選ばせる画面（暗証番号など）を開き、結果を数の変数に入れます。取消はできません。

input_item（入力）#

持っているアイテムを 1 つ選ばせ、その id を文字の変数に入れます。取消すると空の id が入ります。選んだアイテムは減らしません（渡すなら続けて item の命令で減らします）。

save_screen（戦闘など）#

セーブの画面を開き、閉じるまで待ちます。ここで保存したセーブをロードすると、この命令の次から続きます。

項目なし。

game_over（戦闘など）#

ゲームオーバーにします。後ろの命令は実行しません。

項目なし。

return_title（戦闘など）#

タイトルの画面へ戻ります。後ろの命令は実行しません。

項目なし。

6. 物語のタブ#

会話中心の場面（オープニング・エンディング・回想など）は「物語の話」にまとめ、イベントから call_story で呼びます。使い分けは、長い会話や、立ち絵・背景を使う場面は物語へ、短いひと言（村人のあいさつなど）はイベントへ、です。

• 左: 話の一覧。行の右の KS／JSON は、その話のファイルの形です（§6.1）。足すときは 章/話（例 01_main/01_opening）と書いて 足す。KS で書く に印を付けて足すと、.ks のファイルで作ります（付けなければ .json）。
• 一覧の行を右クリック → KS にする／JSON にする: ファイルの形を切り替えます。中身と、ほかの場所からの参照（call_story など）は変わりません。切り替えるとすぐ保存されます（新しい形で書いてから古いファイルを消す。ほかの未保存の変更も先に保存され、保存できないときは切り替えません）。Undo では戻らないので、戻すときはもう一度切り替えてください。
• 右上: 名前と エンディング（ゲームの終わり） の印。最後の話には印を付けてください（検査が「エンディングがどこからも呼ばれていない」を見つけられます）。
• 下: 命令の木（イベントと同じ部品）。.ks の話も木で直せ、保存すると .ks に書かれます。木の上の KS で直す で、同じ話をテキストで直せます（下の「KS で直す」）。

KS で直す: 押すと、木の上に話の KS（§6.1 の書き方・整った形）が複数行の欄で出ます。欄で直して 反映（または Ctrl+Enter）を押すと、欄の KS で話をまるごと置き換え、命令の木を作り直します。

• 読めない行があるときは、話を変えずに、欄の下に「3 行目: …（F-KS-02）」のように行番号つきで出します。直してもう一度 反映 してください。欄の直しは消えません。
• 反映 は 1 回の Undo（Ctrl+Z）で戻せます。反映しただけではファイルに書かれません（保存で書かれる）。
• 木から読み直す は、反映していない欄の直しを捨てて、今の木の KS に戻します。木で命令を足したり、外（AI・CLI）でファイルが書き換わったりしたときは、欄を直していなければ自動で今の中身に書き直します。
• .json の話にも使えます（欄は KS で出ますが、ファイルの形は .json のまま）。
• 欄の色づけ・補完はありません。長い話を書くときは、外のテキストエディタで .ks を直してください（エディタは 1 秒ごとに .ks の書き換えも見て読み直します。未保存の変更があるときは上に知らせが出ます）。
• 必須の項目が空の命令（足したばかりの wait の時間など）があると、KS に書けないので欄に出せず、.ks の話は保存もできません（何も書かずに「KS に書けない: … 必須の ms が無い」と出ます）。項目を埋めてください。

始まりの話の作り方: 開始のマップにイベントを置き、1 ページ目を「条件なし・自動」にして call_story と set_self（例 done を true）、2 ページ目を「自分のフラグ done が true」で見た目なしにします。

6.1 話をテキスト（KS）で書く#

長い会話は、命令の木で 1 つずつ足すより、テキストで書くほうが早いことがあります。話は story/<章>/<話>.ks に KS（同梱のノベルゲームエンジン KaedeVN の @命令 の書き方）で書けます。.ks と .json はどちらで持っても同じ話で、エディタの木でも CLI でも同じように直せます（1 つの話はどちらか 1 つ。両方あると検査が F-FILE-03 を言います）。

@story name=長老の頼み
; 村の長老。頼みを受けるかどうか
@bgm bgm_village
#elder
ようこそ、旅の者よ。北の洞窟に、ねずみの王が住みついてしまった。
村の畑が荒らされて困っている。退治してくれんか。
@l
choice {
  "引き受ける" {
    #elder style=balloon target=self
    ありがたい！ 薬草を持っていきなさい。
    @l
    @item herb + count=3
    quest_accepted = true
    @quest rat_hunt start
  }
  "今は無理だ" {
    #elder
    そうか……気が変わったら、また来てくれ。
    @l
  }
}
if (gold >= 100) {
  @se se_decide
} else {
  @wait 300
}
battle rat_king canEscape=true {
  win {
    boss_defeated = true
  }
  lose {
    @game_over
  }
}

• 命令と項目の一覧は kaede-rpg schema --kind story。kaede-rpg show story:<章>/<話> --ks で、.json の話も KS の形で読めます（見本を見るのに便利）。
• 本文を @・#・*・;・"・} で始めたいときは前に \ を置きます。空白を含む値は "…" で囲みます。
• 読めない行があっても、ほかの行は普通に読め、読めなかった行は「raw」の命令として残ります（木には赤で出ます。検査が行番号つきで F-KS-01〜06 を言い、残したままでは遊べません）。
• 保存すると KS は整った形（正規形）に書き直されます（空白・引用符の付け方・key=値 の順がそろう。自動で付けた id は書かれない。本文の行の頭の空白と、本文の前後の空行・命令の間の空行は残らない）。手で書いた形がそのまま残らないのは仕様です。本文の中の @r は改行として読まれます（文字として書くなら \@r）。
• 店（shop）の品物のような入れ子の一覧は、KS では JSON を 1 つの値に書く形になります。店は命令の木で作るのが楽です。
• 形の切り替えは、物語のタブの一覧の右クリック（KS にする／JSON にする）か、CLI の kaede-rpg story to-ks <章>/<話>／story to-json <章>/<話>（どちらも新しい形で書いてから古い方を消す）。

7. データベースのタブ#

仲間	敵

上のタブで種類を選び、左の一覧（番号つき）から 1 件を選ぶと、右に全部の項目が出ます。項目は 2 段組で、左の段に 1 行の欄と絵の見本、右の段に能力値などのまとまり（色の帯の見出しと枠）、一覧（覚える技・特徴など）は表で出ます（§3 の「一覧の欄は表で直す」）。一覧の下の欄に id を書いて 足す、選んで 消す。

7.1 作品の設定#

主な項目: 題名・開始位置・最初の仲間・最初のお金・タイトル画面・マップの HUD（hud。画面 ui/hud.json）・起動のロゴ（logos。タイトルの前に順に出す画像と時間）。

rpg.json（file:rpg）

起動のロゴ（タイトルの前に順に出す）（logo）

開始位置（start）

7.2 仲間#

主な項目: 名前・キャラ・初期レベル・能力値（HP・MP・攻撃・防御・魔法攻撃・魔法防御・素早さ）・成長（1 レベルごと）・経験値の曲線・覚える技・初期装備・「たたかう」のアニメ・素手の「たたかう」の属性・特徴。

属性と特徴

• 属性: システムの 属性の一覧 に火・氷などを足し、技やアイテムの効果に属性を付けます。武器に「たたかう」の属性を付けると、通常攻撃もその属性になります。
• 特徴: 仲間・装備・状態・敵に付けます。種類は 5 つです。

• 装備の画面に、付いている特徴が「特徴: 毒にかからない」のように出ます。見本では「毒よけのお守り」がこれです。

db/actors.json（file:db/actors）

仲間（actor）

能力値（レベル 1）（params）

特徴（trait）

経験値の曲線（exp_curve）

覚える技（learn）

初期装備（equip）

7.3 技#

主な項目: 名前・消費 MP・消費 HP（HP が足りないと使えない）・対象・効き方（ダメージ・回復・状態を付ける）・計算式（例 a.atk * 2 - b.def）・振れ（％）・命中（％）・付ける状態・属性・アニメ。

技の計算式は、既定のまま使ってかまいません（エディタで技を足すと a.atk * 2 - b.def が入ります）。変えるときは、使う側が a、受ける側が b です（a.atk・b.def・a.mat・a.level など）。

db/skills.json（file:db/skills）

技（skill）

7.4 アイテム#

主な項目: 名前・種類（消耗品・武器・防具・装飾品・大事な物）・値段・説明・効果（消耗品。属性も付けられる）・使える場面（戦闘・フィールド・両方）・足す能力値（装備）・装備で付く特徴・武器の「たたかう」の属性・使ったときのアニメ。

足す能力値（装備）（params_partial）

db/items.json（file:db/items）

アイテム（item）

効果（消耗品）（item_effect）

「特徴」（trait）の項目は §7.2 の表。

7.5 敵#

主な項目: 名前・画像・能力値・経験値・お金・落とす物（確率）・行動（技と条件）・特徴・「たたかう」の属性・図鑑の説明。

図鑑と鑑賞: 倒した敵、戦闘で当てて分かった属性の効き、見た背景、聞いた曲を、作品ごとに覚えます（セーブとは別で、新しく始めても残ります）。タイトルの 図鑑と鑑賞 から見られます。敵に 図鑑の説明 を、背景・ピクチャ・BGM の素材に 鑑賞に載せる（gallery）を付けます。戦闘では、分かった弱点が敵の名前の下に「弱点 火」のように出ます。

db/enemies.json（file:db/enemies）

敵（enemy）

図鑑（§2.11.5）（bestiary）

落とす物（drop）

行動（enemy_action）

「能力値（レベル 1）」（params）の項目は §7.2 の表。

「特徴」（trait）の項目は §7.2 の表。

7.6 敵の組#

主な項目: 名前・敵と位置。

戦闘の強さは、CLI の kaede-rpg battle <敵の組> --runs 20 で勝率を確かめられます（§14）。

db/troops.json（file:db/troops）

敵の組（troop）

敵（troop_member）

7.7 状態#

主な項目: 名前・アイコン（ゲームではまだ出しません）・行動の制限・続くターン（最小と最大）・戦闘の終わりで治るか・毎ターンの HP の増減（％）・能力値の倍率・特徴。

db/states.json（file:db/states）

状態（state）

「足す能力値（装備）」（params_partial）の項目は §7.4 の表。

「特徴」（trait）の項目は §7.2 の表。

7.8 クエスト#

主な項目: 名前・説明・目標（変数がその値以上・アイテムをその数持つ・受けてから敵をその数倒す）・報酬（お金・経験値・アイテム）。

クエスト: データベースの クエスト に目標と報酬を書き、イベントの命令 クエスト（quest）で受ける（start）・達成（complete）・失敗（fail）・目標を満たしていれば達成（advance）を指示します。達成で報酬を配り、画面の上にお知らせが出ます。条件式では quest.<id>.state（0 受けていない・1 進行中・2 達成・3 失敗）と quest.<id>.ready（目標を全部満たした）が読めます。プレイヤーはメニューの クエスト で進み具合を見られます。見本では、長老の頼みを引き受けると「ねずみ退治」を受け、王を倒して長老に知らせると達成します。

db/quests.json（file:db/quests）

クエスト（quest）

目標（quest_goal）

報酬（quest_rewards）

「アイテム」（item_count）の項目は §7.10 の表。

7.9 合成#

主な項目: できる物と数・材料と数・お金。

合成: データベースの 合成 に作り方（材料とできる物）を書き、イベントの命令 合成の画面（craft_screen。作れる作り方を絞ることもできます）を作業台などに置きます。手に入れる道の無い材料があると、検査が知らせます。見本では、村の作業台でねずみの尻尾 2 つから薬草を作れます。

db/recipes.json（file:db/recipes）

合成の作り方（recipe）

「アイテム」（item_count）の項目は §7.10 の表。

7.10 システム#

主な項目: お金の単位・戦闘の BGM・勝利の ME（ゲームではまだ鳴らしません）・最初の所持品・逃走の成功率の式・勝ったあとに全回復・勝利の画面（既定は出す）・入手のお知らせ（既定は出す）・既定の文字の音・「たたかう」の既定のアニメ・属性の一覧・戦う人数（パーティの先頭から。既定 4。残りは控え）・控えの経験値（％）・負けたらゲームオーバー（切ると作品全体で負けても続く）。

db/system.json（file:db/system）

属性（技・特徴で使う）（element_def）

アイテム（item_count）

「文字の音」（text_sound）の項目は §8.1 の表。

7.11 サーバー#

cloud.json のサーバーの住所（server）・ゲームの id（game）・記録（records）・実績（achievements）。表の つながるか確かめる と、サーバーの定義の書き出しもここにあります。使い方は §15。

cloud.json（file:cloud）

サーバー（cloud_server）

記録（順位）（cloud_record）

実績（住所が空でも手元で働く）（cloud_achievement）

8. キャラと素材のタブ#

キャラ	素材

8.1 キャラ#

• キャラ: 名前・顔・表情（名前 → 立ち絵）・既定の表情・歩く絵（画像・コマの幅と高さ・列と行・行の向きの順・歩くコマの順）・文字の音（話すときに何文字ごとに鳴らす効果音と音量）。歩く絵の既定は 3 列 × 4 行（下・左・右・上）。

characters.json（file:characters）

キャラ（character）

文字の音（text_sound）

歩行（walk）

8.2 素材#

• 素材: 種類（背景・立ち絵・顔・歩く絵・タイルセットの画像・敵・ピクチャ・BGM・BGS・ME・効果音・ボイス・UI・アニメ）を選んで ファイルを取り込む… を押すと、ファイルを media/<種類>/ へ写して登録します。絵は見本が出ます。BGM はいつも繰り返して鳴ります（ゲームは「繰り返す」の印をまだ読みません）。
• アニメ（素材の種類 animation）: コマを横に並べた 1 枚の画像。コマの数・1 行のコマの数・コマの幅と高さ・1 秒のコマ数・描く倍率・始まりの効果音を書きます。技・アイテム・仲間の「たたかう」と、命令 animation で使います。

assets.json（file:assets）

素材（asset）

8.3 タイルセット#

• タイルセット: 画像・列の数・タイルごとの設定（通行 o 通れる・x 通れない・star 上に描く）。
  • オートタイル（autotiles）: 画像の中に、1 種類につき横に 5 枚の帯を描きます。左から「島（四隅が外の角）」「横に続く（上下が縁）」「縦に続く（左右が縁）」「内の角（四隅だけ外が見える）」「中（全部同じ）」。ツールは 1 マスを 4 つに分け、隣に合わせてこの 5 枚から切り貼りします。帯の左上のマス（col row）・通行・つながり方（floor 地面と水／wall 壁と屋根＝内の角を使わない）を書きます。アニメは帯を下へコマの数だけ並べ、frames（コマ数）と fps（速さ）を書きます。マップのマスには 10000＋番号 が入ります。見本の media/tiles/field.png の 2 行目（道）と 3〜5 行目（水の 3 コマ）が例です。

tilesets/<id>.json（file:tileset）

オートタイル（マップには 10000＋番号で書く）（autotile）

タイルの設定（番号 → 設定）（tile）

9. 変数のタブ#

変数の一覧と、選んだ変数の型（真偽・数・文字）・範囲（全体／自分のフラグ）・初期値・説明。自分のフラグはイベントごとに別の値です。a b c d の 4 つは組み込みで、登録しなくてもどのイベントでも使えます（既定は false）。名前を付けたいときは範囲を「自分のフラグ」にして 1 つ登録すれば、同じ名前（例 done）をどのイベントでも使い回せます（宝箱ごとに登録しなくてよい）。右下に、その変数を読む場所・書く場所が並び、クリックするとその命令へ飛びます。

vars.json（file:vars）

変数（var）

10. 画面のタブ#

ゲームの画面（タイトル・メニュー・会話の窓・選択肢・戦闘の窓・マップの HUD など）を、JSON を書かずに、絵を見ながら直すタブです。直した画面は作品の ui/<画面>.json に保存され、製品の既定の画面より先に使われます（製品の既定そのものは直しません）。何も直さなければ製品の既定の画面のままで、見た目はテーマ（下）で替えられます。

見ながら直す

1. 左で画面を選びます（例: メニュー）。
2. プレビューの上で部品を押すと選びます（押した所のいちばん小さい部品。同じ所をもう一度押すと 1 つ外側の部品）。木で押しても同じです。一覧（仲間の一覧など）の行を押すと、その 1 件分の型を選び、直すと全部の行に効きます。
3. 右の欄で直します。色は空にするとテーマの色に任せます。表示する値（所持金・名前など）・表示条件（顔の絵があるとき、など）・押したときの動作 は、その画面でゲームが渡す値・受ける動作の一覧から選びます（一覧の正は製品の目録 Resources/Rpg/ui/catalog.json）。欄に無い鍵は 詳細 の JSON で直せます。
4. 保存 で作品の ui/ に書きます。書く前に診断し、error（ゲームが受けない動作・閉じる手段が無いなど）があれば書きません。診断の件数と最初の 1 件はプレビューの下に出ます。

• 製品の既定の画面を開いて直すと、最初の操作でその画面が作品へ写ります（上の 製品の既定の画面を作品へ写す は、まとめて写したいときだけ使います）。
• 編集／操作: 編集は、押すと部品を選びます。操作は、押すとボタンが押された扱いになり、押した動作の名前を下に出すだけです（ゲームは進みません）。
• ↶・↷（Ctrl+Z・Ctrl+Y）は、1 回の操作（欄 1 つ・ドラッグ 1 回・足す・消す・初期状態に戻す）ずつ戻る・進む。

ドラッグで動かす

• 縦・横に並べる入れ物（と格子・Modal）の中: ドラッグで 並び順 を入れ替えます（落とす所に線が出ます）。右端・下端のつまみで幅・高さ。位置は入れ物が決めるので、x・y の欄は出ません。
• 板（Panel）の中と、いちばん外の部品: ドラッグで 位置 を動かします。4 px ごとに吸着し、Shift を押している間は 1 px ずつ。画面の外へは出ません。四隅と四辺のつまみで大きさ。
• ドラッグ中は右の欄の x・y・w・h が追いかけます。離したところで 1 回の操作です。
• プレビューの下の 上へ・下へ（同じ入れ物の中で 1 つ前・後ろへ）・入れ物へ移す ▾（別の入れ物の末尾へ。所持金の行を右の列へ、など）でも動かせます。

部品を足す・消す

• 部品を足す ▾ で種類（文字・画像・ボタン・板・縦に並べる・横に並べる・区切り線・ゲージ）を選びます。選んでいる部品が入れ物ならその中の末尾に、それ以外ならその後ろに入ります。足した文字には右の欄の 表示する値 で所持金などを、ボタンには 押したときの動作 を選びます。
• 消す で、選んでいる部品を中ごと消します。いちばん外の部品は消せません。
• ゲームが渡さない新しい値（好感度など）と、新しい画面を作ることはまだできません（§16）。

見本の状態

プレビューはゲームを起動せず、見本の値で描きます。上の段の 見本 で状態を切り替え、はみ出し・重なり・切れが無いかを見ます。

テーマ の欄は、プレビューの色と書体だけを替えます（作品の rpg.json の uiTheme は変えません）。

初期状態に戻す

• 初期状態に戻す で、開いている画面を製品の既定の中身に戻します（↶ で取り消せます）。保存すると、作品の ui/<画面>.json が既定と同じ中身になります。
• 作品の画面をやめて製品の既定に戻したいときは、作品の ui/<画面>.json を消します。

テストプレイと AI

• テストプレイの窓を開いたまま保存すると、窓のゲームがすぐ画面を読み直します（出している画面・会話と戦闘の窓・マップの HUD）。
• AI や CLI が作品の ui/*.json を書き換えたときも、1 秒ごとの見張り（§3 の「外での書き換え」）が見つけて、画面のタブとテストプレイの窓が読み直します。
• CLI では同じ画面を show ui:menu・set ui:menu#/root/children/0/h 56 のように直せます（場所は ui:<画面>#<JSON Pointer>）。check は画面の診断（R-UI-*）も出します。

ゲーム画面のテーマ: 窓の色・枠・角の丸み・書体・飾り・選んだ項目の見せ方、テーマによっては会話・戦闘・メニュー・タイトルの配置までまとめて替えます。データベースのタブの作品の設定（rpg.json）の 画面のテーマ（uiTheme）に名前を書きます。製品には 12 の系統と、そのうち 10 の系統の色違い 20 があります（全部で 32）。

fantasy	modern	crystal
legend	filigree	voyage
heraldry	sketch	dust
dread	cinematic	rebel

• 自分のテーマは、作品の themes/<名前>.json に置きます（製品の Resources/Rpg/themes/fantasy.json を写して直すのが早道）。色 11 個のほか、radius（角の丸み）・border（枠の太さ）・frame（double 二重線・ornate 飾り付き）・shadow（窓の影）・gradient（地の濃淡）・bevel（上端の光る線）・textShadow（文字の影）・cursorBar（選んだ行の印の帯）・font（mincho・gothic・hand 手書き風・dot ドット）・pixelArt（絵を滲ませない）を書けます。
• 色違い: fantasy modern crystal legend filigree voyage heraldry sketch dust dread には色違いが 2 つずつあります。uiTheme に crystal-jade のように書きます。形は系統と同じで、色だけ替わります。

• 自分の色違いは、作品の themes/<名前>.json に "base": "<系統>" と替えたい色だけを書きます。テーマのレイアウトの中の色は "$accent" や "$label" のように名前で書いてあり、テーマの色と palette の色が入ります。
• 画面ごとに形だけ替えたいときは、ui/<画面>.<名前>.json を作り、rpg.json の uiLayouts に {"message": "<名前>"} のように書きます。
• 各テーマの全部の場面（タイトル・マップ・会話・戦闘・メニューと各画面の 15 枚）は images/kaede-rpg/themes/<テーマ>/ に、色違いは images/kaede-rpg/themes/<系統>/<色>/ にあります。
• 窓の描き方の鍵（濃淡・形・立体の縁・絵の枠・縁取り・字間・回す・ぼかし・点滅など）は、画面の JSON の部品にも書けます（一覧は MomijiUI の説明書）。
• エディタの色（上の Kaede Dark・Kaede Light）とは別のものです。

入力の画面: 命令 input_name・input_number・input_item（§5）が開く画面は ui/input_name.json・ui/input_number.json・ui/input_item.json です。名前は文字欄（MomijiUI の TextInput。開くとすぐ打てる・Enter で決定）、数は桁ごとの ▲▼、アイテムは持っている物の一覧です。ほかの画面と同じく作品の ui/ に写して形を変えられます（渡す値と action は目録 catalog.json）。

画面の文言: 既定の画面の決まった文言は、文字を直に書かず "text": "{t_items}" のように文言の表の鍵で書いてあります（§2 の「作品の言語」で日本語と英語が替わる）。作品の ui/ に写した画面でも同じ鍵が使えます。言語で替えたくない文は、直に "text": "持ち物" と書きます。鍵の文の中の {gold} のような差し込みは、その画面の値で置き換わります。

テーマを配る・取り込む

作ったテーマ（色・形・絵）とその画面の形を 1 つの zip にして、別の作品に入れられます。上の段の ライセンス・テーマを書き出す…・取り込む… を使います。

1. 書き出す: 上の段の テーマ で書き出すテーマを選び、ライセンス の欄を書きます（own＝自作・cc0・cc-by か、条件を文で）。テーマを書き出す… を押して zip の置き場を選びます。ライセンスが空なら書き出しません。ほかの制作ツールの素材や他人の素材は入れないでください。保存していない変更があるときは、先に 保存 します。
2. 取り込む: 別の作品を開き、取り込む… で zip を選びます。テーマは作品の themes/ に、画面の形は ui/ に入り、プレビューのテーマがそれになります。ゲームで使うには、rpg.json の uiTheme（データベースのタブの作品の設定）をその名前にします（取り込みでは変えません）。

• zip に入るもの: share.json（束の説明: 種類・名前・作者・版・ライセンス・中身の一覧・取り込む側に要るもの）と、files/ の下の themes/<名前>.json・themes/<名前>/ の絵と書体・テーマの画面の形 ui/<画面>.<名前>.json。作品に無い製品のテーマ（fantasy・crystal など）は製品のものを入れます。base の系統が製品にしか無いときは束に入れず、「取り込む側に要るもの」（requires）に書きます。
• 作品に同じ名前のテーマや画面の形があると、そのままでは入れず、名前を変えて入れるか を聞きます。はいなら <名前>_<4 字の印>（例 crystal_1a2b）で入れ、テーマの中の id・base・layouts も新しい名前に直します。
• 束に入れられるのは themes/ と ui/ の JSON・絵（PNG・JPG）・書体（TTF・OTF）だけです。ほかのファイルが入った束や、ライセンスの無い束は取り込みません。
• 取り込んだ束の名前・版・作者・ライセンスは、作品の share-log.json に残ります（クレジットを書くときに見ます）。取り込みは ↶ で戻せません（作品を読み直すので、それまでの ↶ の履歴も消えます）。戻すときは、share-log.json の files に書いたファイルを消します。
• 同じことは CLI の share pack theme・share import（§14）でもできます。いま配れるのはテーマと画面の形だけです（§16）。

share-log.json（file:share-log）

取り込んだ束（share_import）

11. 検査のタブ（詰まない検査）#

指摘の一覧です（error は赤、warning は黄）。行をダブルクリックすると、その場所（マップ・イベントの命令・データベースの行・変数）を開きます。CLI の kaede-rpg check と同じ結果です。

12. ゲームの操作（プレイヤー向け）#

• マウスも使えます。タイトルやメニューでは、項目にマウスを乗せるとそこが選ばれ（選んでいる印はいつも 1 つ）、クリックで決まります。会話はクリックで送れます。

メニュー	所持品	装備

状態	セーブ	設定

• メニュー（フィールドで Esc）: 所持品・技・装備・状態・セーブ・設定・タイトルへ。
• セーブ／ロード: 20 枠と、マップを移ったときのオート。
• 設定: 全体・BGM・効果音・ボイスの音量、文字の速さ、オートの待ち、窓の濃さ、オート、未読もスキップ、文字の音、全画面、窓の大きさ（1280×720・1920×1080・2560×1440）。
• 図鑑と鑑賞（タイトル）: 倒した敵（弱点・落とす物）と、見た場面・聞いた曲。
• 並び替え（メニュー）: 2 人を順に選ぶと入れ替わります。戦うのは先頭から決まった人数で、残りは控えです。
• クエスト（メニュー）: 受けているクエストと、目標の進み具合。
• 戦闘: たたかう・技・アイテム・防御・逃げる（逃げられない戦闘もあります）・おまかせ（その仲間の行動を決めてもらう: HP が減った仲間がいれば回復、敵の弱点の技があればそれ、なければ一番弱った敵を攻撃）。

13. 生成 AI と一緒に作る#

はじめに: Claude Code（Anthropic）か Codex（OpenAI）を、それぞれの公式の案内のとおりに入れます。どちらも使うには各社の契約（有料のプランか API の利用料）が要ります。入れたら、Windows の PowerShell を開き（スタートメニューで「PowerShell」と打つ）、cd で作品フォルダへ移り、claude（Codex は codex）と打って起動します。

作品フォルダで Claude Code（または Codex）を起動して、作りたいものを頼みます。AI は次を読んで、CLI で作品を直します。

• CLAUDE.md（Codex は AGENTS.md）: 作品フォルダの決まりと、守ること
• .claude/skills/ のスキル 6 本: マップを作る・イベントを足す・データベース・物語・検査・遊んで確かめる
• .claude/settings.json: ファイルを書くたびに形の検査をし、error があれば AI に知らせる

頼み方の例: 「村と洞窟とボス 1 体の短い RPG を作って。最後まで遊べることを play で確かめて」。

長い会話は、AI が story/<章>/<話>.ks に KS（§6.1）で書きます。JSON の命令の木を 1 つずつ足すより短く、読み返しやすい形です。書いたあとは今までどおり kaede-rpg check --json で検査します。

「長老の台詞を全部やさしい口調に」のように、作品のあちこちにあるものを直す頼みでは、AI はまず kaede-rpg search 長老 --json で場所を探し（CLAUDE.md にそう書いてあります）、見つかった場所を 1 つずつ set で直します。作者がエディタで同じ場所を見るには、上の段の 探す の欄（§3）で同じ文字を探します。

仲間・技・アイテム・敵・敵の組・状態の値（値段・能力値・名前など）を一覧で見比べて直すときは、表計算（Excel・Google スプレッドシートなど）が使えます。kaede-rpg db export-csv items --out items.csv で CSV に書き出し、表計算で直して保存し、kaede-rpg db import-csv items items.csv で戻します（形は §14）。戻すと検査（check）の結果が出ます。AI に「アイテムの値段を全部 2 割上げて」と頼むときも、AI は同じ CSV を使えます（CLAUDE.md にそう書いてあります）。

AI が直したファイルは、エディタが自動で読み直します（未保存の変更が無いとき）。AI が途中で出す CLI の出力（検査の規則の名前・play の JSON の行）は AI が読むものです。作者は、エディタの検査のタブとテストプレイで確かめれば足ります。

14. CLI（kaede-rpg.exe）#

CLI はコマンドラインツール（Command Line Interface）のことです。エディタのボタンを押す代わりに、Windows の PowerShell に kaede-rpg check のように命令を打って、作品を検査したり直したり遊んだりします。PowerShell は、スタートメニューで「PowerShell」と打って開きます（コマンドプロンプトでも同じように使えます）。開いたら cd で作品フォルダへ移ってから打ちます。エディタと同じ作品フォルダを同じ規則で読み書きするので、どちらで直しても同じ結果になり、生成 AI（§13）もこれを使います。プラグインの ThirdParty/Win64/kaede-rpg.exe が組み立て済みで、ソース（Tools/KaedeRpgCli/）と組み立ての脚本（Build-KaedeRpgCli.bat）も入っています。

作品フォルダで実行するか、--work <フォルダ> を付けます。--json で結果を JSON にします。終了コードは 0＝合格・1＝指摘あり・2＝使い方の誤り・3＝内部の誤り（ツールの不具合）。

場所の書き方: map:village/event:elder/page:0/block:t1・db:actors/hero・var:met_elder・story:01_main/01_opening。命令の id（block: の後ろ。add で足すと text_1 のように付きます）はファイルごとに振られ、別のファイルにも同じ id があります。命令を指すときは、マップ・イベント・ページか話から書きます。末尾に #/<項目> で中の項目（例 rpg#/start/x）。まだ無い「勝ったとき」（#/winBlocks）や出現条件（#/conditions）にも、そのまま add で足せます。add <イベント> '{}' で足したページは、前のページの見た目・高さ・起動を受け継ぎます（命令と出現条件は空）。

乱数の種（seed）: ゲームの中で運で決まるもの（ダメージの振れ・命中・敵の行動・ランダムエンカウント・落とす物）は、全部 1 つの乱数の列から引きます。種はその列の出発点になる数で、同じ種なら乱数の列が同じになり、同じ入力で同じ結果になります。入力の列のファイルの "seed"（見本の tests/clear.json は 42）か、play・battle の --seed で決めます。入力の列を書くときは種を 1 つ決めて書いておくと、あとで何度回しても同じ道を通ります（種を変えれば別の運で確かめられます）。

遊ぶ入力の列（tests/clear.json など）の手: move・press（decide／cancel）・until（event_end／click／choices／battle／idle／screen）・choose・battle（auto）・use・skill・equip・buy・sell・craft・swap・input（入力の画面に値を渡す: {"input": "アル"}・{"input": 1234}・{"input": "herb"}。null は取消）・close・save・load・wait・expect（記録は {"expect": {"record": {"record": "clear_time", "atLeast": 1}}}・ピクチャは {"expect": {"picture": {"no": 1, "asset": "pic_letter", "opacity": 1}}}・消えたことは {"picture": {"no": 1, "shown": false}}）。どの手にも when を付けると、変数がその値のときだけ流します（{"when": {"var": "halloween", "value": true}, "press": "decide"}。外から変わる変数の値ごとの振る舞いを 1 本の列で確かめる）。

書き出したゲームでも、-KaedeRpgAutoplay=tests/clear.json を付けて起動すると、同じ入力の列で最後まで自動で遊びます（結果は終了コード 0／3〔結果のファイルを書けなければ 4〕と Saved/KaedeRpg/autoplay-result.txt）。

15. サーバーの機能（クラウドセーブ・記録の順位・遠隔の値・お知らせ）#

作者が自分の Cloudflare に立てたサーバーと、ゲームがやり取りする機能です。作品フォルダの cloud.json にサーバーの住所を入れるだけで、標準の画面に次の欄が出ます。住所が空（見本はこの形で入っています）か cloud.json が無ければ、欄は出ず、通信もしません（今までどおり遊べます）。