# Crowd Event

<figure><img src="https://1963719226-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FV8pr5EgDZn2rnTUJE8XB%2Fuploads%2FkfFyW9GgtNZK85IZjtI5%2FCrowd%20event.gif?alt=media&#x26;token=620721e1-31a3-49cb-bc05-de2ac5a3b738" alt=""><figcaption><p>協力して目標を達成<br>メッセージトリガーやエモートを通じて制限時間内に協力してポイントを獲得し目標を達成します。</p></figcaption></figure>

{% hint style="info" %}
[**シングルプレイヤーとマルチプレイヤーのロジックを制作**](https://docs.sandbox.game/jp/creators/game-maker/creative-guide/game-rule-guide/build-singleplayer-and-multiplayer-logic)のページでも<mark style="color:green;">**\[SP]**</mark> や <mark style="color:orange;">**\[MP]**</mark> のビヘイビアやコンポーネントの使い方をご紹介しています。
{% endhint %}

## ![](https://docs.sandbox.game/~gitbook/image?url=https%3A%2F%2F331512196-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F83PS3g9zpWmq73xzlwFn%252Fuploads%252FizFashbEIBUVyp77m67a%252Fimage.png%3Falt%3Dmedia%26token%3Db9de7192-0ac4-4c58-8002-736a0cd50d85\&width=300\&dpr=4\&quality=100\&sign=44a2cd5f\&sv=2) **Crowd Event のビヘイビア&#x20;**<mark style="color:orange;">**\[MP]**</mark>

* ポイントシステムを使って**目標を設定**できます。オプションで制限時間を設定することもできます。
* **ポイントソース**としてメッセージやエモートを使ったり、自動ポイント生成などを使ってポイント獲得ができる**複数のエレメントを作成**できます。
* VFX を使って**プレイヤーに報酬を与える**ことができます。
* ビヘイビアの**ターゲット**を体験内のすべてのプレイヤーやレンジ内のプレイヤーに設定できます。

### おすすめの使い方

* 宝探しでオープンエリアでのアイテム探しや隠れたアイテムを探す設定ができます。
* VFX を使って一度きりのメッセージを使って制限時間内で一番早くポイントをトリガーした人をハイライトできます。（例：プラットフォームをOn にする、ドアを開けるなど）
* プレイヤーがどちらかのサイドを選択し、相手側のスペースにある収集可能なアイテムが自分側にあるスペースで検知されることで進行状況がトリガーされるようなゲームを作成できます。
* コンサートのような体験で、プレイヤーが同時にダンスをして、パフォーマンス中にVFX を使って盛り上げることができます。

### コミュニケーション

<table data-header-hidden><thead><tr><th width="326"></th><th></th></tr></thead><tbody><tr><td><p><strong>インプット：</strong></p><p>エレメントに対して1 つ以上のメッセージ</p></td><td><p><strong>アウトプット：</strong></p><p>ポイントが上がったり、プレイヤーに対して様々なUI を使ったフィードバックを行うことができます。（アバター適用できるVFX も含みます）</p></td></tr></tbody></table>

<img src="https://content.gitbook.com/content/V8pr5EgDZn2rnTUJE8XB/blobs/WeWGbi4UIX79spKSJjls/file.excalidraw.svg" alt="" class="gitbook-drawing">

### パラメーター

<table><thead><tr><th width="371">オプション</th><th>詳細</th></tr></thead><tbody><tr><td><img src="https://content.gitbook.com/content/V8pr5EgDZn2rnTUJE8XB/blobs/W5GtSd8vqpBKuyJ1pWCC/image.png" alt=""><br><br><img src="https://content.gitbook.com/content/V8pr5EgDZn2rnTUJE8XB/blobs/PBSVIkgtCCCqBdDO95Rv/image.png" alt=""><br><img src="https://content.gitbook.com/content/V8pr5EgDZn2rnTUJE8XB/blobs/BkyqXz5JIB7FtbFfyido/image.png" alt=""></td><td><p><strong>Display Title</strong> - <strong>True</strong> に設定すると以下に入力するEvent Title が表示されます。</p><p><br><strong>Event Title</strong> - タイトルとして表示されるテキストを入力します。<br><br><strong>Color</strong> - カラーバーをクリックするとカラーピッカーが開きます。テキストに使用したいカラーを選択し、設定できます。<br><br>ヒント<br>Color のパラメーターはパラメーターのリストの下部（UI Style の下）に表示されますのでスクロールして確認してください。<br></p><p>例：<br>Crowed Event と入力した場合のタイトル</p><p><img src="https://content.gitbook.com/content/V8pr5EgDZn2rnTUJE8XB/blobs/FdxroyPkWFOUOVGe8kXO/Crowd%20Event_Title_Music.gif" alt="" data-size="original"></p></td></tr><tr><td><img src="https://content.gitbook.com/content/V8pr5EgDZn2rnTUJE8XB/blobs/YYefPhojipBXvAMN1mDJ/image.png" alt=""><br><br><img src="https://content.gitbook.com/content/V8pr5EgDZn2rnTUJE8XB/blobs/pfEZO3OBYERDikwMnfPO/image.png" alt=""><br></td><td><p><strong>Event Target</strong> - 閲覧可能なプレイヤーやイベントに貢献できるプレイヤー、報酬を受け取れるプレイヤーを設定できます。</p><ul><li><strong>Experience</strong> - 体験内のすべてのプレイヤーがグループイベントに参加できます。</li><li><strong>Everyone in range</strong> </li></ul><p><strong>Event Range</strong> - プレイヤーがイベントの進捗状況に貢献するためにいなければならないグループイベントのオブジェクトからの距離をスライダーを使って1 から100 までの間で設定できます。</p><p><br>ヒント<br>プレイヤーはレンジから出たり、再度入ることもできます。<br><br>例：<br><img src="https://content.gitbook.com/content/V8pr5EgDZn2rnTUJE8XB/blobs/bOSZAzRvZkn0oQoRcAqG/gm%20Crowd%20Event_Range.gif" alt="" data-size="original"></p></td></tr><tr><td><img src="https://content.gitbook.com/content/V8pr5EgDZn2rnTUJE8XB/blobs/vMGRlKNBj4AS26r4TYea/image.png" alt=""></td><td><strong>Message to Start</strong> - グループイベントの開始をトリガーする1 つ以上のメッセージを設定できます。</td></tr><tr><td><img src="https://content.gitbook.com/content/V8pr5EgDZn2rnTUJE8XB/blobs/XUS4tQrgDrQQol6ATsyg/image.png" alt=""></td><td><strong>Message to Cancel</strong> - グループイベントのキャンセルをトリガーする1 つ以上のメッセージを設定できます。</td></tr><tr><td><br><img src="https://content.gitbook.com/content/V8pr5EgDZn2rnTUJE8XB/blobs/XcSva7opFFngRqEgRl5j/image.png" alt=""></td><td><p><strong>Total Points (Goal)</strong> - グループイベントをクリアするために必要な合計ポイントを設定できます。</p><p></p><p>ヒント</p><p>目標達成までにかかる時間はイベントに参加しているプレイヤーの人数やプレイヤーがトリガーするポイントによって変わります。.</p></td></tr><tr><td><img src="https://content.gitbook.com/content/V8pr5EgDZn2rnTUJE8XB/blobs/YKWji5daslgIFRWPIXsp/image.png" alt=""><br><br><img src="https://content.gitbook.com/content/V8pr5EgDZn2rnTUJE8XB/blobs/JsmAkKlXox50yJq1WamL/image.png" alt=""></td><td><p><strong>Auto Progression</strong></p><ul><li><strong>False</strong> - プレイヤーのアクションによってイベントが進行します。</li><li><strong>True</strong> - プレイヤーのアクションに関わらず5秒ごとにイベントが進行します。</li></ul><p><strong>Point every 5secs</strong> - Auto Progression で5秒ごとに入力したポイントが獲得できるように設定できます。</p></td></tr><tr><td><img src="https://content.gitbook.com/content/V8pr5EgDZn2rnTUJE8XB/blobs/KttfKslGILvNpfOYht0p/image.png" alt=""><br><br><img src="https://content.gitbook.com/content/V8pr5EgDZn2rnTUJE8XB/blobs/zCQlRl0ftdkfSpDbdbrM/image.png" alt=""></td><td><p><strong>UI Style</strong> - Event Title のグラフィックやプログレスバーの見た目を選択できます。.</p><ul><li><strong>Default</strong> - イベントタイトルの周りに白いキューブが追加され、デフォルトのプログレスバーを使用します。</li></ul><p><img src="https://content.gitbook.com/content/V8pr5EgDZn2rnTUJE8XB/blobs/TTmhdhtYkFU0kR392Fw7/image.png" alt=""></p><ul><li><strong>Music</strong> - イベントタイトルに音楽とプログレスバーの上にサウンドバーが追加されます。</li></ul><p><img src="https://content.gitbook.com/content/V8pr5EgDZn2rnTUJE8XB/blobs/Fu2SPRVqVsRxw5vRpXN8/image.png" alt=""></p></td></tr><tr><td><img src="https://content.gitbook.com/content/V8pr5EgDZn2rnTUJE8XB/blobs/DqD0o9pbr6577Ij2yjdR/image.png" alt=""></td><td><p><strong>Success Message</strong> - プログレスバーに表示されている合計ポイントをすべて獲得し、グループイベントをクリアするとメッセージを表示できます。<br><br>例：</p><p><img src="https://content.gitbook.com/content/V8pr5EgDZn2rnTUJE8XB/blobs/nd72EmYkJm8py76M5DQ7/gm%20Crowd%20Event_Completed.gif" alt="" data-size="original"><br><br>ヒント：<br>このパラメーターで表示されるUI は変更できません。</p></td></tr><tr><td><img src="https://content.gitbook.com/content/V8pr5EgDZn2rnTUJE8XB/blobs/MKUkKGa1diHEeiW3HVDu/image.png" alt=""></td><td><p><strong>Failed Message</strong> - プログレスバーに表示された合計ポイントが獲得できず、左に表示される時間制限を過ぎてしまった場合、イベントクリアが失敗したというメッセージを表示できます。</p><p></p><p>例：</p><p><img src="https://content.gitbook.com/content/V8pr5EgDZn2rnTUJE8XB/blobs/43IjpyhBHCxD9h7xYYJB/gm%20Crowd%20Event_Failed.gif" alt="" data-size="original"><br><br>ヒント<br>制限時間内にクリアできなかった場合、UI はフェードアウトし、グループイベントのクリア失敗となります。</p></td></tr><tr><td><img src="https://content.gitbook.com/content/V8pr5EgDZn2rnTUJE8XB/blobs/B2GLY9gTxypHtB6RBYCg/image.png" alt=""></td><td><p><strong>Reward VFX</strong> - 合計ポイントを獲得するとプレイヤーのアバターに適用されるビジュアルエフェクトを設定できます。<br></p><p>例：</p><p><img src="https://content.gitbook.com/content/V8pr5EgDZn2rnTUJE8XB/blobs/6JmRn0Ejprb98PdZAaAj/gm%20Crowd%20Event_VFX%20Reward.gif" alt="" data-size="original"></p></td></tr><tr><td><img src="https://content.gitbook.com/content/V8pr5EgDZn2rnTUJE8XB/blobs/KJzkjblCFZO9FzofSOyg/image.png" alt=""><br><br><img src="https://content.gitbook.com/content/V8pr5EgDZn2rnTUJE8XB/blobs/YuPDva2Jf9LxKJcS9uOi/image.png" alt=""></td><td><p><strong>Apply VFX to Participants</strong></p><ul><li><strong>False</strong> - apply the chosen VFX to all players experiencing the Crowd Event.</li><li><strong>True</strong> - apply the chosen VFX to only players who contributed to the <strong>Total Points (Goal)</strong>.</li></ul></td></tr><tr><td><img src="https://content.gitbook.com/content/V8pr5EgDZn2rnTUJE8XB/blobs/tT54Nffod6fBn5GVjVRb/image.png" alt=""><br><br><img src="https://content.gitbook.com/content/V8pr5EgDZn2rnTUJE8XB/blobs/NcC4ch34HmBIeGbj9smX/image.png" alt=""></td><td><p><strong>Apply VFX in Range</strong></p><ul><li><strong>False</strong> - 選択したVFX をグループイベントに参加しているすべてのプレイヤーに設定できます。</li><li><strong>True</strong> - 選択したVFX を合計ポイントに貢献したプレイヤーのみに設定できます。</li></ul><p>ヒント<br>このパラメーターはグループイベントが<strong>Event Target</strong> の欄で体験全体に設定されている場合は表示されません。</p></td></tr><tr><td><img src="https://content.gitbook.com/content/V8pr5EgDZn2rnTUJE8XB/blobs/hhBJYzvK6iZW0k9tD14I/image.png" alt=""></td><td><strong>VFX Duration (secs)</strong> - 選択したVFX がプレイヤーのアバターに表示される時間を秒単位で設定できます。</td></tr><tr><td><img src="https://content.gitbook.com/content/V8pr5EgDZn2rnTUJE8XB/blobs/9FPuT8JVChOcHmUwhpDm/image.png" alt=""></td><td><p><strong>Offset</strong> と<strong>Rotation</strong> - <mark style="color:red;"><strong>X</strong></mark>、<mark style="color:green;"><strong>Y</strong></mark>、<mark style="color:blue;"><strong>Z</strong></mark> 軸の座標を使ってプレイヤーのアバターに関連したVFX の位置や回転をカスタマイズできます。<br><br>ヒント<br><mark style="color:red;"><strong>X</strong></mark>、<mark style="color:green;"><strong>Y</strong></mark>、<mark style="color:blue;"><strong>Z</strong></mark> 軸すべてが0 に設定されている場合、VFX はアバターの足元に表示されます。<br><br>ヒント<br>アバターの背の高さはそれぞれ異なります。<mark style="color:red;"><strong>X</strong></mark>=0、<mark style="color:green;"><strong>Y</strong></mark>=2、<mark style="color:blue;"><strong>Z</strong></mark>=0 の場合、VFX は中型人間のアバターの頭上に表示されます。</p><p><br>例：</p><p><img src="https://content.gitbook.com/content/V8pr5EgDZn2rnTUJE8XB/blobs/iY04OgIajur4R7iipCac/gm%20Crowd%20Event_FIRE%20VFX_Feet+Head.gif" alt="" data-size="original"></p></td></tr><tr><td><img src="https://content.gitbook.com/content/V8pr5EgDZn2rnTUJE8XB/blobs/QoJSwyznFMTkCmup9Um2/image.png" alt=""></td><td><p><strong>Emote Point Sources</strong> - プレイヤーがトリガーしてポイントを獲得できるエモートのエレメントのリストです。それぞれのエレメントには固有の変数値が含まれています。</p><p><br><img src="https://content.gitbook.com/content/V8pr5EgDZn2rnTUJE8XB/blobs/AhBjuX0UZWHzHwQERaYc/image.png" alt=""> エモートのエレメントが非表示の状態です。<br><img src="https://content.gitbook.com/content/V8pr5EgDZn2rnTUJE8XB/blobs/YmjOJgGBgSCSQjwiTXoZ/image.png" alt=""> エモートのエレメントは表示されています。<br><br><img src="https://content.gitbook.com/content/V8pr5EgDZn2rnTUJE8XB/blobs/bLwHMg82WiWwLXnPjM1X/image.png" alt=""> をクリックしてエモートのエレメントを削除できます。<br><br>ヒント<br>以下のパラメーターはこのビヘイビアに追加されたエレメントにのみ設定できます。r.</p></td></tr><tr><td><img src="https://content.gitbook.com/content/V8pr5EgDZn2rnTUJE8XB/blobs/QdinedrHQfQSY2cXuDqa/image.png" alt=""></td><td><strong>Instructions</strong> - それぞれのイベントステージで必要なものをテキストとしてプログレスバーの下に表示できます。</td></tr><tr><td><img src="https://content.gitbook.com/content/V8pr5EgDZn2rnTUJE8XB/blobs/n8gQsLqBIrGLHvrVc8Hl/image.png" alt=""><br><br><img src="https://content.gitbook.com/content/V8pr5EgDZn2rnTUJE8XB/blobs/GHlBTRb9Rg2YfCrDvDxu/image.png" alt=""></td><td><p><br><br><strong>Source Type</strong> - </p><ul><li><strong>Emote</strong> - ポイントを獲得するためにプレイヤーができるエモートを選択できます。</li><li><strong>Message</strong> - ポイント獲得に必要なメッセージを設定できます。（メッセージは様々なロジックソースから取得可能）</li></ul></td></tr><tr><td><img src="https://content.gitbook.com/content/V8pr5EgDZn2rnTUJE8XB/blobs/pEDB2ARCclRfbG6A8tkr/image.png" alt=""></td><td><strong>Points</strong> - 獲得したポイントを設定し、ポイントをプログレスバーに追加できます。<br><br>ヒント<br>現在のところ受けとったポイントの表示をカスタマイズすることはできません。.<br><br>ポイント<br><strong>合計ポイント</strong>や<strong>参加するプレイヤーの数</strong>などを考慮に入れながら、クリアタイム内にクリアできるようにしましょう。</td></tr><tr><td><img src="https://content.gitbook.com/content/V8pr5EgDZn2rnTUJE8XB/blobs/Hh0N7MPEM2on4SD3kGX7/image.png" alt=""></td><td><strong>Frequency</strong> - 上の<strong>Source Type</strong> がEmote に設定されている場合、一秒あたりのポイント獲得頻度を設定できます。<br><br>例：<br><img src="https://content.gitbook.com/content/V8pr5EgDZn2rnTUJE8XB/blobs/WHggYbMsn0DXy11nJZi1/gm%20Crowd%20Event_Points_Frequency.gif" alt="" data-size="original"></td></tr><tr><td><img src="https://content.gitbook.com/content/V8pr5EgDZn2rnTUJE8XB/blobs/s2NLlpMrxx9PG7U8OMJS/image.png" alt=""></td><td><p><strong>Duration</strong> - ポイントソースとしてのエレメントの有効時間を設定できます。プログレスバーの左側にダイアモンドの形で表示されます。</p><p><br>ヒント：<br>有効時間が終了すると次のエレメントが有効になります。エレメントがなくなるとグループイベントは終了します。<br></p><p>例：<br><img src="https://content.gitbook.com/content/V8pr5EgDZn2rnTUJE8XB/blobs/pR0HUz660pufHhqjYQxk/gm%20Crowd%20Event_Points_Duration.gif" alt="" data-size="original"></p></td></tr><tr><td><img src="https://content.gitbook.com/content/V8pr5EgDZn2rnTUJE8XB/blobs/4METLZmdfzOfsENLrbBY/image.png" alt=""></td><td><p><strong>ADD EMOTE POINT SOURCE +</strong> - 前のエレメントをクリアしたり、前のエレメントの有効時間が過ぎた後にトリガーする固有の変数値を持った他のエレメントをCrowd Event のビヘイビアに追加できます。<br></p><p>エレメントは、グループイベントをクリアするためにプレイヤーが行う様々なアクションやオブジェクティブを作成するためにスタック（重ねる）することができます。</p></td></tr></tbody></table>


---

# 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.sandbox.game/jp/creators/game-maker/document/behavior/crowd-event.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.
