# アクション

## アクションの新規作成・種類

左メニューから「アクション」に移動します。

「アクションを追加」をクリックすると、新規作成ができます。

<figure><img src="/files/egwRjxbYGbV4T89j4JQz" alt=""><figcaption></figcaption></figure>

アクションには以下の2種類があります（2024.11.19現在）。

<table><thead><tr><th width="141">名称</th><th>内容</th></tr></thead><tbody><tr><td><a href="#shinpuruakushonno">シンプル</a></td><td>「実行する」を押すだけでアクションが発動する</td></tr><tr><td><a href="#pasuwdoakushonno">パスワード</a></td><td>「実行する」を押すとパスワード入力が求められ、正しいパスワードを入力するとアクションが発動する</td></tr></tbody></table>

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

## 設定できるアクション一覧

2025.12.17現在、以下のアクションが設定できます。

<table><thead><tr><th width="226">項目</th><th>内容</th></tr></thead><tbody><tr><td>通知を送信</td><td>アクション実行時に画面上部にテキストで通知を送ります。</td></tr><tr><td>SE再生</td><td>アクション実行時に効果音を鳴らします。</td></tr><tr><td>BGM再生</td><td>アクション実行時にBGMの再生を開始します。</td></tr><tr><td>BGM停止</td><td>アクション実行時にBGMの再生を停止します。</td></tr><tr><td>ムービー再生</td><td>アクション実行時にムービーを再生します。</td></tr><tr><td>フェーズ遷移</td><td>強制的に特定のフェーズに移行します。<br>例えば、推理発表フェーズなど、1人のプレイヤーの判断で次のフェーズに遷移していい状況で使うのがおすすめです。</td></tr><tr><td>手がかり公開</td><td>特定の手がかりを全体公開します。所有権は渡されません。</td></tr><tr><td>手がかり所有権</td><td>特定の手がかりをキャラクターに配布します。</td></tr><tr><td>手がかり閲覧権</td><td>特定の手がかりの閲覧権をキャラクターに与えます。</td></tr><tr><td>手がかり回収</td><td>特定の手がかりを回収します。</td></tr><tr><td>トークン増減</td><td>特定の人の特定のトークンを増減させます。</td></tr><tr><td>通話ルーム移動</td><td>強制的に特定の通話ルームに移動させます。</td></tr><tr><td>ミュート</td><td>特定のキャラクターを強制ミュートにします。</td></tr></tbody></table>

## シンプルアクションの設定

### アクション編集画面での設定

* **タイトル**：アクションのタイトルです。どのように表示されるかは右側のプレビューで確認します。
* **説明文**：アクションのボタンが「**実行する**」という名前で固定されているので、実行するという文言に合うように説明文を書いてください。
* **アクションの実行条件**：キャラクターの制限だけであればチェックボックスで簡単にできます。その他細かい条件を設定したい場合は「[**高度な設定**](#na)」を利用してください。
* **結果アクション**：「実行する」を押すと何が起こるのかを設定します。画像の例では、実行すると特定の手がかりが配布されるよう設定しています。

<figure><img src="/files/FI8mu9u2PudYgR6Qr1KY" alt=""><figcaption></figcaption></figure>

#### 結果アクションを複数設定する

以下の画像のように、結果アクションを複数設定することができます。

これらは、プレイヤーが「実行する」のボタンを1回押したときに**一連のアクションとして全て実行**されます。上から順番に処理されますので、「手がかりを配布→通知を送る」の順で処理したい場合は、この画面で上からそう並ぶように設定してください。

<figure><img src="/files/wwfkrsLZHxw2sYqYrtm2" alt="" width="515"><figcaption></figcaption></figure>

#### 手がかりのポップアップ表示 <a href="#pop-up" id="pop-up"></a>

アクションで獲得した手がかりをプレイヤーの画面にポップアップで表示したいときは「通知を送信」を設定する必要があります。

詳しくは[こちら](/basic-features/clue.md#pop-up)をご参照ください。

### アクションの配置（手がかり/フェーズでの設定）

アクションは、アクションの編集画面で設定するだけではゲーム中に登場しません。作成したアクションをどこに配置するのかを設定する必要があります。

配置できるのは、「手がかりの中」と「基本フェーズの中」の2ヶ所です。ここでは「手がかりの中」に配置する場合を説明します。「基本フェーズの中」に置く場合の操作は[こちら](#akushonnofzugakarideno-1)をご参照ください。

以下のように、「日記」という手がかりの中に「中身を見る（１ページ目の内容を追加配布する）」というアクションを置きたいとします。

<figure><img src="/files/pJyDFnttsU35vwVVZ4qZ" alt=""><figcaption></figcaption></figure>

①左メニューから「手がかり」に移動します。

②アクションを配置したい手がかりの編集画面に移動します。

③アクション欄の「追加」をクリックします。

④配置したいアクションを選択して決定をクリックします。

<figure><img src="/files/zwce8XY8WB98xQiL5Hjq" alt=""><figcaption></figcaption></figure>

アクション欄に以下のように表示されたら成功です。

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

## パスワードアクションの設定

### アクション編集画面での設定

* **タイトル**：アクションのタイトルです。どのように表示されるかは右側のプレビューで確認します。
* **説明文**：アクションのボタンが「**実行する**」という名前で固定されているので、実行するという文言に合うように説明文を書いてください。
* **回答**：パスワードの正解を入力します。カンマ区切りで表記揺れなど複数設定することができます。空白スペースは無視されます。
  * 回答タブを追加すると「おはよう」と入力されたら「おはよう」と返し、「こんにちは」と入力されたら「こんにちは」と返すような入力内容ごとの反応を設定することもできます。
* **アクションの実行条件**：キャラクターの制限だけであればチェックボックスで簡単にできます。その他細かい条件を設定したい場合は「[**高度な設定**](#na)」を利用してください。
* **結果アクション**：「実行する」を押すと何が起こるのかを設定します。パスワードを正しく入力できた場合とできなかった場合に分かれています。
  * **共通タブ**：正答の回答タブを複数設定しており、それらに共通した結果アクションがある場合は共通タブに設定します。例えば正答の回答を入力すると、まず効果音が鳴り、その後は入力内容ごとにアクションが分かれる場合、共通タブに「効果音」を設定し、回答１以降にそれぞれの結果アクションを設定するとよいでしょう。

<figure><img src="/files/rIVHUSXrXTLXvnfO6Mfk" alt=""><figcaption></figcaption></figure>

画像の例における、結果アクションの中身はそれぞれ以下のようになっています。

<figure><img src="/files/jf3bJ7NNrh1ndd4hYCwc" alt=""><figcaption></figcaption></figure>

### アクションの配置（手がかり/フェーズでの設定）

アクションは、アクションの編集画面で設定するだけではゲーム中に登場しません。作成したアクションをどこに配置するのかを設定する必要があります。

配置できるのは、「手がかりの中」と「基本フェーズの中」の2ヶ所です。ここでは「基本フェーズの中」に配置する場合を説明します。「手がかりの中」に置く場合の操作は[こちら](#akushonnogakarifzudeno)をご参照ください。

以下のように「議論フェーズ」に、パスワードで金庫を開けられるアクションを配置したいとします。

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

①左メニューから「フェーズ」に移動します。

②アクションを配置したい手がかりの「基本フェーズ（議論フェーズなど）」に移動します。

③フェーズの内容の下部にある「追加」ボタンをクリックします。

④「アクション」を選択します。

⑤該当のアクションにチェックを入れて「決定」をクリックします。

<figure><img src="/files/GDfNgu5kTuX3iSfPZwq5" alt=""><figcaption></figcaption></figure>

以下のように適切に追加されたら成功です。

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

## 発展編：実行条件の高度な設定

シンプルアクションとパスワードアクション両方で使用できる、高度な条件設定について解説します。

### アクションの実行を１回に制限したい

特に条件を設定しなければ、アクションは成功後も誰でも何回でも実行できてしまいます。

例えば、「実行する」で特定の手がかりを実行者に配布する設定にしていた場合、Ａさん実行後にＢさんが実行すると、手がかりはＡさんの手元から消え、Ｂさんの手元に移ります（アクションの実行が上書きされるため）。

そういった状況を回避したいときは、アクションの実行が成功したら、それ以降はアクションを実行できないような条件を設定する必要があります。設定の例を画像で示します。

**シンプルアクションの場合**

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

**パスワードアクションの場合**

上記のシンプルアクションと同じように設定してしまうと、パスワード入力に誤答した場合でも「実行した」と判断され、それ以降は誰も入力にチャレンジできなくなってしまうので、少し設定に工夫が必要です。

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

### その他の制限

「あるフェーズの進行中のみ」、「ある通話ルームにいるときのみ」、「ある手がかりを持っている人のみ」などの条件を設定することもできます。

シナリオの内容に合わせてご活用ください。


---

# 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.studio.uzu-app.com/basic-features/action.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.
