Documentation

Welcome to the complete documentation for Vouch., the industry-standard reputation bot for Discord communities. This guide covers everything from initial server setup to advanced marketplace automation.

Vouch is designed to solve the "trust problem" in digital transactions. By creating a transparent, auditable history of transactions linked to Discord User IDs, communities can filter out scammers and highlight legitimate traders.

Quick Start

Get up and running in less than 2 minutes.

1. Invite the Bot: Click the "Add to Discord" button.
2. Create Channels: Create a text channel for your vouches (e.g., #vouches) and optionally one for logs (e.g., #logs).
3. Run Setup: Use /setvouchconfig to link these channels.
4. Done: Users can now use /vouch to start building reputation.

Server Configuration

The /setvouchconfig command is the control center for your server settings. It must be run by an Administrator.

Role Restrictions & Anti-Alt

You can lock the vouching system to specific users to prevent spam or abuse.

• Role Restriction: Enable use_role_restriction: True in the config to force users to have the role specified in allowed_role.
• Anti-Alt System: If a user's account is younger than min_account_age_days, the bot will reject their vouch attempt and inform them privately.

The Reputation System

The core function of the bot. Vouches are permanent records of successful transactions.

Logic & Validation

The system enforces several rules to maintain integrity:

• No Self-Vouching: Users cannot vouch for themselves.
• Blacklist Check: Both the voucher and the seller are checked against Global and Server blacklists.
• Duplicate Protection: Prevents rapid-fire spamming of vouches.

Seller Ranks

Sellers automatically achieve ranks based on their total number of unique vouches. These ranks appear on their /profile.

Seller Profiles

Every user has a public profile generated by /profile @user. This card displays their trust stats, recent history, and custom settings.

Marketplace Automation

Vouch. transforms Discord channels into structured marketplaces. Instead of free-text spam, users fill out forms (Modals) to create standardized listings.

Creating Listings

• /sell: Opens a form asking for Product Name, Price, Payment Methods, and Description.
• /buy: Creates a "Looking to Buy" card with Budget and Item Name.
• /trade: Creates a structured trade offer (Item A for Item B).

Private Trade Threads

When a listing is posted, it includes a "Contact" button. When another user clicks this button:

1. The bot creates a Private Thread attached to the listing.
2. Only the Seller, the Buyer, and Server Moderators can see this thread.
3. This ensures negotiations are private but still moderate-able if a scam occurs.

Safety & Moderation

Reporting Scammers

If a user is scammed, they should run /reportscammer. This opens a form requiring:

• The User being reported.
• Reason for the report.
• Proof (Screenshot URL).

The Review Process:

1. The report is sent to the Modlog Channel and the global FZ Enterprise team.
2. A card appears with [Approve] and [Decline] buttons.
3. If Approved: The user is flagged in the global database. They may be blacklisted from using the bot across all servers.
4. If Declined: The case is closed.

Suspicious Activity Detection

The bot automatically monitors for "Vouch Farming." If User A leaves 3 or more 5-star vouches for User B in a short period:

• An alert is sent to your modlog_channel.
• The alert includes a button to quickly blacklist or report the user involved.

Managing Blacklists

Admins can prevent specific users from interacting with the bot in their server.

To view your server's blacklist, run the command with action:list.

Troubleshooting / FAQ