Battleboard Mentions — /battleboard

The /battleboard command fetches one or more battles from the Albion Online BattleBoard API and cross-references every participant against the bot’s member registry. The result is a ready-to-copy list of Discord mentions for every registered guild member who was in those battles — so you can paste directly into /silver add or use it as your attendance reference after a ZvZ.

Table of Contents

What is it?

After a guild fight, two things typically need to happen:

  1. Pay out silver to everyone who participated.
  2. Log attendance for those same participants.

Both operations require a list of Discord users. Hunting down who was in the battle individually is tedious. /battleboard automates that: you give it the battle ID (or multiple IDs) and it hands you a ready-made Discord mention block you can paste immediately.

Where do I find the Battle ID? Open albiononline.com/killboard or a third-party site like albionbattles.com. The battle ID is the number in the URL, e.g. https://albiononline.com/en/killboard/battles/123456789.

Typical Workflow

Payment after a ZvZ

  1. Your guild finishes a battle. Copy the Battle ID from the Albion BattleBoard.
  2. Run /battleboard ids: 123456789.
  3. The bot posts a mentions block in a code box. Copy the entire contents.
  4. Open a new message and type /silver add users:, then paste the mentions and fill in the amount.
  5. Done — silver is distributed to every registered participant in one command.

Logging attendance after a fight

  1. Run /battleboard ids: 123456789 to get the participant list.
  2. Check the Unregistered Players embed to see who still needs to be registered.
  3. Use the registered player list as a reference when running /attendance log on the voice channel, or use /attendance add to manually credit specific users.
Registration is required: Only members who have registered via /register will appear in the mentions block. Unregistered participants are listed separately so you can follow up with them.

How to Use

Command

/battleboard ids: 123456789
/battleboard ids: 123456789 987654321 111222333
/battleboard ids: 123456789,987654321

Options

OptionRequiredDescription
ids ✅ Yes One or more numeric Albion Battle IDs. Separate multiple IDs with spaces or commas. The bot merges all battles into a single unique player list, removing duplicates.
Multiple battles: Useful when you have a long CTA session with multiple recorded battles. Pass all IDs at once and the bot deduplicates players who appeared in more than one battle.

Command Output

The command sends up to three separate messages:

1 — Registered Players embed

A paginated embed listing every guild member found in the battle(s) who is registered in the bot. Players are sorted alphabetically and split across three columns by name range: #–G, H–P, Q–Z. If the list is long, use Previous / Next buttons to page through it.

2 — Unregistered Players embed

A matching paginated embed for participants who were not found in the registry. Same column layout. Use this to identify who still needs to run /register.

3 — Mentions code block

After both embeds, the bot posts a plain-text code block containing all registered players’ Discord mentions in <@ID> format. This block is split into chunks of 50 mentions to stay within Discord’s message size limits.

Copy the entire code block and paste it into the users field of /silver add:

/silver add users: <paste here> amount: 500000 reason: ZvZ 2026-04-03
Pagination timeout: The navigation buttons on the embeds expire after 5 minutes. The code block is always accessible regardless, since it’s a plain message.

Multi-Guild Support

If your server is configured with multiple guilds via /multi-guild add, the /battleboard command automatically checks all configured guilds (main + secondary). A player who belongs to any of those guilds is included in the results.

When multiple guilds are configured, the player name in each embed shows the guild they belong to in parentheses, e.g. PlayerName (SecondaryGuild), to make it easy to distinguish members across guilds.

Guild configurationPlayer name format
Single guild PlayerName
Multiple guilds PlayerName (GuildName)
See Multiple Guilds for details on configuring secondary guilds.

Troubleshooting

"No players from your configured guilds were found"

Either no member from your guild participated in that battle, or the Battle ID is incorrect. Double-check the ID directly on the Albion Online website or albionbattles.com.

"Please provide at least one valid numeric Battle ID"

Battle IDs must be numbers only. Make sure you’re not copying extra characters from the URL.

"The Albion Guild ID is not configured"

Run /setup start to complete guild configuration before using this command.

The mentions code block is missing

No registered players were found in the battles. Check the Unregistered embed — those members need to register via /register or /force-register before they appear in the mentions block.

A player was in the battle but is not in the registered list

That player has no record in the bot database for this server. They need to /register or an admin needs to run /force-register for them.

The same player appears twice

This should not happen — the bot deduplicates by Albion player ID across all provided battle IDs. If it occurs, please report it.