Player Statistics — /stats

The /stats command generates statistical reports about the registered members of your guild. It provides two views: a breakdown by geographic region and a breakdown by class role. Each view shows a summary embed followed by detailed per-region or per-role pages with the full list of players.

Table of Contents

What is it?

Leadership often needs a quick snapshot of the guild composition — how many players are in each timezone region and how many players fill each class role. /stats reads directly from the registered member database and presents this data as Discord embeds, paginated so no information is ever cut off regardless of guild size.

Only members who have registered with the bot (via /register or through the dashboard) are included in these statistics. Unregistered Discord members are not counted.

🔒 Permissions

Using /stats requires the Management Role configured for the server. Regular members cannot run this command.

Role Can Run /stats?
Management Role (configured) ✅ Yes
Regular members ❌ No — permission denied message

⚙️ Subcommands

/stats has two subcommands. You must choose one:

Subcommand Full Command Description
region /stats region Generates a report grouped by player region (ASIA, EU, NA).
roles /stats roles Generates a report grouped by class role (Healer, DPS, Tank, etc.).

🌍 Stats by Region — /stats region

This subcommand produces a report split into the three recognized regions:

Region
ASIA
EU
NA

Page 1 — Summary Embed

The first page shows a summary with the player count for each region as inline fields:

Following Pages — Region Detail

After the summary, one page is generated for each region that has at least one member. Each page lists every player as a Discord mention and their Albion Online player name:

@DiscordUser (AlbionPlayerName)
@AnotherUser (AnotherAlbionName)
...
If a region's player list is very long and would exceed Discord's 4,096-character description limit, the report automatically splits into multiple pages for that region with column-aligned fields, showing up to 20 players per column.

⚔️ Stats by Class Role — /stats roles

This subcommand produces a report for each of the eight recognized class roles:

Class Role
Arcane Support
Battlemount
Clump Tank
Curse Support
D-Tank
DPS
Healer
Oathkeeper/Groot

Page 1 — Summary Embed

The first page summarizes all roles in a compact grid:

Following Pages — Role Detail

After the summary, one page is generated for each role that has at least one member. Each page shows two columns side by side:

Column Content
1st Role Players for whom this is their primary class role. Shows @DiscordUser (AlbionName) per line. If no players, shows "No players".
2nd Role Players for whom this is their secondary class role. Same format. If no players, shows "No players".
A player can appear in a role's page twice — once under 1st Role and once under 2nd Role — if they registered with that role as both primary and secondary. This is intentional.

📄 Pagination

When there is more than one page of data (which is almost always), the bot attaches Previous and Next navigation buttons to the response.

Button Behavior
Previous Goes to the previous embed page. Disabled on the first page.
Next Goes to the next embed page. Disabled on the last page.

Each page's footer shows the current position, e.g. "Page 2/6". The buttons expire after 5 minutes of inactivity — after that, the footer updates to "Page X/Y (Interaction ended)" and the buttons are removed. Only the person who ran the command can use the navigation buttons; other users receive an ephemeral error.

🔧 Troubleshooting

Problem Cause Solution
"You do not have permission to use this command." The user does not have the Management Role configured for the server Ask an administrator to assign the Management Role, or configure it via /setup
"No registered members found in this server" No members have registered with the bot yet Members must register via /register or be added through the dashboard. Stats only count registered members
A region or role is missing from the report No registered members have that region or role assigned Regions/roles with zero members are skipped in the detail pages but still appear in the summary with a count of 0
Buttons stop responding after a while The 5-minute interaction timeout was reached Run the command again to get a fresh, interactive report
"You cannot use these buttons." A different Discord user clicked the navigation buttons Only the person who ran /stats can navigate the pages. Others must run the command themselves