> For the complete documentation index, see [llms.txt](https://docs.sandbox.game/en/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sandbox.game/en/creator/game-maker/docs/behaviours/basic-logic/message-broadcaster.md).

# Message Broadcaster

Sends a message to activate another event.

{% hint style="success" %}
**COPY/PASTE PARAMETERS**

New in GM 0.11! Right click on a behaviour or component to copy. Then open an object, add the same behaviour or component, and right click it to paste identical parameter settings.
{% endhint %}

<figure><img src="https://4251931498-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MO_j99BJEXK4zHqxgqS%2F-MOyXAfkTKWtuO7kfe6T%2F-MOymhzvVIU0cTNmc3SR%2FMessage.gif?alt=media&#x26;token=31276d02-0150-4637-9609-9041b2ef7088" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
[Build Singleplayer & Multiplayer Logic](/en/creator/game-maker/docs/build-singleplayer-and-multiplayer-logic.md) - about <mark style="color:green;">**\[SP]**</mark> or <mark style="color:yellow;">**\[MP]**</mark> behaviours or components.
{% endhint %}

## ![](https://331512196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F83PS3g9zpWmq73xzlwFn%2Fuploads%2FMCA92TOyZneFFIutx5KH%2Fimage.png?alt=media\&token=b9f2505e-86c4-43b5-91bb-37464505f746) Message Broadcaster <mark style="color:green;">\[SP]</mark> <mark style="color:yellow;">\[MP]</mark>

* Broadcast a message from the asset in a specific range - When you broadcast a message, you can trigger events the same way a button works (broadcast a message opening a door) - Can detect a target to create specific trigger conditions

## Parameters

| Options                                                                                                                                                                                                                                     | Details                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ![](https://content.gitbook.com/content/83PS3g9zpWmq73xzlwFn/blobs/X4Sm0caQmowNeqFMGZOr/image.png)                                                                                                                                          | **Message to Send** - Use a message from the menu or create your own message to send.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| ![](https://content.gitbook.com/content/83PS3g9zpWmq73xzlwFn/blobs/7axLXBA8pnyjiLwWyVpM/image.png)                                                                                                                                          | <p><strong>Broadcast Type</strong> (everyone in range) - This option sets your Message Broadcaster to send messages to all objects in range.<br><br><em><mark style="color:green;"><strong>Broadcast Range</strong></mark></em> (slider) - defines the area in which your message broadcaster will send messages.<br><br>This parameter is visualised with a <mark style="color:yellow;"><strong>yellow</strong></mark> circle Gizmo that adjusts as you move the slider or change the value.<br></p>                                                                                                                                                                               |
| ![](https://content.gitbook.com/content/83PS3g9zpWmq73xzlwFn/blobs/QQBNCVUReQmihWtlXT0A/image.png)                                                                                                                                          | <p><strong>Broadcast Type</strong> (Specific Tags in Range) - This option sets your Message Broadcaster to send messages to all objects in range with the specified tag(s).<br><br><em><mark style="color:green;"><strong>Broadcast Range</strong></mark></em> (slider) - defines the area in which your message broadcaster will send messages.<br><br>This parameter is visualised with a <mark style="color:yellow;"><strong>yellow</strong></mark> circle Gizmo that adjusts as you move the slider or change the value.<br><br><em><mark style="color:green;"><strong>Tags</strong></mark></em> - Add or remove tags that the Message Broadcaster should send messages to.</p> |
| ![](https://content.gitbook.com/content/83PS3g9zpWmq73xzlwFn/blobs/UormuzCk5NN5t7hEVYRJ/image.png)                                                                                                                                          | <p><strong>Broadcast Type</strong> (Selected Actors) - This option lets you select a specific Object to send your messages to.<br><br><em><mark style="color:green;"><strong>Targets</strong></mark></em> - Add or remove the Objects that you want the Message Broadcaster to send messages to (must be placed in your experience).</p>                                                                                                                                                                                                                                                                                                                                            |
| ![](https://content.gitbook.com/content/83PS3g9zpWmq73xzlwFn/blobs/2AEeGPDJXPyY6xst0DFs/image.png)                                                                                                                                          | **Broadcast Type** (All) - Send messages to all Objects in your experience.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| <p><img src="https://content.gitbook.com/content/83PS3g9zpWmq73xzlwFn/blobs/XtQgrrJ8v3intNOwFHoI/image.png" alt=""><br><img src="https://content.gitbook.com/content/83PS3g9zpWmq73xzlwFn/blobs/s9Ms7DzdFhEPQRjNMeVE/image.png" alt=""></p> | <p><strong>Duration Type</strong><br><strong>Once</strong> - one time<br><strong>Duration</strong> - set amount of time in seconds and delay between broadcasts<br><strong>Forever</strong> - broadcast forever with a delay between broadcasts</p>                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| ![](https://content.gitbook.com/content/83PS3g9zpWmq73xzlwFn/blobs/LIqCjrymAz05PUqVQzJ7/image.png)                                                                                                                                          | <p><strong>Wait Before Broadcast</strong> - Toggle on or off to determine if the Message Broadcaster should start broadcasting at the beginning of the game or wait until it receives a message.<br><br><em><mark style="color:green;"><strong>Message Required</strong></mark></em> - Add or remove messages required to activate your Message Broadcaster.</p>                                                                                                                                                                                                                                                                                                                    |
| ![](https://content.gitbook.com/content/83PS3g9zpWmq73xzlwFn/blobs/r9RBzDa2KMGZI72xbL8x/image.png)                                                                                                                                          | **Broadcast Only Once** - Toggle on or off to determine whether your Message Broadcaster should be able to broadcast its messages one or more times.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.sandbox.game/en/creator/game-maker/docs/behaviours/basic-logic/message-broadcaster.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
