Hello! Thanks for checking out AbettorBot!
This page will serve as a guide to walk you through setting up and maintaining AbettorBot’s color system in your server!
a@rolecolorsetup help will act as a reference for all of these commands. Feel free to call this command any time for quick reminders on how these commands work.
Short notice before we begin: You should never alter roles created by AbettorBot within your Server Settings. Only configure roles / etc for AbettorBot with the built in commands.
First Time Setup
First off, we’ll need to enable the AbettorBot color system in our server. This can be done with the a@rolecolorsetup enable command.
You will be prompted to answer a few questions about how you would like your server set up. First off, you’ll need to answer whether or not you want users to be able to create roles in your server. If you don’t want users to be able to create colors and you want to provide a set list of roles, say no. Otherwise, say yes so users can make their own colors.
You will then be prompted with another question. If you’d like users to be able to give their role colors certain names, say yes. Otherwise, if you choose no, the role names will be the hex color values (ie AF58CC, D23ABC, etc.)
Generally, I think saying ‘yes’ to both of these gives the best experience. I do understand, however, that some user bases may not take to naming their roles too nicely. Note that these configuration settings can be changed any time! If you made a mistake in the initial setup, you can use the following commands to change your settings:
At this point, the system is ready for users (or admins) to create colors!
Basic Usage (Creating and Setting Your Color)
To create a color role, use the following command:
For example, if you want to create a color with the hexcode of “AF4321” and name it “ColorForMe!”, you would do it like this:
Note that AbettorBot then informs you that you can set this as your role color using the a!setcolor command, like so:
AbettorBot doesn’t allow you to have multiple color roles at once. Therefore, it removes any other color roles (made by AbettorBot) you may have and assigns the requested one.
Note that AbettorBot also does not allow roles with the same name:
Seeing Colors in the Server
To see the list of colors in the server currently, use a!colorlist. To see what a color role looks like, use a!roleinfo colorname like so:
What if my colors aren’t showing up?
Be aware: AbettorBot does not put these roles above any others. Therefore, if you want these color roles to show through and not get overwritten by other roles you may have, you should make all other roles have no color. This can be done like so:
By making the role have the default color, it will not override any lower role color, allowing AbettorBot’s color role to shine through, as so:
What if I want to change the name of a role?
There is no way to change the name of the role. I gave this a lot of thought when I originally created (and re-wrote) the system. My final decision was to not allow changing of role names so that users who pick a role (and its corresponding name) won’t be surprised by a sudden role with a name they did not intend. Plus, it would require users to “own” roles they create and a bunch of other overhead.
Firstly, DO NOT change the name of the role in Server Settings.
This will cause a discrepancy between the name of the role known by AbettorBot and the role within the server.
Currently, if you’d like to keep the same color but recreate a role with a new name, I’d recommend doing it like this. First, find the role you like the color of but want a different name for. Use a!roleinfo rolename to get the color code for that role.
Now, you can create a new role with the same color by using a!createcolor ffff00 NewName and assign it to yourself with a!setcolor NewName.
Note: If you have configured the server to not allow users to name their roles and create their own roles, this obviously does not apply.
Cleaning Up Junk Roles
Inevitably, people will create multiple roles and no longer be using old roles. Not to worry, there is an easy way to clean out roles no longer in use!
Simply call a@rolecolorsetup clean and the bot will detect which color roles are no longer in use and wipe them from the server and from AbettorBot’s storage system.
This process takes a moment and you’ll be updated as it continues…until it completes.
If a user creates a role with a bad name and you need to get rid of it, DO NOT delete the role from within your Server Settings.
This makes AbettorBot very angry. He does not like when people do this, as it leaves the role leftover in AbettorBot’s system, of which he has to do the cleanup for you…
Instead, use the a@rolecolorsetup delete rolename command to cleanly remove it from the server:
Resetting and Disabling the System
If roles have gotten out of hand and you’d like a clean start, try the reset command, as shown below. This command can take a while to run depending on how many roles are in use.
If you determine you’d no longer like to use the AbettorBot system, you can disable it with a single command, disable.
That’s it! Thanks for reading through this guide. If you’ve got any setup or logistics questions, always feel free to send me a tweet or reach out on Discord.
AbettorBot 