# ルーム変数

## 全てのキャラクターに適用される変数を設定したい

判定に関係する値など、シナリオ中キャラクター全員に関わる変数を管理したい場合、ルーム変数機能が便利です。

***

### ルーム変数の設定・削除

左上のルーム名をクリックした時に出るメニューで**「ルーム変数」**をクリックすると、ルーム変数設定画面が表示されます。

<figure><img src="/files/ijy9rOJHA5RoC1eBg21W" alt="" width="563"><figcaption></figcaption></figure>

右上&#x306E;**＋ボタン**をクリックし、ラベルと値を記入します。

<figure><img src="/files/BIU7yCmiG7iNm3sDpXhS" alt="" width="563"><figcaption></figcaption></figure>

ルーム変数を削除したい場合、右上&#x306E;**－ボタン**をクリックしてください。

{% hint style="info" %}

#### ルーム変数をコマンドで設定・変更する

`/ var [ラベル] ［値］`とチャット欄に入力して送信すると、設定画面を開かなくてもルーム変数の新規作成や値の変更ができます。

例えば、変数が設定されていない状態で`/ var 強度 3`と入力すると、上の画像と同じルーム変数が設定されます。さらに`/ var 強度 5`と入力すると、ルーム変数{強度}の値が5に変更されます。

また、**`/ var [ラベル]`** と入力すると、指定されたラベルが削除されます。
{% endhint %}

{% hint style="info" %}

#### クリックアクションの利用

コマンドを毎回チャット欄に入力して送信するのは手間だという場合、クリックアクションにコマンドを設定したスクリーンパネルを準備しておくといいでしょう。\
[クリックアクション](/gm-tutorial/screen-panel.md#clickaction)の項目も参考に設定してみてください。
{% endhint %}

***

### ルーム変数の利用

ルーム変数編集画面を閉じ、チャット欄に{ラベル}と打ち込んで送信すると、設定した値を呼び出すことができます。

<figure><img src="/files/aqFnOkw4wOiNW3gJPkwS" alt="" width="419"><figcaption></figcaption></figure>

上の画像のように入力して送信すると、チャットに値が出力されます。

<figure><img src="/files/H35uRiR1ZN4XNDTnoUBr" alt="" width="401"><figcaption></figcaption></figure>

例えば、1d20を振り**変動する目標値以上**の値が出ると成功する判定がシナリオ中にたくさんある場合、次のように準備してみてください。

プレイヤー側の準備\
チャットパレットに以下のコマンドを追加しておく\
`1d20>={目標値}`

ルームマスター側の準備\
判定ごとに{目標値}というルーム変数の値を変更する

判定の際にプレイヤーが`1d20>={目標値}`をチャットパレットから呼び出せば、判定の時短になると同時に、ダイスロールの成功・失敗が一目で分かるようになります。

{% hint style="info" %}

#### ステータス・パラメータ・ルーム変数の優先順

この3機能で設定する値は、ルームチャットで{ラベル}を入力すると呼び出すことができます。ステータス、パラメータ、ルーム変数のうち2つ以上に同じラベル名を設定した場合、呼び出される値の優先順は

①ルーム変数\
②ステータス\
③パラメータ

となっています。

例えば、ルーム変数とステータスに同じラベルの変数を設定した場合、ルーム変数に設定した値が呼び出されます。
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ccfolia.com/gm-only/room-option/room-variable.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.