# Autoroles

This page will show you how to setup simple autoroles for the bot, they allow you to give/remove roles from users everytime they vote. This is a simplified version of actions for people who have less experience in pseudocode or have no interest in creating complicated autoroles.

## Usage

| Main command: `autoroles`  Aliases: `autorole, ar` |
| -------------------------------------------------- |

| Command                                                              | Description                                                              |
| -------------------------------------------------------------------- | ------------------------------------------------------------------------ |
| `vt!autoroles add <role> [minimum votes] [maximum votes] [duration]` | Add a new autorole                                                       |
| `vt!autoroles remove <id>`                                           | Remove an autorole by it's ID, which can be found in `vt!autoroles show` |
| `vt!autoroles show <page>`                                           | List all the currently active autoroles with their ID                    |
| `vt!autoroles help`                                                  | Display all the commands                                                 |

## Examples of Usage

| Examples                              | Description                                                                                                                                                      |
| ------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `vt!autoroles add @Voted`             | Give the role `@Voted` when someone votes                                                                                                                        |
| `vt!autoroles add @Two Votes 2`       | Give the role `@Two Votes` when someone has 2 or more votes                                                                                                      |
| `vt!autoroles add @Two Votes 2 4`     | Give the role `@Two Votes` when someone has 2 to 4 votes, the role is removed when the user has more than 4 votes                                                |
| `vt!autoroles add @Four Votes 4 8 6h` | Give the role `@Four Votes` when someone has 4 to 8 votes, the role is removed when the user has more than 8 votes, and is also removed 6 hours after they voted |


---

# 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://votetracker.gitbook.io/vote-tracker/commands/autoroles.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.