Albion Online Discord bot
Prices, crafting shopping lists, focus picks and the Battle Board, answered inside Discord. Add it to your guild's server for battle, kill, ZvZ and weekly report feeds, or to your own account to use the commands anywhere. Free.
Adding it to a server needs Manage Server on that server. Not an officer? Add it to your own Discord account instead: every command except /setup then works in any server or DM, with no admin rights. Feeds need the server install.
What it does
- Market and crafting.
/priceshows what an item sells for in every royal city with how old each number is./crafttells you how many materials to actually buy for a batch once returns are counted, and what the batch earns./focusranks what to spend focus on by silver per focus. - Battle Board. Look up a battle, guild, alliance or player, compare two guilds head to head, or list a guild's rivals, from the same records as the Battle Board.
/banditgives the current Bandit Assault phase with a countdown. - Feeds for your server.
/setupposts new battles, notable kills, big ZvZ fights, a weekly report and a weekly leaderboard into the channel you choose. - Your account. Link your Discord on albioncodex.com and
/fameshows your daily fame gains;/alertssends you DMs.
The numbers are the same ones the site shows: prices from the Albion Online Data Project and the Codex capture network, battles from the game's public kill records. See how we calculate.
Commands
Every command, as Discord lists it. Region is one of Americas, Europe or Asia; names autocomplete from the Battle Board.
| Command | What it answers | Access |
|---|---|---|
| Market and crafting | ||
/price | What an item sells for in every royal city, with how old each price is. The Black Market gets its own line instead of being blended into the average. /price server item tier | Free |
/craft | How many materials to actually buy for a batch, given where you craft (the bonus city, any city, a hideout or an island) and whether you use focus, plus where the batch sells best and what it earns. Leave options out and it asks one question at a time. /craft server item tier amount location focus | Free |
/focus | What to spend your focus on, ranked by silver per focus, with how many of each to make. Defaults to 10,000 focus, a full day of regen. /focus server focus category | Free |
/codex | How to read the /price and /craft answers and where the numbers come from. Topic Me shows your own Codex+ status and fame, only to you. /codex topic | Free |
| Battle Board | ||
/battle | A tracked battle: sides, kills, fame split and how sure we are. Paste an albioncodex.com or albionbb link, or a battle id. /battle link server | Free |
/guild | A guild's Battle Board record, top players, active hours and rivals. /guild name server | Free |
/alliance | The same for an alliance, by name or tag. /alliance name server | Free |
/player | Any Albion player: guild, alliance, lifetime fame and their last 30 days on the Battle Board. /player name server | Free |
/h2h | Two guilds on opposite sides: record and kills each way. /h2h guild_a guild_b server days | Free for 7 or 30 days; 90 days with Codex+ |
/rivals | A guild's five most-fought opponents, with a head to head for each. /rivals guild server | Free |
/bandit | The current Bandit Assault phase and an exact countdown, for one region or all three. /bandit server | Free |
| Your account | ||
/fame | Your fame gains for the last day and the last 7 days by fame type, with your fame card. Needs your Discord linked on albioncodex.com. /fame character private | Free for your main character; any of your characters and tracked players with Codex+ |
/alerts | Direct messages for Bandit Assault phase changes, your site price alerts and deaths of your linked characters. Always private. /alerts bandit | prices | deaths | status | Turning an alert on needs Codex+; turning one off and status work for any linked account |
| Server feeds | ||
/setup | Automatic posts into a channel of your server. See the feeds below. /setup battles | kills | weekly | zvz | leaderboard | bandit | list | remove | test | Members with Manage Server; server install only |
Feeds for your server
Feeds post on their own into a channel of your server. Only members with Manage Server (or Administrator) can set them up; Discord hides /setup from everyone else.
- Add the bot to your server.
- Run
/setup battles(or kills, weekly, zvz, leaderboard, bandit) with the region and the guild or alliance to follow. Pick a channel, or leave it out to post in the channel you typed the command in. - The bot posts a hello message in that channel to check it can. If it cannot, it says which permission is missing: it needs View Channel, Send Messages and Embed Links there.
- Only fights from then on are posted, checked every 2 minutes.
/setup listshows the server's feeds,/setup removedeletes one, and/setup testposts a sample message.
| Feed | What gets posted | Options | Free | Codex+ |
|---|---|---|---|---|
/setup battles | Each new battle a guild or alliance fights, as its share card by default. | Smallest fight to post (default 20 players, 5 to 300); style: card, detailed or text. | 1 feed | 5 feeds |
/setup kills | Notable kills by or against a guild or alliance. | Smallest kill fame to post (default 1,000,000). | 1 feed | 5 feeds |
/setup weekly | A weekly report for a guild or alliance, every Monday at 09:00 UTC. | Guild or alliance, and optionally a channel. | 1 feed | 5 feeds |
/setup zvz | Every big battle on a server, whoever fought it. | 50+ players (about 100 a day); 100+ players (about 30 to 35 a day, the default); 200+ players (a handful a day); style: card, detailed or text. | 1 feed per region | 3 feeds per region |
/setup leaderboard | Every Monday: a server's top players per role and its top guilds. | Region, and optionally a channel. | 1 feed | 5 feeds |
/setup bandit | Each Bandit Assault phase change for a region. | Region, and optionally a channel and a role to ping. | Not available | One per region |
Limits are per Discord server and follow the member who sets the feed up: if they have Codex+, the higher limit applies. A Bandit Assault feed pauses if that member's Codex+ ends, and any Codex+ member can run /setup bandit again to resume it.
Free and Codex+
Every lookup and the basic feeds are free. Codex+ is the site's paid tier (it can also be earned by contributing prices); in Discord it is read from your linked account and adds:
| Free | Codex+ | |
|---|---|---|
| Battle, kill, weekly and leaderboard feeds | 1 of each per server | Up to 5 of each |
| ZvZ feeds | 1 per region | Up to 3 per region |
| Bandit Assault channel feed | No (/bandit itself is free) | Yes, with an optional role ping |
| DM alerts | No | Bandit Assault, your price alerts, your deaths |
/fame | Your main character | Any of your characters, and tracked players |
/h2h window | 7 or 30 days | Also 90 days |
Permissions it asks for
The server invite asks for five channel permissions (permission value 117760) and nothing else: no Administrator, no Manage Roles, no moderation, and no privileged intents, so it never receives your member list or message content.
| Permission | Why |
|---|---|
| View Channel | See the channel a feed posts to. |
| Send Messages | Post feeds and reports. |
| Embed Links | Replies and posts are embeds. |
| Attach Files | Share cards are posted as images. |
| Read Message History | Edit and thread its own posts. |
Slash-command replies need none of these; they are for the feeds. Adding the bot to your own account asks for no permissions at all.
Questions
Is it free?
Yes. Every lookup command and the basic feeds are free. Codex+ raises feed limits and adds the Bandit Assault feed, DM alerts, more /fame and the 90-day head to head.
Do I need an account?
Not for the lookups. /fame, /alerts and /codex topic:Me need your Discord linked on your account page, and Codex+ is checked through that link.
Why is my feed not posting?
Check the bot has View Channel, Send Messages and Embed Links in that channel, then run /setup test. /setup list says when a feed was switched off and why. Feeds post fights from the moment they are set up, not older ones, and a battle appears about 15 minutes after it ends.
Where do the numbers come from?
Prices come from the Albion Online Data Project and players running the Codex Client, so every reply shows how old its prices are. Battles come from the game's public kill records and are shown by in-game alliance.
Add the bot
Add it to your server for feeds, or to your own account to use the commands anywhere.
Unofficial fan project, not affiliated with Sandbox Interactive or Discord.