> For the complete documentation index, see [llms.txt](https://wft.gabsith.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wft.gabsith.com/tools/toggle-creator.md).

# 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>