Discord Bot Setup Guide

Complete step-by-step guide to set up and configure the Albion Guild Management Bot

Bot Setup Guide

1

Invite the Bot to Your Server

Click the invitation link below to add the Albion Guild Management Bot to your Discord server.

🔗 Invite Albion Guild Management Bot

Required Permissions: The bot needs the following permissions to function properly:

  • ✅ Manage Roles - To assign guild/alliance roles to registered players
  • ✅ Send Messages - To respond to commands and send notifications
  • ✅ Use Slash Commands - For all bot commands
  • ✅ Embed Links - To send rich embeds with stats and information
  • ✅ Read Message History - To find existing event messages for updates
  • ✅ Add Reactions - For interactive features and confirmations
2

Set Up Required Discord Roles

Create the necessary Discord roles for your guild members before configuring the bot.

  1. Guild Role: Create a role for your Albion guild members (e.g., "@Guild Member")
  2. Alliance Role: Create a role for your alliance members (e.g., "@Alliance Member")
  3. Bot Admin Role: Create a role for users who can manage bot settings (e.g., "@Bot Admin")
  4. Registration Role (Optional): Create a role required to register with the bot (e.g., "@Verified")

Important: Make sure the bot's role is positioned above the roles it needs to manage in your server's role hierarchy.

3

Create Required Channels

Set up dedicated channels for the bot's various features.

  1. 📋 Bot Commands Channel: A channel where members can use bot commands
  2. 📊 Battle Logs: Channel for automatic battle notifications and tracking
  3. 📅 Events: Channel for event countdowns and notifications
  4. 🔍 Transaction Logs: Private admin channel for economy transaction logs
  5. ⚙️ Bot Config: Private admin channel for bot configuration commands

Recommended Permissions:

  • Make sure the bot can Send Messages and Embed Links in all these channels
  • Restrict admin channels to only bot administrators
  • Consider making battle logs and events view-only for regular members
4

Configure Your Albion Guild Settings

Link your Discord server to your Albion Online guild or alliance.

# Set your guild by name (recommended)
/admin setguild YourGuildName

# OR set guild by ID directly
/admin setguildid GUILD_ID_HERE

# Set alliance (if applicable)
/admin setalliance YourAllianceName

Note: You can find your guild/alliance ID on websites like AlbionOnline2D or by searching the Albion API.

5

Configure Discord Roles

Link your Discord roles to the bot's functionality.

# Set bot admin role (who can use admin commands)
/admin setadminrole @BotAdmin

# Set guild member role
/admin setguildrole @GuildMember

# Set alliance member role
/admin setalliancerole @AllianceMember

# Set required role for registration (optional)
/admin setregisterrole @Verified
6

Set Up Bot Channels

Configure which channels the bot will use for different features.

# Set transaction log channel
/admin setlogchannel #transaction-logs

# Set battle notification channel
/setbattlechannel #battle-logs

# Set event countdown channel
/seteventchannel #events

# Configure battle tracking settings
/setminbattleplayers 5
7

Test Your Configuration

Verify everything is working correctly with these test commands.

# View your server's configuration
/admin viewconfig

# Test player lookup
/player YourAlbionCharacterName

# Register yourself to test the system
/register YourAlbionCharacterName

Success Indicators:

  • ✅ /admin viewconfig shows all your settings correctly
  • ✅ /register assigns the correct role automatically
  • ✅ Battle notifications appear in your designated channel
  • ✅ Event countdowns display and update properly

Bot Commands

Admin Commands
Registration
Events
Battle Tracking
Economy
Siphoned Energy

Server Configuration

/admin setguild
Set your Albion guild by name
/admin setguild MyGuildName
guild_name
The exact name of your Albion Online guild
/admin setlogchannel
Set the channel for transaction logs
/admin setlogchannel #bot-logs
channel
The Discord channel to send transaction logs to
/admin setadminrole
Set the role that can use admin commands for this bot
/admin setadminrole @BotAdmin
role
The Discord role that can use admin commands
/admin viewconfig
View this server's Albion configuration
/admin viewconfig

Player Registration

/register
Register your Albion character
/register AlbionPlayerName
player_name
Your exact Albion Online character name
/unregister
Remove your Albion registration and roles
/unregister
/player
Look up an Albion player by name
/player AlbionPlayerName
player_name
The Albion Online player to look up

Event Management

/seteventchannel
Set the channel to post event countdowns
/seteventchannel #events
/addevent_utc
Add an event by UTC time
/addevent_utc 19 30 Hideout Lymhurst Steppe
/removeevent
Remove an event by ID
/removeevent 42

Battle Tracking

/setbattlechannel
Set the channel for battle notifications
/setbattlechannel #battle-logs
/attendance
Show guild battle attendance leaderboard
/attendance 30
/stats
Get Albion battle stats for a registered user
/stats @User 30

Economy System

/balance
Check your current balance
/balance
/give
Transfer balance to another registered user
/give @User 100
/leaderboard
View the top 10 richest players
/leaderboard

Siphoned Energy

/siphoned_update
Upload a .txt log to record siphoned entries
/siphoned_update [file attachment]
/siphoned
View siphoned leaderboard
/siphoned
How do I set up the bot for my guild?

Follow the 7-step setup process above. Start by inviting the bot, then configure your guild settings and Discord roles. The most important commands are /admin setguild to link your guild and /admin setadminrole to set permissions.

How does battle tracking work?

The bot automatically checks the Albion Online API every 3 minutes for new battles involving your guild. When it finds battles with enough guild members, it records the data and posts notifications in your designated battle channel.

What is the economy system used for?

The economy system allows guild leaders to create an internal currency for members. Common uses include rewarding battle participation, distributing loot splits, and managing regears after CTAs.