Attendance System

The Attendance System lets guild leaders track who shows up to events, ZvZs, and activities. Each time someone participates, they earn attendance points. Over time, a leaderboard shows who the most active members are — making it easy to reward dedication and identify who is consistently showing up for the guild.

📖 Table of Contents

• How It Works
• For Members
• Attendance Leaderboard
• For Leaders — Logging Events
• Point Multipliers
• Manually Adding or Removing Points
• Managing Attendance in the Dashboard
• Exporting Data
• Resetting Attendance
• Troubleshooting

🔍 How It Works

Here's the basic flow:

👤 For Members

As a regular member, you don't need to do anything special during an event. Just be in the voice channel when leadership logs the event and you'll automatically earn your point.

What counts as a point?

Every separate event logged by leadership grants you a number of points determined by the event's multiplier. A standard event gives 1 point. Special or more important events may give 2, 3, or more points at once.

Checking your points

Use /attendance leaderboard to see your position and total points compared to the rest of the guild.

🏆 Attendance Leaderboard

/attendance leaderboard

Shows a paginated ranking of all guild members ordered by their total attendance points. Each page displays up to 10 members. Your own position is highlighted even if you are not in the top 10.

🎖️ For Leaders — Logging Events

Logging an event is how attendance points are granted. The process is designed to be fast — do it while everyone is still in the call.

/attendance log

/attendance log voice-channel: #channel-name event-name: ZvZ Tuesday

Step by step

1. Make sure everyone who participated is already in the voice channel.
2. Run /attendance log.
3. Pick the voice channel from the autocomplete list.
4. Type a name for the event (e.g. ZvZ Tuesday, Crystal League Week 5).
5. Optionally set a multiplier if the event is worth more points.
6. The bot processes everyone in the channel and replies with a summary.

What the summary shows

Section	What it means
Registered Players	Members who were recognized and received points
Unregistered Users	People in the call who are not registered with the bot — they did NOT earn points

✖️ Point Multipliers

By default, each event is worth 1 point. If an event is especially important (a major ZvZ, a hard-fought Crystal match, a required guild event) you can make it worth more by adding a multiplier.

/attendance log voice-channel: #zvz event-name: Season Finals multiplier: 3

In this example, every member in the channel earns 3 points instead of 1.

Multiplier	Points per member	Example use
1 (default)	1	Regular weekly ZvZ
2	2	Important campaign event
3	3	Major alliance war
5	5	Season final, mandatory event

✏️ Manually Adding or Removing Points

Sometimes a member attended but couldn't join the voice channel (connection issue, late arrival) or someone needs to have points corrected. Leaders can adjust points manually.

Adding points manually

/attendance add users: @Player1 @Player2 multiplier: 2

Adds points to one or more members. Mention as many users as needed, separated by spaces. The multiplier works the same way as in /attendance log.

Removing points

/attendance remove users: @Player1 amount: 1

Removes a specified number of points from one or more members. The amount defaults to 1 if not specified.

🖥️ Managing Attendance in the Dashboard

The Dashboard gives leaders a full view of all attendance data and provides more management options than the Discord commands alone.

Accessing the Attendance Dashboard

1. Go to the Dashboard and select your Discord server.
2. Click Attendance in the sidebar.

What you'll find

Summary cards

At the top of the page, four cards give a quick snapshot:

Card	What it shows
Total Events Logged	How many attendance sessions have been recorded for this server
Total Registered Participants	Total number of registered member attendances across all events
Unique Members Tracked	How many distinct members have at least one point
Unregistered Participants	Total unregistered entries across all events (they have no points)

Attendance Records table

A searchable, paginated table showing every registered member and their total attendance points. Each row has two action buttons in the Actions column:

Button	What it does
View Details	Opens a panel showing the full history for that member: Their Albion character name and Discord tag. Total attendance points. Total number of events attended. A list of every event they participated in, showing the event name, date, and how many points that event gave them.
Delete	Permanently removes that member's attendance record (all their participation history and points). A confirmation prompt appears first.

Events table

A searchable, paginated table of every logged event. Each row shows:

• Event name and date it was logged.
• Voice channel it was logged from.
• How many registered and unregistered participants were present.
• The multiplier used for that event.
• Who logged the event.

Each row also has three action buttons in the Actions column:

Button	What it does
View Participants	Opens a panel showing everyone logged in that specific event: Event name, voice channel, date, and multiplier. Registered participants — listed in a grid with their Albion name and how many points they received. Each entry has a red remove button to take them out of the event (and reverse their points). Unregistered participants — people who were in the call but had no registration record at the time of logging. A search box at the bottom to add a member who was missed — type their name, select them from the list, and confirm. The bot adds them and grants the appropriate points automatically.
Edit	Opens a small panel to change the event's name or multiplier after the fact. Useful when you made a typo in the event name or used the wrong multiplier.
Delete	Removes the event entirely — this also removes the attendance points that were granted for it from every participant. A confirmation prompt appears first.

Quick Action buttons

At the top of the Attendance page, just below the summary cards, there are three action buttons available to leaders:

Button	What it does
Export to CSV	Downloads all attendance records as a spreadsheet file. Same as running /attendance export in Discord.
Add Attendance	Opens a panel to manually add points to one or more members directly from the dashboard (see below).
Reset All Data	Deletes all attendance records, events, and points for the server. A confirmation prompt appears before anything is deleted.

Add Attendance panel (dashboard)

Clicking Add Attendance opens a panel where you can give points to multiple members at once without leaving the dashboard:

1. In the search box, type the Albion name of a member. A dropdown list will appear.
2. Click the member's name to add them to the selection list. Repeat for as many members as needed.
3. Set the number of points in the Attendance Count field (default is 1).
4. Click Save. All selected members receive the points immediately.

To remove someone from the selection list before saving, click the red remove button next to their name.

📤 Exporting Data

You can export a full spreadsheet of all attendance records in two ways:

• Dashboard → Attendance → click Export to CSV.
• Or run /attendance export in Discord — the bot will send the file as an attachment.

The file can be opened in any spreadsheet application (Excel, Google Sheets, etc.). Useful for season reviews, external reports, or keeping a backup before a reset.

🗑️ Resetting Attendance

You can reset all attendance data in two ways:

• Dashboard → Attendance → click Reset All Data.
• Or run /attendance reset in Discord.

Both options delete all records, events, and points for the server. This action cannot be undone. A confirmation prompt always appears before anything is deleted.

🔧 Troubleshooting

"You don't have permission to use this command"

The log, add, remove, and reset commands require the configured management role. Check that the user running the command has that role. It can be set up via /setup start.

A member was in the call but did not receive points

They are not registered with the bot. They need to run /register first, or a leader can use /force-register on their behalf. Once registered, use /attendance add to give them the missed points manually.

"No users found in the specified voice channel"

The voice channel was empty when the command ran. Make sure members are still in the channel before logging, or use /attendance add to add points manually after the fact.

A member's point total looks wrong

Open the Dashboard → Attendance, find the member in the table and click View Details to see a breakdown of every event they attended. If an event was logged incorrectly, you can edit or delete it from the Events table to correct the total.

The leaderboard is empty

No attendance events have been logged yet, or all records were reset. Run /attendance log after your next event to start building the leaderboard.