FAQ

Answers to the most common questions about Zagreus. If your question is not covered here, reach out in the support server.

---

General

How do I add Zagreus to my server?

Log in to the web dashboard with your Discord account. From the server selector, click Add to Server and follow the Discord OAuth2 flow to authorize the bot. You must have Manage Server permission in the target server.

What permissions does Zagreus need?

Zagreus requires the following Discord permissions to function correctly:

---

Trading

How do I set up trade channels?

How does the reputation system work?

Reputation is earned when other members react to your trade posts with the designated reputation emoji (configured per-server, defaults to a star).

• Each unique user can give you one reputation point per trade post
• Reputation accumulates permanently and is displayed on your profile and in leaderboards
• After 7 days, buyers who interacted with a trade but have not left reputation receive a reminder
• When you reach the configured reputation threshold (default: 3), you are automatically assigned the trusted trader role

What is a trade number?

Every trade posted in a monitored channel is automatically assigned a sequential trade number. Trade numbers serve several purposes:

• Unique identification: Reference specific trades in discussions, disputes, or moderation actions
• Chronological ordering: Trade numbers increment sequentially, providing a clear timeline
• Cross-referencing: Search, audit logs, and moderation tools use trade numbers for precise identification
• Statistics: Trade numbers power volume metrics and analytics

Trade numbers are per-channel and displayed in the trade post or as a reaction by the bot.

---

Gaming

Why is my game not being tracked?

There are several reasons a game might not appear in your stats:

1. Activity Status is disabled — Go to Discord Settings > Activity Privacy and enable "Display current activity as a status message." This is the most common cause.
2. The game is not recognized by Discord — Discord must detect the application as a game. You can manually add games in Discord Settings > Activity Privacy > Add it.
3. The game is on your blacklist — Check /playtime blacklist list to see if you have blacklisted the game.
4. Session was too short — Sessions under 10 minutes are not counted in session stats (though all playtime is counted toward totals).
5. The bot was offline — If Zagreus was restarting or offline during your session, it may not have captured the presence update.

What counts as a valid session?

A valid session is any continuous play period of 10 minutes or longer. Sessions shorter than 10 minutes are filtered out of session counts and streak calculations to avoid counting accidental launches.

However, total playtime includes all sessions regardless of length. If you play a game for 5 minutes, those 5 minutes are added to your total playtime for that game, but the session itself does not count toward your session total or daily streak.

Can I hide specific games from my profile?

Yes. Use /playtime blacklist add <game> to exclude a game from all your stats, leaderboards, and public profile. Blacklisted games:

• Are not tracked going forward
• Are hidden from your profile and leaderboard entries
• Do not affect your streaks or milestones
• Are only visible to you in your blacklist settings

You can remove a game from the blacklist at any time with /playtime blacklist remove <game>. Tracking resumes immediately, but historical data from the blacklisted period is not retroactively added.

---

Dashboard

Who can access the web dashboard?

Anyone with a Discord account can log in to the dashboard. However, what you see depends on your permissions in each server:

Servers you are not a member of will not appear in your server selector. Public pages (leaderboards, active giveaways) are accessible without logging in.

Are leaderboards public?

Yes. Trade leaderboards, gaming leaderboards, and active giveaways are publicly accessible without authentication. Anyone with the link can view them.

• Leaderboards are accessible at your server's vanity URL (if configured) or via a direct link
• Public leaderboards show usernames, avatars, and stats but not sensitive moderation data
• Individual users can opt out of public leaderboards via their privacy settings

---

Giveaways

How do bonus entries work?

Bonus entries give members with specific roles a higher chance of winning without guaranteeing a win. They function as weighted multipliers in the random drawing.

Here is how the math works:

1. Every eligible member starts with 1 base entry
2. If a member has a role assigned a 3x bonus, they get 3 entries in the pool instead of 1
3. If a member has multiple bonus roles, the multipliers stack additively — a member with 2x and 3x roles gets 5 total entries (2 + 3)
4. The winner is randomly selected from the weighted pool, so a member with 5 entries has 5x the chance of a member with 1 entry

Bonus entries are displayed in the giveaway embed so all members can see the odds. The maximum multiplier per role is 10x, and up to 10 bonus roles can be configured per giveaway.

What happens if a winner does not claim their prize?

If the giveaway has a claim system enabled:

1. Winners are notified via DM and in the giveaway channel that they have won
2. They must click the Claim Prize button on the giveaway embed within the configured deadline (e.g., 24 hours)
3. If a winner does not claim within the deadline, their prize is automatically rerolled
4. A new winner is selected from the remaining entry pool (excluding all previous winners)
5. The new winner receives the same claim deadline and notification
6. This process repeats until the prize is claimed or the entry pool is exhausted

If no eligible entries remain after exhausting the reroll pool, the prize is marked as unclaimed and the giveaway host is notified to handle it manually.