Actions

This page will guide you through how to setup assignable and removable voting roles for your server or bot when a user a votes or gets a certain number of votes. These are fully customisable and allow you to have loads of personalised autoroles and complicated set of rules.

Actions are written in a sort of pseudocode and follow basic computer logic to allow users to fully customise them. If you aren't familiar with pseudocode or programming, you can use the commonly used examples found lower down the page and/or ask for help on our support server. You can also make use of our placeholders in your custom actions

This is an advanced version of autoroles, if you have no interest in making complicated autoroles for your server/bot, we highly recommend you ignore this page and read the Autoroles page.

Usage

Main command: actions

Command

Description

vt!actions add <rule>

Add a rule that will get executed when a user votes

vt!actions remove <id>

Remove a rule by it's ID, which can be found in vt!actions list

vt!actions show

List all the currently active actions with their ID

vt!actions help

Display all the commands

Most Commonly Used

The most common way it is used in servers is to reward users when they get a certain number of votes, for example if they get 4 votes, they get the "4 Votes" role. And usually once they reach 8 votes and get the "8 Votes" role, they lose their previous "4 Votes" role. Then when they get 12 or more votes, they lose their "8 Votes" role and get the "12+ Votes" role.

This is what it commonly looks like. You can copy paste the lines below and put in your own values & role names.

vt!actions add GIVE ROLE("Voter", "12h")

vt!actions add IF (%user#votes% >= 4) { GIVE ROLE ("4 Votes") }

vt!actions add IF (%user#votes% >= 8) { GIVE ROLE ("8 Votes") REMOVE ROLE ("4 Votes") }

vt!actions add IF (%user#votes% >= 12) { GIVE ROLE ("12+ Votes") REMOVE ROLE ("8 Votes") }

Examples

Important Notes

  • Indentation is not required for it to work, it's used to make it easier to read.

  • The operations you can use in the IF statements are=,!=,>=,<=,<=,-,*,+,/

  • Quotation marks are required when using emojis or mixing numbers and letter e.g. GIVE ROLE (Voted) orGIVE ROLE ("Voted 2x")

Examples

Description

vt!actions add GIVE ROLE("Voter", "12h")

Give the role called Voter for 12 hours

vt!actions add IF (%user#votes% >= 2) {

GIVE ROLE ("2 Votes")

}

Assign the "2 Votes" role when someone has 2 or more votes.

vt!actions add IF (HAS ROLE ("Voted")) {

GIVE ROLE ("Pic perms", "12h")

}

Assign the "Pic perms" role for 12h when someone has the "Voted" role.

vt!actions add IF (%user#votes% > 4) { GIVE ROLE ("4 Votes") REMOVE ROLE ("2 Votes") }

Assign the "4 Votes" role when someone has more than 4 votes. Then remove the previous "2 Votes" role.

vt!actions add IF (%user#votes% >= 10) { GIVE ROLE ("10 Votes") GIVE ROLE (762402600272265317) REMOVE ROLE ("8 Votes") REMOVE ROLE ("6 Votes") REMOVE ROLE ("4 Votes") REMOVE ROLE ("2 Votes") }

Assign the roles "10 Votes" and the role with ID 762402600272265317 when someone has 10 or more than 10 votes. Then remove the roles "8 Votes", "6 Votes", "4 Votes" and "2 Votes".

vt!actions add IF (%user#votes% >= 10 & %guild#totalvotes% > 300) { GIVE ROLE ("10 Votes") REMOVE ROLE ("8 Votes") }

Assign the "10 Votes" role when someone has 10 or more than 10 votes and the server has more than 300 votes. Then remove the "8 Votes" role.