Skip to content

How to?

Jump to bottom
0xYZ edited this page Sep 25, 2025 · 1 revision

Vouch. Bot GitHub Wiki: The Ultimate How-To Guide

Welcome to the official wiki for the Vouch. Discord bot! This guide outlines every valid slash command (/ command) available in the bot, extracted directly from the code base.

⚙️ 1. Setup & Configuration Commands (Admin Only)

These commands require Administrator permissions to use.

/setvouchconfig

The central command for server administrators to configure the bot's core functions.

  • vouch_channel: TextChannel (Required)
    • The channel where all vouches will be posted and visible.
  • modlog_channel: TextChannel (Optional)
    • The channel for moderation logs (e.g., vouch deletions, blacklists).
  • market_channel: TextChannel (Optional)
    • The channel where all marketplace listings (/market post) will be sent.
  • use_role_restriction: Boolean (Optional)
    • Set to True to restrict who can use /vouch.
  • allowed_role: Role (Optional)
    • The role required to submit a vouch (only used if restriction is True).
  • min_account_age_days: Integer (Optional)
    • Minimum account age in days required to submit a vouch.

Example Usage:

/setvouchconfig vouch_channel:#vouches min_account_age_days:7 market_channel:#marketplace

⭐ 2. Vouching & Profile Commands

/vouch

The primary, full-featured command to submit a vouch. This command launches an interactive Modal to collect all details, including a 1-5 star rating.

  • seller: Member (Required)
    • The member you are submitting a vouch for.

Modal Fields Collected by /vouch:

  • Product (Required)
  • Price (Required)
  • Rating (1-5) (Required)
  • Reason (Optional)
  • Proof URL (Optional)

/profile

View a user's full vouch history, total vouches, average rating, and current Seller Rank.

  • user: Member (Optional)
    • The user whose profile you want to view. If left blank, it shows your own profile.

/leaderboard

Displays the server's top sellers based on vouch count and average rating.

/postleaderboard

(Privileged Users Only) Manually forces the daily leaderboard message to be posted or updated in the configured channel immediately.

🛒 3. Marketplace Commands

The /market command group is used for creating and managing listings in the configured market_channel.

/market post

Creates a new listing.

  • listing_type: Choice (sell, buy, trade) (Required)
    • The type of listing you are creating.
  • item_name: String (Required)
    • A short, descriptive name for the listing.
  • description: String (Required)
    • Full details of your offering or request.
  • price_or_value: String (Required)
    • The price, value, or exchange items.
  • proof_url: String (Optional)
    • A link to an image or document as proof.

Other /market Subcommands

  • /market view
    • Permission Check: None
    • Description: View all your active listings.
  • /market edit
    • Permission Check: None (Requires Listing ID)
    • Description: Edit an existing listing using its ID.
  • /market delete
    • Permission Check: None (Requires Listing ID)
    • Description: Delete a listing using its ID.
  • /market clear
    • Permission Check: Administrator
    • Description: Removes all marketplace listings for the current server.

🛡️ 4. Moderation & Blacklisting

Commands for server-specific moderation and bot-wide management.

Server Moderation (Admin/Privileged)

  • /blacklist
    • Action: add / remove
    • Description: Blacklist or unblacklist a user from using the vouch system on this server only.
  • /deletevouch
    • Action: vouch_id (Integer)
    • Description: Permanently delete a specific vouch by its ID number.
  • /editvouch
    • Action: vouch_id (Integer) + Optional Parameters
    • Description: Edit details (product, price, rating, reason, proof_url) of an existing vouch by its ID.

Global Bot Management (Developer/Owner Only)

These commands affect the bot across all servers and are reserved for the bot developers.

  • /gblacklist
    • Action: add / remove
    • Description: Globally blacklist a user from using the bot's vouch system across all servers.
  • /serverblacklist
    • Action: add / remove
    • Description: Globally blacklist a server (by ID) from hosting the bot.
  • /trusteduser
    • Action: add / remove
    • Description: Add or remove a user from the Global Trusted Users list.
  • /botban
    • Action: add / remove
    • Description: Bot-ban a user from using the bot, with an optional reason.
  • /checkreports
    • Action: N/A
    • Description: View the list of global user reports.

User Reporting

  • /report
    • Description: Report a user globally for suspicious activity. Includes fields for user, reason, proof_url (Optional), and anon (Optional).

📊 5. Seller Ranks

Vouch. automatically assigns ranks based on the total number of verified vouches a user has received.

  • 500+ Vouches: Mythic Seller
  • 200+ Vouches: GOD Seller
  • 150+ Vouches: Ultimate Seller
  • 100+ Vouches: Elite Seller
  • 50+ Vouches: Pro Seller
  • 25+ Vouches: Experienced Seller
  • 10+ Vouches: Regular Seller
  • 1+ Vouches: New Seller
  • N/A: Unranked

go to How-To? for informations

Clone this wiki locally