What is it?

RoVer is an open source, drop-in verification bot that will allow your members to safely authenticate their Roblox account on your Discord server. This empowers your Roblox community with the following advantages:

Speak with confidence, because everyone is who their name says they are.
Adding an extra step between trolls & spammers and your server will reduce unwanted activity drastically.
The verification database is already populated with thousands of Discord-Roblox account links, so it's possible users will already be verified when they join your server.
The hosted version of RoVer does not have any API rate limiting and will automatically be able to update roles the second the user verifies. (If you host RoVer yourself, the user will have to run a command in order for the verification to take place.)

How does it work?

RoVer uses the same verification system used by the ROBLOX Discord server, a web app that lives at verify.eryn.io. RoVer makes use of its public API.

Step 1

The user signs in with their Discord account.

Step 2

The user chooses how they want to verify: by joining a ROBLOX game, or by adding a code to their profile.

Step 3

The user is verified and can participate in your community.

Getting Started with RoVer

The quickest and easiest way to use RoVer is to add the hosted version to your server.

You can also clone this repository and host it yourself and make any modifications you wish.

After you add the bot to your server, you can customize RoVer with the following commands. You must have the Administrator permission in the Discord server in order to use these commands.

!RoVer - Displays a list of commands
!RoVerVerifiedRole <exact role name> - Set the role that verified members will get. Default null.
!RoVerNickname <true|false> - Set whether or not new users will be nicknamed to their Roblox name. Default true.
!RoVerAnnounceChannel <exact channel name> - Set a channel that the bot will post a message to every time someone verifies. Default null.
!RoVerNicknameFormat <format> - Set the nickname format, so you could have the nickname include their roblox id or discord name, for example. Available replacements are Available replacements are %USERNAME%, %USERID%, %DISCORDNAME%, and %DISCORDID%. Example: %USERNAME% - (%USERID%). Default %USERNAME%.
!RoVerWelcomeMessage <welcome message> - Set the message the user gets when they verify. Will be sent in DMs unless they use !verify command. Available replacements are Available replacements are %USERNAME%, %USERID%, %DISCORDNAME%, and %DISCORDID%. Default: Welcome to the server, %USERNAME%!.
!RoVerBindGroupRank <groupid:rank number:role name|groupid:role name> - See section below.
!RoVerUnbindGroupRank <role name> - See section below.
!RoVerUnbindAllGroupRanks - See section below.
!RoVerUpdate <@user> - Forcibly update verification status of a user, same as them running !verify. Make sure you @mention the user.

You can run these commands without arguments to set them back to their default state.

When a user joins your server, the bot will automatically check if they are already in our database, and if so, they will be verified immediately. If they are not already in the database, they will be instructed to go to the verification website to verify themselves. If you are using the hosted version of the bot, then the user will automatically be given the verified state after they verify on the website. However, if you are hosting the bot yourself, the user will have to run the !verify command in order for the bot to check if they are verified.

You should probably make a read-only channel in the server explaining these processes to your members.

Setting up roles for Roblox group members and group ranks

Use the following command to set up giving a role to all members of a group:

!RoVerBindGroupRank 372:Group member where 372 is your group id and Group member is the Discord role name
Use the following command to set up giving a role to members of a certain rank in a group:

!RoVerBindGroupRank 372:255:Group owner where 372 is your group id, 255 is the group roleset rank (the number on the configure page, not the role name) and Group owner is the Discord role name
Use the following command to set up giving a role to members of a rank or higher in a group: (Note! This uses a "greater than or equal to" comparison)

!RoVerBindGroupRank 372:>200:Group owner where 372 is your group id, 200 is the group roleset rank (the number on the configure page, not the role name) and Group owner is the Discord role name
Use the following command to set up giving a role to members lower than a rank in a group: (Note! This uses a "less than" comparison)

!RoVerBindGroupRank 372:<200:Group owner where 372 is your group id, 200 is the group roleset rank (the number on the configure page, not the role name) and Group owner is the Discord role name
Use the following command to unbind a role from a group:

!RoVerUnbindGroupRank Group member where Group member is the Discord role name
Use the following command to unbind all roles from groups in your server:

!RoVerUnbindAllGroupRanks

Virtual groups

Virtual groups are a way to bind ranks using the group rank binding system for external services that aren't actually Roblox groups, such as the dev forum. Currently, only one virtual group is implemented, but more could be easily added if you fork this project:

DevForum

To create a role for all members of the dev forum min your server, use the following command:

!RoVerBindGroupRank DevForum:DevForum Member, where DevForum is the Virtual Group and DevForum Member is the Discord role name

Self-hosting instructions

To get RoVer ready to run locally, the first step is to clone this repository onto the machine you wish to run it on.
Node.js version 7.8.0 or higher is required to run RoVer.
Install yarn if you don't already have it: npm install -g yarn
Use yarn to install the dependencies: yarn install
Edit the file src/data/client.json and insert your bot token.
Start the bot: node ./src/index.js
You should set up a process manager like PM2 or forever.js to ensure that the bot remains online.

To-do list and plans

Add more commands for admins for things like fixing name, banning per server by roblox account, and a !whois command
More cowbell

SmellySteve/pog