# Message Broadcaster

{% 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 %}

## ![](/files/Jri9cUSspEeSZWDzFN1e) 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                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| ------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ![](/files/mBCkovBVEERZ5Zywxjxb)                                                                        | **Message to Send** - Use a message from the menu or create your own message to send.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| ![](/files/ue5COsvqjObYOTFlo7MC)                                                                        | <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>                                                                                                                                                                               |
| ![](/files/IjZMeCERdhoJ2tG2Rw7G)                                                                        | <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> |
| ![](/files/1gz4CQRLwdsEOOS2Wmxi)                                                                        | <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>                                                                                                                                                                                                                                                                                                                                            |
| ![](/files/ox491tMAAJBD8Zkmbj1J)                                                                        | **Broadcast Type** (All) - Send messages to all Objects in your experience.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| <p><img src="/files/2OJCgUMXmZjODSzSYn94" alt=""><br><img src="/files/MTnndaNsifKbhHnO4T8B" 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>                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| ![](/files/039Yjc9MO1COiwDz8TW2)                                                                        | <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>                                                                                                                                                                                                                                                                                                                    |
| ![](/files/FdEXpdEvF9bGGXH3GL1p)                                                                        | **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: 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/en/creator/game-maker/docs/behaviours/basic-logic/message-broadcaster.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.
