# Actor Property Switcher

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

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

## <img src="https://331512196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F83PS3g9zpWmq73xzlwFn%2Fuploads%2FsWIfpoYEqdyQbWT8SVOe%2Fimage.png?alt=media&#x26;token=f42e93a9-92de-4422-b31f-6b66f39559b0" alt="" data-size="original"> Actor Property Switcher <mark style="color:yellow;">\[MP]</mark>

Target general or specific objects and change their visibility, collisions, Indicator UI, or all.

### Common Uses

* Performance: Change properties of objects without destroying them and spawning new ones
* Control visibility of Indicator text, arrows, etc of target objects
* <mark style="background-color:yellow;">New in 0.11</mark> - Add or remove an object's or player's tags during gameplay

***

## How it Works

### Trigger: <img src="https://331512196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F83PS3g9zpWmq73xzlwFn%2Fuploads%2FOIwcqqUbe1AR4xFkyW7R%2FMessages%20voxel%20icon.png?alt=media&#x26;token=20120bd2-80d7-4e3c-a18e-8586db076877" alt="" data-size="line"> Multiple messages in

### Action: Changes Properties of Targets

<table data-card-size="large" data-view="cards" data-full-width="false"><thead><tr><th></th><th></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><ul><li>Collisions</li><li>Visibility</li><li>All</li><li>Tags - <em><mark style="background-color:yellow;">New in Game Maker 0.11</mark></em></li></ul></td><td></td><td><a href="https://331512196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F83PS3g9zpWmq73xzlwFn%2Fuploads%2FNMzFJrQxAxvwQzoL6bMA%2FGM%20actor%20property%20switcher%20examples.gif?alt=media&#x26;token=aad63266-47ea-4cb4-8106-1760b312ad8d">GM actor property switcher examples.gif</a></td></tr><tr><td><ul><li>UI Visibility <br>(for the target's <a href="../../components/display/indicator"><strong>Indicator</strong></a> component)</li></ul></td><td>Game Maker 0.10</td><td><a href="https://331512196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F83PS3g9zpWmq73xzlwFn%2Fuploads%2FWljBafgDSvNKbbHRB5GK%2FGM%200.10%20actor%20property%20beh%20visiblity%20of%20indicator%20UI.gif?alt=media&#x26;token=9d47c38c-6906-4842-b425-59e54fd7eea7">GM 0.10 actor property beh visiblity of indicator UI.gif</a></td></tr></tbody></table>

### Activation Type: Fixed or Toggle

* **Fixed** - switch once
* **Toggle** - switch repeatedly on/off

### Filter Modes (Target): 3 Options

<table data-view="cards" data-full-width="true"><thead><tr><th></th><th></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><strong>EveryoneInRange</strong></td><td>All objects near this object</td><td><a href="https://331512196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F83PS3g9zpWmq73xzlwFn%2Fuploads%2F0PVRSwTW8YU6Toy2LRwc%2FGM%20actor%20property%20visibility%20in%20range.gif?alt=media&#x26;token=4113a3a8-418a-4ed5-b739-6e2e537cbedc">GM actor property visibility in range.gif</a></td></tr><tr><td><strong>SpecificTagsInRange</strong></td><td>All objects with specific tags near this object</td><td><a href="https://331512196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F83PS3g9zpWmq73xzlwFn%2Fuploads%2FOLLalrrWistfO2skWx29%2FGM%20actor%20property%20visiblity%20specifictagsinrange%20ex.gif?alt=media&#x26;token=ccdb54bc-6bdd-4aac-95c3-6aaa21e4069c">GM beh actor property vis tagsinrange ex.gif</a></td></tr><tr><td><strong>SelectedActors</strong></td><td>Specific target objects in the Experience (any location)</td><td><a href="https://331512196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F83PS3g9zpWmq73xzlwFn%2Fuploads%2FkhLdUfWvY5phPzFdzGgQ%2FGM%20actor%20property%20visiblity%20selectedactors%20ex.gif?alt=media&#x26;token=fe44b78a-049a-4679-a34f-9fef4e6671af">GM beh actor property vis selectedactors ex.gif</a></td></tr></tbody></table>

### Out: No messages sent

## Parameter Notes

<figure><img src="https://331512196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F83PS3g9zpWmq73xzlwFn%2Fuploads%2FvLkOgZM55Gfl7bOLCn3D%2Fimage.png?alt=media&#x26;token=4411099a-ff50-41ed-a317-a0886e569983" alt=""><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.sandbox.game/en/creator/game-maker/docs/behaviours/modifiers/actor-property-switcher.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.