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.
Last updated