First Steps

Welcome to AlbionManager! This guide will walk you through the essential first step to get your Discord bot up and running. Before you can use any features, you must complete the initial setup process.

🎯 Critical First Step: The /setup start command is mandatory and must be completed before any other bot functionality is available. This includes member registration, dashboard access, and all administrative features.

📋 What You Need Before Starting

Before running the setup command, make sure you have prepared the following:

1. Discord Server Preparation

Bot Permissions: Ensure the bot has "Administrator" permission or at minimum "Manage Roles"
Your Role Position: Make sure you have administrator permissions in the server
Bot Position: The bot's role should be positioned above all roles it will manage

2. Required Discord Roles (11 Total)

Create these Discord roles before starting setup:

Core Roles (3 required):

Member Role: Main role for all registered guild members
Management Role: For bot administrators and guild officers
Booster Role: For Discord server boosters

Combat Class Roles (8 required):

Arcane Support - Magic support specialists
Battlemount - Mounted combat experts
Clump Tank - Group tanking specialists
Curse Support - Curse magic users
D-Tank - Damage tank hybrid
DPS - Damage dealers
Healer - Support and healing
Oathkeeper/Groot - Tank specialists

Region Roles (3 required):

NA - North America players
EU - Europe players
ASIA - Asia players

💡 Pro Tip: You can name these roles whatever you want in Discord. The setup command will map your role names to the bot's internal system.

3. Server Infrastructure

Log Channel: Create a dedicated channel for bot activity logs
Bot Channel: Recommended to have a channel where members can use bot commands

4. Albion Online Information

You'll need one of the following:

Your Guild Name: The exact name of your Albion Online guild, OR
A Guild Member Name: The player name of any member in your guild
Server Region: Know which Albion Online server your guild plays on (Americas, Europe, Asia)

🚀 Setup Commands Overview

The bot provides three setup commands to manage your guild configuration:

/setup start

Purpose: Initial bot configuration and updates

Required: Must be run first before any bot features work

Usage: Configure all 11 Discord roles and guild settings

/setup check

Purpose: View current configuration

Required: No parameters needed

Usage: See all your current role mappings and settings

/setup reset

Purpose: Reset all configuration

Required: No parameters needed

Usage: Clear all settings (use with caution!)

🚀 Primary Setup Command: /setup start

Command Syntax

/setup start

Required Parameters

The setup command requires ALL of these parameters:

⚠️ All Fields Required: Every parameter in the setup command is mandatory. The bot will not start without complete configuration.

Parameter	Type	Description
`server`	Selection	Albion Online server (Americas/Europe/Asia)
`target-name`	Text	Your guild name or a player name from your guild
`type`	Selection	Choose "Guild" or "Player" based on target-name
`member-role`	Role	Discord role for all registered members
`management-role`	Role	Discord role for bot administrators
`booster-role`	Role	Discord role for server boosters
`log-channel`	Channel	Channel for bot activity logs
8 Class Roles (All Required):
`arcane-support-role`	Role	Role for Arcane Support players
`battlemount-role`	Role	Role for Battlemount players
`clump-tank-role`	Role	Role for Clump Tank players
`curse-support-role`	Role	Role for Curse Support players
`d-tank-role`	Role	Role for D-Tank players
`dps-role`	Role	Role for DPS players
`healer-role`	Role	Role for Healer players
`oathkeeper-groot-role`	Role	Role for Oathkeeper/Groot players
3 Region Roles (All Required):
`na-region-role`	Role	Role for North America players
`eu-region-role`	Role	Role for Europe players
`asia-region-role`	Role	Role for Asia players

Complete Setup Example

Here's a complete example of the setup command with all required parameters:

/setup start
server: Europe
target-name: MyGuildName
type: Guild
member-role: @Members
management-role: @Guild Officers
booster-role: @Server Boosters
log-channel: #bot-logs
arcane-support-role: @Arcane Support
battlemount-role: @Battlemount
clump-tank-role: @Clump Tank
curse-support-role: @Curse Support
d-tank-role: @D-Tank
dps-role: @DPS
healer-role: @Healer
oathkeeper-groot-role: @Oathkeeper
na-region-role: @NA Players
eu-region-role: @EU Players
asia-region-role: @ASIA Players

⚡ What Happens During Setup

When you run the setup command, the bot performs these steps:

Permission Verification: Checks if you have admin permissions
Premium Check: Verifies your server has premium access to the bot
Albion API Validation: Validates your guild/player name with Albion Online servers
Role Validation: Verifies all 11 Discord roles exist and are accessible
Database Setup: Creates your guild configuration in the bot's database
Feature Activation: Enables all bot features for your server
Confirmation: Sends a success message with your configuration summary

✅ Success! Once setup completes successfully, all bot features become available immediately.

🎉 What You Get After Setup

Completing the setup unlocks all bot functionality:

Immediate Access

Member Registration: Users can register with /register
Web Dashboard: Access guild management through the web interface
Admin Commands: All administrative Discord commands
Role Automation: Automatic Discord role assignment
Member Management: Full member tracking and management

Available Commands

/register - Member self-registration
/members - View member list
/force-register - Admin member registration
/remove - Remove members
/check-unregistered - Find unregistered Discord users
All banking, siphon, and other system commands

Web Dashboard Features

Member Overview: Visual member list with search and filters
Guild Statistics: Member counts, role distribution
Data Management: Edit and manage member information
System Monitoring: View bot activity and logs

🔧 Troubleshooting Setup Issues

Common Setup Problems

"Missing Permissions" Error

Solution:

Ensure you have Administrator permission in the Discord server
Make sure the bot has Administrator permission or "Manage Roles"
Check that the bot's role is positioned above all roles it will manage

"Role Not Found" Error

Solution:

Verify all 11 roles exist in your Discord server
Check role names for typos (role selection in Discord should show available roles)
Ensure you're selecting actual roles, not typing role names

"Guild/Player Not Found" Error

Solution:

Double-check the spelling of your guild or player name
Verify the name exists in Albion Online
Make sure you selected the correct server region
Try using a player name instead of guild name, or vice versa

"Premium Required" Error

Solution:

Contact the bot owner to verify your server's premium status
Check if your server is in the premium server list
Ensure premium subscription is active

Getting Help

If setup continues to fail:

Check the bot's log channel for detailed error messages
Verify all prerequisites are met
Try the setup command again with corrected parameters
See the Setup Guild guide for advanced troubleshooting
Contact support with specific error messages

💡 Can I Change Settings Later? Yes! You can re-run the setup command anytime to update role mappings or other configuration. The bot will update existing settings rather than create duplicates. For detailed information about managing your configuration, see the Setup Guild guide.

🚀 Next Steps

After successful setup, you're ready to:

Test Member Registration: Try registering yourself with /register
Access the Dashboard: Visit the web interface and explore member management
Learn Configuration Management: Read the Setup Guild guide to understand /setup check, updates, and reset options
Configure Other Systems: Set up banking, siphon tracking, and other features
Train Your Team: Show guild members how to register and use commands
Explore Documentation: Read about other bot systems and features

← Previous

Documentation Home

Setup Guild