Leaderboards

The bot provides a complete leaderboard system accessible from two places: directly inside Discord via slash commands (quick embeds) and through the public web pages (sortable tables with CSV export). Both sources read from the same live database, so data is always consistent.

Table of Contents

• Overview
• Discord Leaderboards (/leaderboard)
  • Dashboard Event Leaderboard
  • Silver Balance Leaderboard
  • Siphon Energy Leaderboard
• Public Web Leaderboards
  • How to Access
  • Balance Leaderboard
  • Siphon Leaderboard
  • Attendance Leaderboard
  • Event Detail View
  • Shared Features
• Troubleshooting

Overview

Leaderboard	Discord Command	Public Web Page	What it ranks
Dashboard Events	/leaderboard dashboard	—	Members by number of events submitted to the event dashboard.
Silver Balance	/leaderboard balance	/leaderboard/balances	Members by current or all-time silver deposited to the bank.
Siphon Energy	/leaderboard siphons	/leaderboard/siphons	Members by total energy contributed to hideout siphons.
Attendance	—	/leaderboard/attendance	Members by attendance points earned across all events.

Discord Leaderboards — /leaderboard

Run directly in any Discord channel. Results are posted as embeds. All three subcommands are available to any member that can use slash commands in the channel.

Dashboard Event Leaderboard

Ranks members by how many events they submitted to an event dashboard board.

Option	Value	Description
period	Weekly	Counts only events created since the start of the current UTC week (Sunday 00:00 UTC).
period	All-Time	Counts all events ever created on any dashboard in the server.

Example embed — Weekly

Silver Balance Leaderboard

Ranks members by their bank silver balance. Shows up to 100 players, paginated 20 per page with Previous / Next buttons.

Option	Value	Description
type	Current Balance	Ranks by the member’s current silver balance. Page 1 also shows the total active balance across all top-100 accounts.
type	All-Time Added	Ranks by total silver ever deposited by the member (never decreases on withdrawal).

Example embed — Current Balance (page 1)

Siphon Energy Leaderboard

Ranks members by total Siphon Energy they have contributed. Shows up to 100 players, paginated 20 per page. Players added to the Siphon Ignored List are excluded from the ranking.

Public Web Leaderboards

The web leaderboards are accessible from any browser, do not require Discord to be open, and offer richer features: sortable columns, player avatars (balance), and CSV export. They require a Discord login to select which server to view.

How to Access

1. Go to /leaderboards on the bot website, or click Leaderboards in the navigation bar.
2. Log in with Discord if prompted.
3. A list of servers where you are a member and the bot is installed appears. Select your server.
4. Choose one of the three leaderboard types: Bank Balances, Siphon Leaderboard, or Attendance Leaderboard.

Balance Leaderboard

Route: /leaderboard/balances?guildId=YOUR_GUILD_ID

Column	Description	Sortable?
Rank	Position in the leaderboard.
Player	Discord avatar + username + user ID. Clicking the name opens the Member Profile page.
Silver Balance	Current silver in the member’s bank account.
Lifetime Balance	Total silver ever deposited, independent of withdrawals.

Siphon Leaderboard

Route: /leaderboard/siphons?guildId=YOUR_GUILD_ID

Column	Description	Sortable?
Rank	Position in the leaderboard.
Player	Albion Online nickname linked to the Albion player profile.
Siphon Energy	Total energy contributed across all siphon transactions logged.

Attendance Leaderboard

Route: /leaderboard/attendance?guildId=YOUR_GUILD_ID

Column	Description	Sortable?
Rank	Position in the leaderboard.
Player	Discord mention with Albion name. Clicking opens the member’s attendance event history.
Attendance Points	Total accumulated attendance points earned from all events.
Events Attended	Total number of distinct events the member participated in.

Event Detail View

From the Attendance Leaderboard, clicking any event name opens a dedicated event page at /leaderboard/attendance/event/:eventId.

This page shows:

• Summary cards — event name, date, registered attendance count, unregistered attendance count, and total participants.
• Participant table — sortable list of all members who attended, with their Albion name, Discord tag, points earned, and registration status.
• Export to CSV button for offline analysis.

Shared Features (all public pages)

Feature	Details
Sortable columns	Click any column header to sort ascending or descending. An arrow icon shows the current sort direction.
Export to CSV	An Export to CSV button appears above the table. Downloads a file named with the guild name and today’s date (e.g. siphon_leaderboard_Oblivion_2026-04-03.csv).
Shareable URL	Every page URL includes ?guildId=. You can share this link directly and anyone logged into Discord who is a member of the server can view it.
Last update date	Each page shows when the most recent data entry was logged (last transaction, last event, etc.).

Troubleshooting

Problem	Likely Cause	Fix
“No accounts found” on balance leaderboard	No members have a bank account entry in this server.	Ensure members have deposited silver at least once via the bank system to create their account entry.
Player missing from siphon leaderboard	Player is on the siphon ignore list, their name spelling differs, or no siphon logs have been imported.	Check the ignore list with /siphons ignore list. Verify the Albion name in the latest import logs.
Attendance leaderboard shows 0 events	No events have been created and closed via the attendance system yet.	Create and close at least one attendance event so the system records participants.
Pagination buttons are greyed out	The 5-minute button interaction timeout expired.	Re-run the /leaderboard command to get a fresh embed with active buttons.
Public page shows “not a member” error	You are logged in with a Discord account that is not a member of that server.	Log in with the correct Discord account, or ensure your guild membership is visible. Try Refresh Server List on the guild selection page.
CSV export is empty	Table has no data rows, or the table ID was not found.	If the table shows data but the CSV is empty, try a hard refresh (Ctrl+Shift+R). If the issue persists, the table may have failed to load — check the browser console.