Reputation

Vouching System

Understand how vouching works, vouch weight mechanics, cooldowns, requirements, and the vouch history audit trail.

How Vouching Works

Vouching is the primary way members earn reputation in your server:

The Vouch Command

/vouch @user [reason]

Members run this command to vouch for someone. The optional reason is recorded in the audit trail.

Step-by-Step Process

  1. 1. Command Execution:User types /vouch @target
  2. 2. Requirement Check:System verifies voucher meets all requirements
  3. 3. Eligibility Verify:Checks cooldown, self-vouch prevention, minimum age
  4. 4. Weight Calculation:Calculates vouch weight based on voucher's reputation
  5. 5. Points Addition:Adds calculated points to target's reputation
  6. 6. Log Recording:Records vouch in audit trail with timestamp
  7. 7. Notifications:Sends confirmation to both users via DM or message

Success & Error Messages

Success:

✓ You vouched for @User (Tier: Trusted, +3 reputation)

Error Examples:

✗ You can only vouch once per 24 hours for this user

✗ Your account must be 7 days old to vouch

✗ You cannot vouch for yourself

Vouch Weight (Based on Voucher Reputation)

The reputation of the person giving the vouch affects how many points the target receives:

Weight Calculation

Vouch weight is calculated dynamically based on the voucher's current reputation tier:

Vouch Weight = (Voucher Reputation / Average Server Reputation) × 1.0

This formula ensures high-reputation members have more impact while still allowing newcomers to contribute.

Weight by Tier Examples

Newcomer(0-10 reputation) • Weight: 0.5x • 1 vouch = 0.5 points
Member(10-50 reputation) • Weight: 1.0x • 1 vouch = 1.0 points
Trusted(50-150 reputation) • Weight: 1.5x • 1 vouch = 1.5 points
Veteran(150-500 reputation) • Weight: 2.0x • 1 vouch = 2.0 points
Legend(500+ reputation) • Weight: 3.0x • 1 vouch = 3.0 points

Weight Advantages

  • • Rewards established members for their endorsements
  • • Encourages quality vouching from trusted community figures
  • • Still allows new members to help others gain reputation
  • • Creates hierarchy of trust within the system

Vouch Cooldowns

Cooldowns prevent spamming and ensure fair distribution of vouches:

Cooldown Types

Per-User Cooldown:Can only vouch for the same person once per 24 hours (configurable)
Global Cooldown:Maximum vouches a user can give per day (default: 10, configurable)
Receive Cooldown:Maximum vouches a user can receive per day (prevents vouch farming)

Example Scenario

If per-user cooldown is 24 hours and global is 10 per day:

  • • User A can vouch for User B only once in 24 hours
  • • User A can give a maximum of 10 vouches in one day to anyone
  • • After 24 hours, the vouch cooldown for User B resets
  • • Next day, User A gets 10 more vouches to distribute

Checking Cooldown Status

Run /vouch status to see remaining vouches today and cooldown times.

Maximum Vouches Per Day

Each member has a daily vouch allowance that resets at midnight server time:

  • •Default: 10 vouches per day per member
  • •Configurable: Admins can adjust per-tier in settings
  • •Tier Scaling: Higher reputation tiers get more vouches
  • •Reset Time: Set in dashboard to match your server's timezone

Revoking Vouches

Vouches can be removed if issued in error or discovered to be fraudulent:

How to Revoke

/vouch revoke @user [vouch-id]

Users can revoke their own vouches. Find vouch ID in your vouch history.

Revocation Effects

  • • Points are immediately subtracted from target's reputation
  • • Vouch is marked as "revoked" in audit trail
  • • Both users are notified of the revocation
  • • Target might drop tier if reputation falls below threshold

Admin Revocation

Admins can revoke any vouch from the dashboard with a reason logged in the audit trail.

Vouch Requirements

Members must meet specific criteria before they can vouch for others:

Configurable Requirements

Minimum Level:User must reach a certain level in the server (e.g., level 5)
Minimum Reputation:User must have earned at least X reputation themselves (e.g., 10 points)
Account Age:Discord account must be at least N days old (e.g., 7 days)
Server Member Duration:Must have been in the server for N days (e.g., 3 days)
Required Roles:Must have specific roles to vouch (optional)

Default Requirements

Default is relatively permissive to encourage participation. Servers can tighten requirements to ensure only established members vouch.

Unmet Requirements

If a user tries to vouch without meeting requirements, they receive a clear error message explaining what they need. This prevents confusion and guides them toward becoming eligible.

Vouch History and Audit Trail

Complete transparency through comprehensive vouch records:

Personal Vouch History

View your own vouches with: /vouch history

Shows vouches you gave and received with dates, voucher reputation level, and point values.

User Profile Vouches

Check someone's vouch history: /reputation profile @user

Shows recent vouches received, total count, and average vouch weight.

Audit Trail Data

  • • Exact timestamp of each vouch (to the second)
  • • Identity of both voucher and target
  • • Reputation tier of voucher at time of vouch
  • • Point value assigned
  • • Optional reason or note
  • • Vouch status (active, revoked, disputed)

Admin Audit Access

Admins can access full audit trail from the dashboard for any user, including deleted vouches and admin actions. Searchable and filterable.

Historical Integrity

Audit trail is immutable - vouches cannot be edited, only marked as revoked. Creates permanent record of reputation history.

Reputation Milestones and Rewards

Celebrate major reputation achievements:

Milestone System

First VouchWhen someone receives their first vouch
10 VouchesReaches 10 total vouches received
50 VouchesMajor milestone with special badge
100 VouchesCommunity Legend status achieved

Tier Advancement Rewards

  • • Automatic role assignment when tier reached
  • • Badge display in profiles and leaderboard
  • • Server announcement (optional)
  • • Access to tier-locked channels
  • • Increased vouch allowance per day

Custom Rewards

Servers can configure custom rewards for milestones like special role colors, mentions in announcements, or exclusive channel access.

Best Practices for Vouching

Thoughtful Vouching

  • • Only vouch for users you genuinely know and trust
  • • Use the reason field to explain why you're vouching
  • • Don't vouch just to be nice or reciprocate
  • • Quality matters more than quantity

Managing Your Daily Allowance

  • • Don't waste all vouches on one person
  • • Distribute vouches throughout the day/week
  • • Use the per-24h limit strategically
  • • Save vouches for when you encounter truly trustworthy members

What Makes a Good Vouch Reason

  • • "Always helpful in support channels"
  • • "Trustworthy and fair in community trades"
  • • "Great community contributor and team player"
  • • "Knowledgeable and always positive"

Avoiding Red Flags

  • • Don't vouch for friends just to help them gain reputation
  • • Don't accept vouches from users you don't know well
  • • Report suspicious patterns to admins
  • • Revoke vouches if the user's behavior changes