INDIE INDEX

レベル:入門

ノベルゲームに選択肢を付ける|Ren'Pyとティラノスクリプトの分岐

公開 2026-11-03更新 2026-11-03

Ren'Py では menu 文が選択肢を並べ、選ばれたかたまりが実行され、jump 文でラベルへ移れます。ティラノスクリプトでは [glink] がテキストのボタンで選択肢を出し、表示中は進行が止まるのでジャンプ先を必ず指定します。選択肢を出す命令・移る先のラベル・選んだ結果を覚える変数の書き方を、表と手順で並べます。

このページの目次
  1. 選択肢の命令を Ren'Py とティラノスクリプトの表で見る
  2. 分かれて合流する流れを図で見る
  3. Ren'Py で選択肢を付ける手順
  4. ティラノスクリプトで選択肢を付ける手順
  5. 失敗を避ける注意
  6. 公式のページの版
  7. 次に読む
  8. 情報源

選択肢の命令を 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]` の場所へ戻ります
表1

分かれて合流する流れを図で見る

最初の場面から、選択肢で2つの道に分かれ、変数が変わり、合流して、変数の値で終わりが分かれるまでの流れです。

選択肢で分かれて、変数の値で終わりが分かれる流れ

選択肢で分かれて、変数の値で終わりが分かれる流れ1選択肢を出す最初の場面のあと、Ren'Py は `menu` 文、ティラノスクリプトは `[glink]` か `[link]`〜`[endlink]` です2選択肢ごとの道Ren'Py は選ばれたかたまりの実行と `jump` 文、ティラノスクリプトは `target` に書いたラベルへの移動です3変数が変わるRen'Py は `$` で始まる行、ティラノスクリプトは `[eval]` です4合流Ren'Py は `jump` 文、ティラノスクリプトは `[jump]` で、同じ場面へ進みます5終わりが分かれるRen'Py は `if` 文、ティラノスクリプトは `[if]`〜`[endif]` で、変数の値によって分けます
図1

Ren'Py で選択肢を付ける手順

庭で鍵を見つけたかどうかで、広間での展開が変わる短い場面を例にします。

  1. default 文で、覚えておきたいことを変数にして、初めの値を入れます。ここでは、鍵を見つけたかどうかを key_found に入れます。

    default key_found = False
    
  2. label start: のあとに menu: を書き、字下げした中に、文字列とコロンで選択肢を2つ書きます。選択肢ごとに、字下げしたかたまりを書きます。

    label start:
        "洋館の前に着いた。"
        menu:
            "庭を調べる。":
                "庭を歩いた。"
            "裏口へ回る。":
                "裏口へ向かった。"
    
  3. 選んだ結果を覚えたい選択肢のかたまりに、$ で始まる行を書いて、変数を変えます。

            "庭を調べる。":
                $ key_found = True
                "庭で鍵を見つけた。"
    
  4. もう片方の選択肢のかたまりには jump 文を書き、移る先を label 文で作って、別の場面を書きます。場面の終わりに jump hall を書くと、menu 文のあとの場面に合流します。

            "裏口へ回る。":
                jump back_door
    
    label hall:
        "広間に入った。"
        return
    
    label back_door:
        "裏口から入った。"
        jump hall
    
  5. 後半の label hall: で if 文を書き、変数の値で終わり方を分けます。

    label hall:
        "広間に入った。"
        if key_found:
            "鍵で地下室の扉を開けた。"
        else:
            "地下室の扉は開かなかった。"
        return
    
  6. 広間の場面を選択肢にして、鍵を見つけたときだけ出る選択肢を足します。

    label hall:
        "広間に入った。"
        menu:
            "広間を見回す。":
                "何も見つからなかった。"
            "地下室の扉を開ける。" if key_found:
                "鍵で扉を開けた。"
        return
    

ティラノスクリプトで選択肢を付ける手順

同じ短い場面を、ティラノスクリプトで書きます。

  1. シナリオファイルの先頭で、[eval] を使い、f. で始まる変数に初めの値を入れます。

    [eval exp="f.key_found = false"]
    
  2. 選択肢を [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]
    
  3. 選択肢のあとに [s] を書きます。[s] はシナリオの実行を止め、プレイヤーの選択を待ちます。

    [s]
    
  4. 受け先を * を付けたラベルで作り、選ばれたときの変数を [eval] で変えます。

    *garden
    [eval exp="f.key_found = true"]
    庭で鍵を見つけた。[p]
    
    *backdoor
    裏口から入った。[p]
    
  5. 各ラベルの終わりに [jump] を書き、同じラベルへ合流させます。

    *garden
    [eval exp="f.key_found = true"]
    庭で鍵を見つけた。[p]
    [jump target=*hall]
    
    *backdoor
    裏口から入った。[p]
    [jump target=*hall]
    
  6. 合流したあとの *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 のものです。

次に読む

どこまで作るかを決める話は、ゲームの大きさの決め方にあります。

情報源

このページに出た言葉

用語辞典に載っている言葉は、このページには出ていません。

このページの内容の誤りは、問い合わせの窓口で受け付けています。