Statroles

Statroles automatically reward members with roles based on their lifetime activity on your server — how many messages they've sent, how much time they've spent in voice, how many games they've won, or how long they've been a member. Unlike Leveling rewards, statroles are based on raw cumulative totals, not the XP formula.

Go to Panel → your server → Statroles to set them up.

🎯 How it works

Each statrole maps a role to an activity threshold:

When a member crosses the threshold, the bot gives them the role automatically. You can optionally have the role removed again if the member ever drops below the threshold.

Every one of these totals only ever goes up, so removal mainly matters if you also use XP decay or resets.

➕ Creating a statrole

1. Pick the role to grant (make sure the YAWBDB bot role sits above it in your role list, or it can't assign it).
2. Choose the metric — messages, voice time, games won, or time in server.
3. Set the threshold (e.g. 1000 messages, 600 voice minutes, 50 wins, 30 days).
4. Optionally tick remove the role if the member drops below the threshold.

You can create several statroles, including more than one on the same role (e.g. different tiers) — each role + metric pair is unique.

⏱ When roles are applied

Each metric is checked wherever it actually changes:

• Messages & voice statroles are checked as members stay active — the role is granted the next time the member sends a message or earns voice XP after crossing the threshold.
• Games won statroles are checked the moment a member wins — so the role lands with the win that earned it, not on the next message.
• Time in server statroles are reconciled by a periodic sweep (a few times a day), since that one doesn't depend on member activity.

So existing members earn their statroles shortly after you create the rule, as they're active or on the next sweep — not necessarily the instant you click save.

⚠️ Messages and voice statroles require the Leveling feature to be enabled — that's how the bot tracks message and voice activity. Games won statroles require the Games feature, since that's what records wins. The Time in server metric works on its own, with or without either.

The messages count tracks messages that earn XP — at most one per Leveling cooldown window — not every single message. So a "1,000 messages" threshold reflects sustained activity rather than a raw message tally, and rapid spam won't inflate it.

🎮 What counts as a game won

A games won statrole counts every win a member has scored in the Games hub on your server:

• Mini-game wins — Hangman, Trivia, Rock–Paper–Scissors (including duels) and Bingo.
• Wordle solves — every day the member cracked the word.

/8ball and /love never count: they have no winner, so they're plays rather than wins.

Only wins scored while the game was switched on count — turning a game off stops it feeding the total, and past wins stay counted. The total is per server, so a member's wins elsewhere don't follow them here.

This pairs naturally with XP on win in the Games settings: XP rewards each individual win, while a statrole marks the milestone. A "Game Champion" role at 50 wins gives regular players something to chase that a single lucky round can't hand them.

🆚 Statroles vs Leveling rewards

Both can assign roles, but they answer different questions:

• Leveling rewards fire on levels, prestige and XP — shaped by your XP rates, multipliers, streaks and decay.
• Statroles fire on raw totals — a flat "sent 1,000 messages", "100 hours in voice" or "50 games won" milestone, independent of the XP curve.

Use whichever fits, or both. You don't need to build any reward graph for statroles — but each metric needs the feature that feeds it: Leveling for messages and voice, Games for games won. The "time in server" metric works without either.

🔑 Access

Statroles is available to server owners and team members with at least Moderator role in the YAWBDB panel. Enable the Statroles feature on your server first — turning it off stops new grants without deleting your rules.