> 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/modifiers/actor-property-switcher.md).

# 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 & 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 %}

## <img src="/files/l07xidcolweQFRTEuzHO" 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="/files/MXqo7fq0mdij5mtZvsVz" 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="/files/kB1ypguRMQjnWvRVQM7i">/files/kB1ypguRMQjnWvRVQM7i</a></td></tr><tr><td><ul><li>UI Visibility <br>(for the target's <a href="/pages/XLD2SCxDQl7HejgiYTpq"><strong>Indicator</strong></a> component)</li></ul></td><td>Game Maker 0.10</td><td><a href="/files/ZDRadC1TPe5mqTnDAjB1">/files/ZDRadC1TPe5mqTnDAjB1</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="/files/u8GQdb1JgFgM5qQRTNar">/files/u8GQdb1JgFgM5qQRTNar</a></td></tr><tr><td><strong>SpecificTagsInRange</strong></td><td>All objects with specific tags near this object</td><td><a href="/files/PJNGFWUvNtncv9NdFxcw">/files/PJNGFWUvNtncv9NdFxcw</a></td></tr><tr><td><strong>SelectedActors</strong></td><td>Specific target objects in the Experience (any location)</td><td><a href="/files/isPKbPqgiDOuNI2Somj1">/files/isPKbPqgiDOuNI2Somj1</a></td></tr></tbody></table>

### Out: No messages sent

## Parameter Notes

<figure><img src="/files/7ktAUVQWex4hvEukihTi" alt=""><figcaption></figcaption></figure>


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.sandbox.game/en/creator/game-maker/docs/behaviours/modifiers/actor-property-switcher.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.