Check out Rolebots Site

Checkout Rolebots Discord support server

RoleBot Selfhosting

Rolebot is available to be selfhosted! This is a guide on how to do so.

Requirements

Node.js (v17.00 or newer)
Yarn
Curl

Hosting environment.

It is ideal that you do this in a linux environment. You can run this bot just fine in Windows Subsystem for Linux (WSL). This is what I use. If you want to install this go here.

For the sake of this "guide" I am setting up in a debian (Ubuntu/WSL) enviroment for yarn and nvm.

Install nvm (Node Verson Manager)

To install nvm you need to use curl, incase you don't have curl installed here's the command to install

$  sudo apt install curl

Now install nvm

 $  curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash`

Now you need to logout and login again to load the nvm environment correctly, or you can run this command to do the same.

$  source ~/.profile

Now confirm it was installed correctly with

$  nvm --version

Use nvm to install node/npm

Since this version of the bot at time of writing uses discord.js@14.X we're required to use node@18 minimum. So let's install node@18 with nvm and set the default version to 18.

$  nvm install 18 && nvm alias default 18

Install yarn with npm

Now let's install yarn globally.

npm install --global yarn`

Your environment should be good to go from here

If you don't have git installed do this..

$  sudo apt install git

Now that we have git installed let's clone down the repo, change directory, and install our dependecies.

$  git clone https://github.com/Uhuh/RoleBot.git

$  cd RoleBot

$  yarn install

Great! We should have our dependencies installed. Now let's update some tokens so we can turn the bot on.

I use dotenv and have an example .env in this repo here. You can copy it and make a new file .env - You should never share your .env with annybody, it contains sensitive information.

TOKEN=your_super_secret_bot_token

DB_NAME=postgres_db_name

POSTGRES_URL=postgres://username:password@ip:5432/

# ↓ Set to 1 if you're working in a dev environment. 

SYNC_DB=0

WEBHOOK_ID=webhook_id
WEBHOOK_TOKEN=webhook_token
CLIENT_ID=the_bots_id
SHARD_COUNT=1

Don't want to use dotenv? Update the variables in `src/vars.ts` instead.

After setting this all up you should be able to run `yarn start`

If you experince any issues please join the support server and ask for help!

What does RoleBot do?

RoleBot is a Discord application solely focused on creating "Reaction Roles" in servers.

It achieves this by lettings users use the carefully crafted commands here to create an association between a Discord role and emoji.

The users are also encouraged to put their newly made react roles into a "category". This helps the user and the bot break up all the react roles that the user creates and makes it easier to manage.

For example you might want to create a collection of roles, maybe some "color" roles. So you create a "color" category and add all the color related react roles to it.

That's the TLDR; for RoleBot! Using it is super simple! But the code behind it to make sure it all works is a little lengthy. And now hopefully pretty after this rewrite.

bunnydevx/RoleBot