Reputation Dashboard UI Guide
Learn how to navigate and use the reputation dashboard to configure settings, manage leaderboards, and track vouch history.
Dashboard Overview
Access the reputation dashboard at /dashboard/reputation. The dashboard has several key sections:
Main Sections
Reputation Settings
Configure fundamental reputation system parameters:
System Enable/Disable
Toggle at the top of the settings panel. Green button when enabled, gray when disabled. Disabling pauses all reputation tracking.
Scoring Multiplier
Slider to adjust how many points each vouch is worth server-wide.
Range: 0.5x to 5.0x • Default: 1.0x
Example: At 2.0x, a 1-point vouch becomes 2 points
Reputation Decay Toggle
Enable optional monthly reputation decay. When enabled:
- • Decay Rate slider (5-15% per month typical)
- • Users slowly lose reputation each month
- • Minimum floor to prevent dropping below tier requirements
- • Can be reset monthly on specific date
Display Settings
Show in Profiles: Toggle to display reputation in user info
Public Leaderboard: Toggle to make leaderboard visible to all
Leaderboard Channel: Optional channel to post monthly leaderboard updates
Save Settings
Green button with black text at the bottom. Changes apply immediately to the system.
Tier Configuration
Customize reputation tiers and their properties:
Editing Tiers
Each tier shows editable fields:
- • Name: Text field (e.g., "Trusted Member")
- • Min Points: Number field for tier threshold
- • Color: Color picker for display
- • Badge: Optional emoji or icon
- • Role: SearchableSelect for auto-assigned role
- • Vouch Weight: Multiplier for vouches from this tier
- • Daily Vouch Limit: Max vouches this tier can give
Add New Tier
Button to add custom tiers beyond the defaults. Form appears with all tier fields for you to configure.
Delete Tier
Red delete button on each tier row. Requires confirmation. Users in deleted tier move to next lower tier.
Tier Preview
Live preview showing how each tier looks with its color and badge as you edit.
Vouch Settings
Configure how the vouch system operates:
Cooldown Configuration
Per-User Cooldown: Hours between vouches to same person (slider: 1-72h)
Global Daily Limit: Max vouches per user per day (slider: 1-100)
Receive Limit: Max vouches a user can get per day (slider: 1-100)
Minimum Requirements
Minimum Account Age: Days account must exist (slider: 0-365)
Minimum Server Age: Days in server before can vouch (slider: 0-365)
Minimum Level: Level requirement to vouch (number input)
Minimum Reputation: User's own reputation required (number input)
Self-Vouch Prevention
Toggle to enable/disable. When enabled (recommended), users cannot vouch for themselves.
Vouch Notification Channel
SearchableSelect dropdown to choose channel for vouch announcements. Leave empty to disable announcements.
Required Roles to Vouch
Multi-select SearchableSelect. Leave empty if no role requirement. Only users with these roles can vouch.
Reputation Leaderboard View
Display top members by reputation points:
Leaderboard Tabs
All-Time: Total reputation points accumulated
Monthly: Points earned in current month
Weekly: Points earned in past 7 days
This Month vs Last Month: Comparison view
Leaderboard Table Columns
Rank: Position number (1st, 2nd, etc.)
User: Avatar and username with tier badge
Points: Current reputation points
Tier: Current tier badge and name
Vouches Received: Total vouches count
View Profile: Link to user reputation details
Leaderboard Interactions
- • Click user name to view their profile
- • Sort by clicking column headers
- • Scroll to see more entries
- • Paginated view showing top 100 users
Export Leaderboard
Download button to export current leaderboard view as CSV or PDF for announcements or archival.
User Reputation Lookup
Search for individual user reputation information:
User Search
SearchableSelect dropdown to find users in the server. Type username or ID to filter.
User Profile Card
Displays comprehensive user reputation information:
- • Username, ID, and avatar
- • Current reputation points and tier
- • Total vouches received
- • Joined server date
- • Total lifetime points and monthly breakdown
- • Recent vouches received (with voucher names)
- • Tier progression bar
User Actions
Admin buttons on the user card:
- • View Vouches: See detailed vouch history
- • Adjust Reputation: Manually add/subtract points (with reason logged)
- • Reset Tier: Force user to specific tier
- • Audit Log: View all admin actions on this user
Tier Progress Visualization
Visual bar showing progress toward next tier. Displays current points and points needed.
Vouch History Log
Complete audit trail of all vouch activity:
History Table Columns
Timestamp: Date and time of vouch
Voucher: User who gave the vouch with their tier
Target: User who received the vouch
Points: Points awarded (with multiplier info)
Reason: Optional note from voucher
Status: Active or Revoked
Actions: View details or revoke
Filtering & Searching
- • Search by username (voucher or target)
- • Filter by date range with date picker
- • Show only active or revoked vouches
- • Sort by timestamp, points, or status
- • Paginated view showing 50 entries per page
Vouch Details Modal
Click a vouch row to expand and see:
- • Full timestamp (to the second)
- • Voucher's tier at time of vouch
- • Calculated point value with weight formula
- • Complete reason/message
- • Revocation status and reason if applicable
- • Revoke/Restore buttons for admins
Bulk Actions
Select multiple vouches with checkboxes. Bulk revoke or restore with green button confirmation.
Export History
Download filtered history as CSV for external analysis or record keeping.
SearchableSelect Dropdowns
User, role, and channel selectors use SearchableSelect:
- •Typeable: Start typing to filter options in real-time
- •Multi-select: For role fields, click items to add/remove
- •Quick Keys: Arrow keys to navigate, Enter to select, Escape to close
- •Clear Button: X icon to remove current selection
Button Styling Convention
Green Buttons (Primary/Save)
Green background with black text. Primary actions: "Save Settings", "Add Tier", "Confirm".
Blue Buttons (Info/View)
Blue buttons for information and navigation: "View Profile", "View Vouches", "View Details".
Red Buttons (Destructive)
Red buttons for deletions and revocations: "Revoke", "Delete", "Reset".
Dashboard Tips & Tricks
Efficiency Shortcuts
- • Ctrl+Shift+R to quickly refresh all data
- • Click tier names to see detailed tier settings
- • Hover over badges to see tier requirements
- • Use date picker for quick date range selection
Monitoring Best Practices
- • Check vouch history log weekly for suspicious patterns
- • Review audit logs for manual reputation adjustments
- • Export monthly leaderboards for records
- • Monitor large points jumps that may indicate issues
Configuration Tips
- • Start with default settings, then customize after a week of data
- • Make tier point requirements incrementally harder to reach
- • Assign unique colors to each tier for easy visual recognition
- • Test vouch settings with a test account before enabling
Troubleshooting
- • If role assignment isn't working, verify bot permissions
- • Clear cache if tier colors don't update
- • Check if leaderboard channel permissions allow bot to post
- • Enable debug mode to see detailed logs