Set up the bot

About ten minutes, and you do not need a Minecraft server to start. You can do all of it from the website.

1. Add the bot to your Discord server

Open Add to Discord, tick the features you plan to use, and continue to Discord. You must own the server or have the Manage Server permission to add a bot. Discord shows the exact permissions before you approve.

2. Open the dashboard

After the invite you land on the setup wizard of your server's dashboard. If you are not signed in, you are sent to Discord to sign in first. VV-Bot asks only for your identity and your server list (the identify and guilds scopes).

The dashboard opens for you if you own the server or hold Administrator or Manage Server on it. Staff who only have a mapped staff role in the bot cannot open the dashboard yet. They can still use the Discord commands that match their level.

3. Walk through the setup wizard

The wizard has six short steps. Every step can be skipped, your place is saved, and each one links to the page where you can change it later.

  1. Goals. Say what you want the bot for. This switches the matching features on. Moderation, giveaways, reports, suggestions and notes start switched off.
  2. Staff roles. Choose which of your Discord roles are Helper, Mod and Admin in the bot. You cannot give a role a level above your own. The server owner is always Owner.
  3. Channels. Pick the channels where the bot posts (audit log, reports, welcome, and so on), or ask the bot to create them. A created channel can be hidden from everyone except your staff roles.
  4. Minecraft. Add a server and get a one-time pairing code, or give its address for a basic online check. The page shows when the server connects.
  5. Check. Lists what is missing: channels that are not set for features that are switched on, staff roles that are not mapped, and the Discord permissions your features need.
  6. Done. A short list of what to do next.

4. Connect a Minecraft server (optional)

Rank sync and the chat bridge need the plugin. Follow Install the plugin. Without it you still get every Discord-side feature and a basic server status.

Change things later

The dashboard has a page for everything the slash commands do: ranks with a colour preview, XP, quests, Discord XP roles, members and account links, moderation, reports, suggestions, giveaways, and a message composer. Things that happen inside Discord, such as posting a message or banning a member, are queued and carried out by the bot. The Activity page shows how each one went.

Both the dashboard and the slash commands go through the same checks, and every change is written to the audit log with its source, so you can see whether it came from Discord or the dashboard.