The /ratings command gives staff leadership an at-a-glance view of how each team member is performing based on community feedback. Whether you want to check in on a specific staff member or review your entire team’s standing, /ratings surfaces the data you need in one organized embed.
Command Usage
| Parameter | Type | Required | Description |
|---|
staff_member | @mention | ❌ Optional | The staff member to view ratings for. Omit to see all staff ratings. |
Permissions
The /ratings command is restricted to staff-level roles and above to protect the integrity of the feedback process.
| Role | Access |
|---|
| Staff role or higher | ✅ Allowed |
| General members | ❌ Restricted |
The specific roles that qualify as “staff or higher” are determined by your server’s role configuration in /config. Make sure your staff roles are properly set up before using this command.
Viewing a Single Staff Member
When you provide a @staff_member mention, Burger Bot returns a detailed summary for that individual, including:
- Average star rating — calculated across all submitted feedback
- Total submissions — the number of feedback entries received
- Rating breakdown — a count of each star level (1★ through 5★)
- Recent feedback snippets — the most recent written feedback entries (truncated for brevity)
- Trend indicator — whether their average rating has gone up or down recently
Example Output
📊 Feedback Summary — @Moderator_Jake
──────────────────────────────────────
⭐ Average Rating: 4.6 / 5
📝 Total Feedback: 14 submissions
──────────────────────────────────────
★★★★★ 9 ██████████
★★★★☆ 4 ████
★★★☆☆ 1 █
★★☆☆☆ 0
★☆☆☆☆ 0
──────────────────────────────────────
Recent Feedback:
• "Super helpful during tonight's patrol." (5★)
• "Resolved my ticket fast, very professional." (5★)
• "A little slow to respond but got it sorted." (3★)
Viewing All Staff Ratings
Running /ratings without a mention displays a leaderboard-style overview of all staff members who have received feedback, sorted by average rating. This is useful for quarterly reviews, promotions, or spotting team members who may need additional support.
Use the /ratings leaderboard during staff meetings to publicly celebrate your top-rated team members. Recognition goes a long way toward building a motivated staff team.
Data Freshness
Ratings are calculated in real time from all submissions stored in the feedback logs. There is no caching delay — a new feedback submission is immediately reflected in /ratings output.
If a staff member has no feedback submissions yet, they will not appear in the all-staff leaderboard. Encourage regular use of /submitfeedback to ensure meaningful data is available for reviews.
