# Toggle Creator

#### Setup

* **Avatar** accepts an avatar descriptor. The script will automatically try to find an avatar in your scene
  * If more than one active avatar is found they'll be presented as a list to select the one you want
* **Object to Toggle** accepts an object parented to the avatar. The animation created will enable/disable this object
  * There’s a **+** button at the left of Object to Toggle. When it’s hit a **new Object to Toggle** slot will be added
    * There can be as many Objects To Toggle as you want
* **Menu** accepts a VRChat menu asset. A new toggle control will be added to this menu that points to the parameter created
* **Toggle Name** is the name the menu control and FX layer will receive
  * If **More Settings** isn’t open, it will also be used as the **Parameter Name**
* The **Saved** and **Default** toggles refer to the properties of the expression parameter created

#### More Settings

* **Proxy Animation** is the default animation in the FX layer before it goes into the current state. It should be an animation pointing to an invalid object (one is provided by default)
* **Menu Icon** is the icon that will be used in the menu control
* If **Use Existing Animation** is active, the animation provided will be used in the FX Layer instead of creating a new one
* If **Slow Transition** is active, the transition from the active state will last what’s inputted as the **Transition Duration** instead of being instant
  * This should only be used if **Use Existing Animation** is active or if you’re planning on changing the animations created afterwards
* If **Use Write Defaults** is active, all the created animations states will have the Write Defaults option set to on
* **Animation Name** is the name of the Animation Clip created in the selected asset folder
* **Parameter Name** is the name of the parameter that will be added to the Expressions Parameters and FX Layer
* The **Selected Folder** is where the Animation Clip created will be saved as a file

<figure><img src="/files/MeD6CaleEnWDQOcP4Oyi" 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://wft.gabsith.com/tools/toggle-creator.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.
