# Role Rotator Setup

Enhance your Discord experience by dynamically changing your role colors with the Role Rotator feature. This guide provides step-by-step instructions on how to use the Role Rotator page within your application.

***

### Interface Overview

The Role Rotator interface is designed for simplicity and efficiency, allowing you to easily customize how your Discord role appears to others.

* **Top Notification Bar**: Indicates actions needed, such as enabling necessary settings like 'Start bot'.
* **Add Color Button**: Click this to add a new color to the rotation list for the selected role.
* **Colors List**: Displays the list of colors currently assigned for rotation. You can add or delete colors as needed.
* **RGB Mode Checkbox**: Enables or disables RGB Mode, which cycles through a spectrum of colors instead of using fixed colors.
* **Delete Color Button**: Removes the selected color from the rotation list.
* **Save Role Button**: Saves the current role color settings, ensuring your configurations are applied.
* **Delay Slider**: Adjusts the time interval between color changes, allowing you to set how quickly the role color changes.
* **Delay Label**: Shows the current setting of the delay slider in seconds.
* **Start Button**: Begins or stops the color rotation for your role, based on the current settings.

***

### Step-by-Step Usage

1. **Check Notification Bar**: Ensure all prerequisites are met by addressing any alerts in the top notification bar (e.g., enabling 'Start bot').
2. **Selecting Colors**:
   * Click the **+ Add Color** button to open a color picker and select a color.
   * The chosen color will appear in the Colors List below the button.
3. **Configure Color Rotation**:
   * To enable continuous color cycling, check the **RGB Mode** checkbox.
   * To remove a color, select it from the Colors List and click the **Delete Color** button.
4. **Set Rotation Delay**:
   * Use the Delay Slider to define how frequently the role color should change. Adjust the slider to increase or decrease the delay.
   * The Delay Label updates in real time to reflect the current setting.
5. **Save Your Settings**:
   * Once satisfied with your color selections and the rotation delay, click the **Save Role** button to apply your settings.
6. **Start or Stop the Rotation**:
   * Press the **Start** button to initiate the color rotation. If already running, this button can be used to stop the rotation.

***

Using this guide, you can easily manage and personalize your Discord role colors with the Role Rotator feature, enhancing your presence in the community.


---

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

```
GET https://av0.gitbook.io/av/applications/status-rotator++/role-rotator-setup.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.
