ノベルゲームに選択肢を付ける|Ren'Pyとティラノスクリプトの分岐
Ren'Py では menu 文が選択肢を並べ、選ばれたかたまりが実行され、jump 文でラベルへ移れます。ティラノスクリプトでは [glink] がテキストのボタンで選択肢を出し、表示中は進行が止まるのでジャンプ先を必ず指定します。選択肢を出す命令・移る先のラベル・選んだ結果を覚える変数の書き方を、表と手順で並べます。
このページの目次
選択肢の命令を Ren'Py とティラノスクリプトの表で見る
やりたいことごとに、Ren'Py とティラノスクリプトの命令を並べます。
やりたいことと、Ren'Py・ティラノスクリプトの命令
| やりたいこと | Ren'Py | ティラノスクリプト |
|---|---|---|
| 選択肢を出す | `menu` 文が選択肢を出します。選択肢は文字列で始まり、コロンで終わり、そのあとに文のかたまりが続きます | `[glink]` はテキストのボタンで、画像は要りません。`[link]`〜`[endlink]` では、ページをまたいでテキストをリンク化することはできません |
| 選ばれたあとに移る | 選ばれた選択肢のかたまりが実行されます。かたまりの終わりまで来ると、`menu` 文のあとの文へ続きます | `[glink]` と `[link]` は、`target` に書いたラベルへ移ります。`storage` にはジャンプ先のシナリオファイル名を書き、省略すると現在のシナリオファイルになります。`target` を省略すると、シナリオファイルの先頭にジャンプします。`[jump]` も、`storage` と `target` で移る先を指します |
| 移る先の印 | `label` 文でプログラムの位置に名前を付け、`jump` 文か `call` 文の移る先にします | ラベルは `*select1` のように `*` を付けた名前で書き、`target=*select1` のように指します |
| 選んだ結果を変数に入れる | `$` で始まる1行は、フラグの初期化や変数の更新などに使える Python の1行の文です。`$ romance_points += 1` のように書きます | `[eval exp="f.like = 1"]` の形で書きます。ゲーム変数の名前は `f.like` のように `f.` で始め、一時変数には `tf.` が付きます。`sf.` で始まる変数もあります |
| 変数の初めの値 | `default` 文は、ゲームの開始時、または新しいゲームを読み込んだあとに、その変数が定義されていなければ値を入れます。`default points = 0` と書きます | `[eval]` で値をセットします。たとえば `[eval exp="f.like = 0"]` と書きます |
| 変数で展開を分ける | `if 式:`・`elif 式:`・`else:` の形で書きます。式は上から順に評価され、true になった節のかたまりが実行されます | `[if exp="…"]`〜`[elsif exp="…"]`〜`[else]`〜`[endif]` の形で書きます。`[endif]` は `[if]` 文の終わりに必ず書きます |
| 選択肢に条件を付ける | 選択肢の文字列のあとに `if` 節を書くと、式が true のときだけ、その選択肢が表示されます(`config.menu_include_disabled` が True なら、無効なボタンとして表示されます) | `[link]`〜`[endlink]` を `[if]` と `[endif]` のあいだに書くと、式が true のときに実行されます |
| 戻ってこられるか | `jump` 文は次の文をスタックに積まないので、元の場所へ戻る手段がありません。`call` 文は次の文をコールスタックに積み、`return` 文で `call` の次の文へ戻れます | `[jump]` の移動はコールスタックに残らず、`[return]` で戻れません。`[glink]` で移るときも同じです。`[call]` で移ると、移った先で `[return]` に着いたときに `[call]` の場所へ戻ります |
分かれて合流する流れを図で見る
最初の場面から、選択肢で2つの道に分かれ、変数が変わり、合流して、変数の値で終わりが分かれるまでの流れです。
選択肢で分かれて、変数の値で終わりが分かれる流れ
Ren'Py で選択肢を付ける手順
庭で鍵を見つけたかどうかで、広間での展開が変わる短い場面を例にします。
default文で、覚えておきたいことを変数にして、初めの値を入れます。ここでは、鍵を見つけたかどうかをkey_foundに入れます。default key_found = Falselabel start:のあとにmenu:を書き、字下げした中に、文字列とコロンで選択肢を2つ書きます。選択肢ごとに、字下げしたかたまりを書きます。label start: "洋館の前に着いた。" menu: "庭を調べる。": "庭を歩いた。" "裏口へ回る。": "裏口へ向かった。"選んだ結果を覚えたい選択肢のかたまりに、
$で始まる行を書いて、変数を変えます。"庭を調べる。": $ key_found = True "庭で鍵を見つけた。"もう片方の選択肢のかたまりには
jump文を書き、移る先をlabel文で作って、別の場面を書きます。場面の終わりにjump hallを書くと、menu文のあとの場面に合流します。"裏口へ回る。": jump back_door label hall: "広間に入った。" return label back_door: "裏口から入った。" jump hall後半の
label hall:でif文を書き、変数の値で終わり方を分けます。label hall: "広間に入った。" if key_found: "鍵で地下室の扉を開けた。" else: "地下室の扉は開かなかった。" return広間の場面を選択肢にして、鍵を見つけたときだけ出る選択肢を足します。
label hall: "広間に入った。" menu: "広間を見回す。": "何も見つからなかった。" "地下室の扉を開ける。" if key_found: "鍵で扉を開けた。" return
ティラノスクリプトで選択肢を付ける手順
同じ短い場面を、ティラノスクリプトで書きます。
シナリオファイルの先頭で、
[eval]を使い、f.で始まる変数に初めの値を入れます。[eval exp="f.key_found = false"]選択肢を
[glink]で出し、targetにジャンプ先のラベルを書きます。[link]〜[endlink]で囲んだテキストでも、選択肢を出せます。洋館の前に着いた。[p] [glink target="*garden" text="庭を調べる" width="500" y=300] [glink target="*backdoor" text="裏口へ回る" width="500" y=400][link target=*garden]庭を調べる[endlink][r] [link target=*backdoor]裏口へ回る[endlink][r]選択肢のあとに
[s]を書きます。[s]はシナリオの実行を止め、プレイヤーの選択を待ちます。[s]受け先を
*を付けたラベルで作り、選ばれたときの変数を[eval]で変えます。*garden [eval exp="f.key_found = true"] 庭で鍵を見つけた。[p] *backdoor 裏口から入った。[p]各ラベルの終わりに
[jump]を書き、同じラベルへ合流させます。*garden [eval exp="f.key_found = true"] 庭で鍵を見つけた。[p] [jump target=*hall] *backdoor 裏口から入った。[p] [jump target=*hall]合流したあとの
*hallで、[if exp="…"]〜[endif]を書き、変数の値で終わり方を分けます。*hall 広間に入った。[p] [if exp="f.key_found === true"] 鍵で地下室の扉を開けた。[p] [else] 地下室の扉は開かなかった。[p] [endif]
失敗を避ける注意
- ティラノスクリプトの
[glink]は、表示中はシナリオの進行が止まるので、ジャンプ先を必ず指定します。ジャンプ後は自動的に[cm]が実行され、ボタンが消えます。cmに false を指定すると、この[cm]は実行されません。 - ティラノスクリプトの
[s]に着くと、クリックやタップでシナリオを進められなくなります。プレイヤーがシナリオをジャンプさせるための手段が要ります。選択肢は[link]・[glink]・[button]などのタグで出し、そのあとに[s]を書きます。 - ティラノスクリプトの
[jump]と[glink]の移動はコールスタックに残らず、[return]で戻れません。戻る場面では[call]で移ります。 - ティラノスクリプトの
[eval]のexpに書く文をダブルクォート(")で囲むと、意図しない動作を防げます。文字列を値にするときは、その中でシングルクォーテーション(')で囲みます。 - Ren'Py の
menu文は、字下げしたブロックに少なくとも1つの選択肢が要ります。default文が値を入れるのは、その変数が定義されていないときだけです。
公式のページの版
Ren'Py の項目は 8.5.4 の版のドキュメントのものです。ティラノスクリプトの項目は、タグリファレンス V6 のものです。
次に読む
どこまで作るかを決める話は、ゲームの大きさの決め方にあります。
情報源
- In-Game Menus(Ren'Py の公式ドキュメント)https://www.renpy.org/doc/html/menus.html確認日 2026-11-03
- Labels & Control Flow(Ren'Py の公式ドキュメント)https://www.renpy.org/doc/html/label.html確認日 2026-11-03
- Python Statements(Ren'Py の公式ドキュメント)https://www.renpy.org/doc/html/python.html確認日 2026-11-03
- Conditional Statements(Ren'Py の公式ドキュメント)https://www.renpy.org/doc/html/conditional.html確認日 2026-11-03
- タグリファレンスV6(ティラノスクリプトの公式サイト)https://tyrano.jp/tag/確認日 2026-11-03