Skip to content

veya-bot/discord-vouchbot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🚀 VouchBot

Discord Node.js License: MIT

A powerful, lightweight Discord bot with a secure persistent database, designed for marketplaces to manage and display customer vouches with zero data loss. Built with Discord.js v14.


✨ Features

  • 📝 Easy Vouching: Simple /vouch command with support for products, ratings, notes, and proof images.
  • 📊 Real-time Stats: Track server-wide performance with the /stats command.
  • 👤 User Profiles: View a detailed vouch history for any seller using /profile.
  • 🏆 Leaderboards: Competitive seller rankings based on vouch counts with /leaderboard.
  • 📌 Sticky Messages: Keep the vouch prompt visible in your vouch channel automatically.
  • 📁 Local Data Storage: Uses a lightweight JSON database – no complex database setup required.
  • ⚙️ Direct Configuration: No .env files. Everything is managed in a single config.js.

🚀 Quick Start

Prerequisites

Installation

  1. Clone the repository:

    git clone https://github.com/veya-bot/discord-vouchbot.git
    cd discord-vouchbot
  2. Install dependencies:

    npm install
  3. Configure the bot: Open config.js and fill in your credentials:

    TOKEN: "YOUR_BOT_TOKEN",
    CLIENT_ID: "YOUR_APPLICATION_ID",
    VOUCH_CHANNEL_ID: "YOUR_TARGET_CHANNEL_ID"
  4. Start the bot:

    npm start

🛠️ Commands

Command Description Permissions
/vouch Submit a new vouch for a seller Everyone
/stats View server-wide vouch statistics Everyone
/profile View a user's vouch history and rating Everyone
/leaderboard View the top 10 sellers Everyone
/sticky Enable/Disable the sticky message Manage Server
/restore Restore vouches from vouches.json Bot Admin

🔧 Configuration Details

The config.js file allows you to customize the bot's behavior and appearance:

  • ADMIN_IDS: Add user IDs to this array for administrative control.
  • BOT_STATUS:
    • TEXT: The text shown in the bot's status.
    • TYPE: Watching, Playing, Listening, or Competing.
    • STATE: online, idle, dnd, or invisible.

📝 License

Distributed under the MIT License. See LICENSE for more information.

About

A powerful, lightweight Discord bot with a secure persistent database, designed for marketplaces to manage and display customer vouches with zero data loss.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors