Getting Started
A guide to adding ArcBot to your Discord server and basic configuration.
Adding the bot to your server
Open the invite link
Go to the ArcBot invite link in your browser.
Select your server
Choose the Discord server you want to add the bot to from the dropdown.
Approve permissions
Review and approve the required permissions, then 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:
Configuration creation
The bot automatically creates a default configuration for your server (language: English, embed color: #5865F2, no modules enabled).
Command sync
Slash commands are synced per-server. Initially no commands are visible — they appear only after enabling the corresponding modules.
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_userslist in server settings
How to log in?
Go to the dashboard
Navigate to arcbot.pro in your browser.
Login with Discord
Click Login with Discord and authorize the OAuth2 application.
Select your server
Choose 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:
Open dashboard → Your server
Click the Settings tile (server settings)
Change the language to Polski
Save changes
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:
Open dashboard → Your server
In the module grid, find the module you're interested in
Click the toggle switch to enable it
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:
Enable the Moderation module
Click Edit on the Moderation tile
Add roles that should have access to moderation commands
Save changes
4. Configure logs
Enable the Logs module
Click Edit on the Logs tile
For each log type (moderation, welcome, suggestions, etc.): enable the module with the toggle, select a target channel, and optionally change the embed color
Save changes
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
Go to Server Settings → Roles
Drag the bot's role above the roles it should manage
Save changes
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.