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.
- 📝 Easy Vouching: Simple
/vouchcommand with support for products, ratings, notes, and proof images. - 📊 Real-time Stats: Track server-wide performance with the
/statscommand. - 👤 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
.envfiles. Everything is managed in a singleconfig.js.
- Node.js (v16.11.0 or higher)
- A Discord Bot Token (Get one at Discord Developer Portal)
-
Clone the repository:
git clone https://github.com/veya-bot/discord-vouchbot.git cd discord-vouchbot -
Install dependencies:
npm install
-
Configure the bot: Open
config.jsand fill in your credentials:TOKEN: "YOUR_BOT_TOKEN", CLIENT_ID: "YOUR_APPLICATION_ID", VOUCH_CHANNEL_ID: "YOUR_TARGET_CHANNEL_ID"
-
Start the bot:
npm start
| 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 |
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, orCompeting.STATE:online,idle,dnd, orinvisible.
Distributed under the MIT License. See LICENSE for more information.