Voice Role Report — /voice-report

The /voice-report command shows the role composition of everyone currently connected to a Discord voice channel. It answers the question: "Of all the people in this call, how many can play Healer? Tank? DPS?" — so leadership knows exactly what they have available before a fight, without having to ask one by one.

Table of Contents

What is it?

Before or during a guild event, leaders often need to know: "I need 3 healers — do I have enough available in the call right now?"

Instead of pinging everyone individually, run /voice-report and get an instant breakdown. The command:

  1. Reads who is currently connected to the selected voice channel.
  2. Looks up each member in the bot database to find their registered primary and secondary Albion Online roles.
  3. Produces a paginated embed — one page per role category — listing who can fill that role.
  4. Shows a final page with members who are not registered, so you know whose role is unknown.
Example use case: You have 40 members in the call but only need 2 healers. Open the Healer page of the report and you see 7 people who registered as Healer (primary or secondary). Now you can pick and assign without guessing.

Why Registering All Members Matters

The bot can only identify a member's Albion role if they have registered via /register. Registration links a Discord user ID to an Albion Online character name and their primary / secondary roles.

An unregistered member in the call appears on the Unregistered page — their role is unknown, which means they cannot be counted toward any composition slot.

Member statusWhat the report showsCounted in role pages?
Registered Discord mention + Albion name, listed under their Primary and/or Secondary role page ✅ Yes
Not registered Discord mention only, listed on the Unregistered page ❌ No
Keep your roster registered: The more unregistered members there are, the less accurate your role count will be. Use /force-register to register members who haven't done it themselves.

How to Use

Command

/voice-report voice-channel: #channel-name

Step by step

  1. Make sure members are already connected to the target voice channel.
  2. Run /voice-report and pick the voice channel from the autocomplete list.
  3. The bot replies with the first role page. Each page is a different role category.
  4. Use Previous / Next to navigate between role pages.
  5. The final page lists everyone who is unregistered.

Options

OptionRequiredDescription
voice-channel ✅ Yes The voice channel to inspect. Only voice channels appear in the autocomplete.

Report Output

The report generates one embed page per Albion Online role category (the same roles available during /register), plus one final page for unregistered users.

Role pages

Each role page is split into two sections:

Each entry shows the Discord mention and the registered Albion character name:

- @DiscordUser (AlbionCharacterName)

Unregistered page

The final page lists every voice channel member without a registration record. They appear as Discord mentions only — their role is unknown.

Bots are ignored: Bot accounts in the voice channel are automatically excluded from all report pages.

Pagination

Because Albion Online has several role categories, the report paginates — one page per role, followed by the Unregistered page. Two buttons appear at the bottom of the embed:

ButtonAction
PreviousGo to the previous role page. Disabled on the first page.
NextGo to the next role page. Disabled on the last page.
Timeout: Pagination is active for 5 minutes. After that, the embed is deleted and a timeout notice is posted to the channel. Run the command again for a fresh report.
Only you control it: The buttons only respond to the user who ran the command.

Troubleshooting

"No users are currently in the voice channel"

The selected voice channel has no members connected at the time the command ran. Wait for members to join and run the command again.

"Please select a valid voice channel"

The channel provided is not a voice channel. The autocomplete already filters to voice channels only, so this should not normally happen.

Many users are on the Unregistered page

Those members have not run /register yet. Ask them to register, or use /force-register to do it on their behalf. Until registered, their role cannot be counted.

A member appears on the wrong role page

The role shown comes from whatever was saved at registration time. If their role changed in-game, they need to update their registration, or an admin can use /force-register.

Buttons stopped responding before 5 minutes

The embed may have been deleted, or the bot was restarted. Run the command again.

Find Skippers — /voice-report

The /voice-report command cross-references who is currently connected to a Discord voice channel with the registered member database. It generates a paginated report organized by Albion Online role, making it easy to identify who is in the call, what their in-game role is, and — most importantly — who might be skipping (i.e., present in the call but absent in-game, or vice versa).

Table of Contents

What is it?

When a guild event or ZvZ is happening, leaders often need a quick answer to: "Who is in the voice call right now, and what role do they play?"

The /voice-report command answers that instantly. It:

  1. Reads the current list of Discord members connected to the selected voice channel.
  2. Looks up each member in the bot database to find their registered Albion Online character name, primary role, and secondary role.
  3. Produces a paginated embed organized by role category (e.g., Tank, Healer, DPS, etc.).
  4. Lists unregistered users on the final page, so you know who cannot be identified.
The "Skipper" concept: A skipper is a player who is in the Discord call (showing as present to leadership) but not actually playing in the event. By comparing the voice report with the in-game roster (e.g., from Albion's battleboard or a manual check), guild leaders can identify who is skipping.

Why Registering All Members Matters

The bot can only identify a Discord user in-game if they have registered via /register. Registration creates a link between a Discord user ID and an Albion Online character name.

Without registration, the command can only say "this Discord account is in the call" — it cannot tell you which in-game player that is, nor their role. That person appears on the Unregistered page of the report.

ScenarioWhat the report showsCan detect skippers?
Member is registered Discord mention + Albion name + role (Primary / Secondary) ✅ Yes
Member is NOT registered Discord mention only, listed as "Unregistered" ❌ No
Keep your roster registered: The more unregistered members there are, the less useful this report becomes. Encourage all guild members to run /register as part of onboarding. Admins can use /force-register to register members manually.

How to Use

Command

/voice-report voice-channel: #channel-name

Step by step

  1. Make sure the target voice channel has members connected to it.
  2. Run /voice-report and select the desired voice channel from the autocomplete list.
  3. The bot will reply with a paginated embed. The first page shows the first role category.
  4. Use the Previous and Next buttons to navigate between role pages.
  5. The last page always shows Unregistered users.

Options

OptionRequiredDescription
voice-channel ✅ Yes The voice channel to inspect. Only voice channels appear in the autocomplete.

Permissions

WhoCan use
Any user with permission to run slash commands in the channel ✅ Yes — no special role required

Report Output

The report is split into one embed page per role category, plus one final page for unregistered users.

Role pages

Each role page shows two sections:

Each entry displays the Discord mention and the registered Albion character name:

- @DiscordUser (AlbionCharacterName)

Unregistered page

The final page lists every Discord member in the voice channel who does not have a registration record for this server. They are shown as mentions only.

Users in VC but not registered:
@User1
@User2
Bots are ignored: Bot accounts connected to the voice channel are automatically excluded from the report.

Pagination

Because Albion Online has many role categories, the report paginates — one page per role, plus the Unregistered page. Navigation buttons appear at the bottom of the embed:

ButtonAction
PreviousGo to the previous role page. Disabled on the first page.
NextGo to the next role page. Disabled on the last page.
Timeout: The pagination is active for 5 minutes after the command is run. After that, the original embed is deleted and a message is sent to the channel informing that the session has timed out. Run the command again to generate a fresh report.
Only you control it: The Previous / Next buttons only respond to the user who ran the command. Other users cannot change the page.

Troubleshooting

"No users are currently in the voice channel"

The selected voice channel has no members connected to it at the moment the command was run. Wait for members to join, then run the command again.

"Please select a valid voice channel"

The channel provided is not a voice channel. Only voice channels are accepted. The Discord autocomplete already filters to voice channels only, so this should not normally occur.

Many users are on the Unregistered page

Those members have not completed registration with /register. Ask them to register, or use /force-register to register them manually. Until they are registered, their Albion name and role cannot be determined from this report.

A registered member appears on the wrong role page

The role shown in the report is whatever was saved when the member registered or last updated their profile. If their in-game role has changed, they need to update their registration. An admin can also use /force-register to update it.

Buttons stopped responding before 5 minutes

The original embed may have been deleted by someone with Manage Messages permission, or the bot was restarted. Run the command again to get a fresh report.