> For the complete documentation index, see [llms.txt](https://av0.gitbook.io/av/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://av0.gitbook.io/av/bots/status-rotator++-bot.md).

# Status Rotator++ Bot

### **Overview**

The **SR++ Bot** offers a comprehensive, fully customizable Discord status rotator, designed to keep your profile dynamic 24/7. This guide provides detailed information on all available commands and how to use them effectively.

***

### 1. Getting Started

Welcome to **SR++ Bot**! This bot allows you to set up an automatic, customizable status rotator on Discord, managing status changes at regular intervals. With SR++ Bot, you can add, edit, delete, and reorder statuses, as well as set the time interval between rotations. The bot features a user-friendly slash command interface, making it easy to manage your status rotator.

***

### 2. Key Features

* **Customizable Status Rotation**: Add multiple statuses with text and emojis.
* **Adjustable Intervals**: Set the frequency of status changes, starting from 3 seconds.
* **Easy Control**: Start, stop, and manage your status rotator with interactive buttons.
* **User Profiles**: View and manage your rotating statuses, subscription, and profile details.
* **Subscription Notifications**: Receive timely reminders for subscription renewals and expiration.
* **Help and Documentation**: Access comprehensive guides and help commands for smooth bot usage.

***

### 3. Commands

#### General User Commands

#### **`/login`**

* **Purpose**: Link your subscription key to activate the bot.
* **Usage**: Enter `/login` followed by your unique subscription key.
* **Example**:

  ```
  /login your_subscription_key
  ```

#### **`/profile`**

* **Purpose**: Display your user profile, including rotation status, interval, active statuses, and subscription expiration.
* **Usage**: Simply execute `/profile` to view your profile.

#### **`/add_status`**

* **Purpose**: Add a new status to your rotator, optionally with an emoji.
* **Usage**: Use `/add_status` with your status text and, optionally, an emoji or emoji ID.
* **Example**:

  ```
  /add_status status:"Playing games" emoji:🎮
  ```

#### **`/edit_status`**

* **Purpose**: Edit an existing status in your rotator.
* **Usage**: Use `/edit_status` with the current status, new name (optional), and new emoji (optional).
* **Example**:

  ```
  /edit_status status:"Playing games" new_name:"Streaming live" emoji:🔴
  ```

#### **`/del_status`**

* **Purpose**: Remove a status from your rotator.
* **Usage**: Use `/del_status` with the status you wish to delete.
* **Example**:

  ```
  /del_status status:"Playing games"
  ```

#### **`/move`**

* **Purpose**: Move a status up or down in your rotator list.
* **Usage**: Use `/move` with the status you want to move and the direction (up or down).
* **Example**:

  ```
  /move status:"Playing games" direction:UP
  ```

#### **`/set_interval`**

* **Purpose**: Set the time interval (in seconds) between status rotations.
* **Usage**: Use `/set_interval` with the desired interval (minimum 3 seconds).
* **Example**:

  ```
  /set_interval interval:60
  ```

#### **`/set_token`**

* **Purpose**: Provide your Discord token to activate the status rotator.
* **Usage**: Use `/set_token` with your Discord user token.
* **Example**:

  ```
  /set_token your_discord_user_token
  ```

#### Admin-Only Commands

#### **`/list_sr_users`**

* **Purpose**: List all users with an active status rotator profile.
* **Usage**: Simply execute `/list_sr_users`.

#### **`/reset_profile`**

* **Purpose**: Reset the profile data of a specified user.
* **Usage**: Use `/reset_profile` with the target user.
* **Example**:

  ```
  /reset_profile target_user:@username
  ```

#### Utility Commands

#### **`/ping`**

* **Purpose**: Check the bot's latency in milliseconds and performance score.
* **Usage**: Simply execute `/ping`.

#### **`/sr_help`**

* **Purpose**: Display all available commands for the Status Rotator bot.
* **Usage**: Simply execute `/sr_help`.

***

### 4. Conclusion

SR++ Bot provides a simple, effective solution for managing your Discord status rotator directly through Discord itself. Enjoy the convenience of automatically changing your status and keeping your profile dynamic and active. Explore the available commands to make the most out of your status rotation experience!


---

# 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/bots/status-rotator++-bot.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.
