Skip to main content

Getting Started

A guide to adding ArcBot to your Discord server and basic configuration.

Adding the bot to your server​

  1. Open the ArcBot invite link
  2. Select the server you want to add the bot to
  3. Approve the required permissions
  4. Click Authorize
Required Permissions

ArcBot needs the following base permissions:

  • Manage Roles — creating alliance roles, self-assign roles
  • Ban / Kick Members — moderation commands
  • Manage Messages — clearing messages, deleting old reminders
  • Send Messages — embeds, logs, notifications
  • Create Public Threads — discussion threads under suggestions

Individual modules (cogs) may require additional permissions.

What happens after adding?​

After adding the bot to your server:

  1. Configuration creation — the bot automatically creates a default configuration for your server (language: English, embed color: #5865F2, no modules enabled)
  2. Command sync — slash commands are synced per-server. Initially no commands are visible — they appear only after enabling the corresponding modules
  3. Configuration restoration — if the bot was previously on the server and was removed less than 30 days ago, the previous configuration is automatically restored

Accessing the configuration panel​

ArcBot has a web configuration panel (dashboard):

URL: https://arcbot.pro

Who has access?​

  • Users with Administrator permission on the Discord server
  • Users added to the dashboard_users list in server settings

How to log in?​

  1. Go to the dashboard page
  2. Click Login with Discord
  3. Authorize the OAuth2 application
  4. Select a server from the list (only servers you have access to are visible)

Basic configuration​

1. Set the server language​

The default language is English. To change to Polish:

  1. Open dashboard → Your server
  2. Click the Settings tile (server settings)
  3. Change the language to Polski
  4. Save changes
tip

The server language affects bot messages (errors, confirmations, etc.). Users can also set their own language preferences.

2. Enable modules (cogs)​

ArcBot is fully modular — no module is enabled by default. To enable a module:

  1. Open dashboard → Your server
  2. In the module grid, find the module you're interested in
  3. Click the toggle switch to enable it
  4. Commands associated with the module will appear on the server within a few seconds

3. Configure moderation roles​

Most moderation commands require having a role from the moderation_roles list:

  1. Enable the Moderation module
  2. Click Edit on the Moderation tile
  3. Add roles that should have access to moderation commands
  4. Save changes

4. Configure logs​

The logging system allows you to track actions on the server:

  1. Enable the Logs module
  2. Click Edit on the Logs tile
  3. For each log type (moderation, welcome, suggestions, etc.):
    • Enable the module with the toggle
    • Select a target channel
    • Optionally change the embed color
  4. Save changes
warning

You cannot enable a log module without selecting a target channel. The dashboard will highlight the missing field and display an error message.

Bot role position​

After adding the bot to the server, Discord creates an ArcBot role (or similar). You must manually move this role higher in the role hierarchy so the bot can:

  • Manage user roles (ban, kick, mute, alliance roles)
  • Assign roles from reaction roles
  • Change nicknames

To do this:

  1. Go to Server Settings → Roles
  2. Drag the bot's role above the roles it should manage
  3. Save changes
Important

The bot CANNOT manage roles that are higher than its own role in the hierarchy. This is a Discord API limitation and cannot be worked around programmatically.

Next steps​