Testify

<!-- ████████╗███████╗███████╗████████╗██╗███████╗██╗ ██╗ ╚══██╔══╝██╔════╝██╔════╝╚══██╔══╝██║██╔════╝╚██╗ ██╔╝ ██║ █████╗ ███████╗ ██║ ██║█████╗ ╚████╔╝ ██║ ██╔══╝ ╚════██║ ██║ ██║██╔══╝ ╚██╔╝ ██║ ███████╗███████║ ██║ ██║██║ ██║ ╚═╝ ╚══════╝╚══════╝ ╚═╝ ╚═╝╚═╝ ╚═╝ --> <img align="center" alt="Nub Bot banner" src="https://i.postimg.cc/v87R8PSx/test.png"> <p align="center"> <img align="center" alt="GitHub Issues" src="https://img.shields.io/github/issues/Kkkermit/Testify?style=for-the-badge"> <img align="center" alt="GitHub license" src="https://img.shields.io/github/license/Kkkermit/Testify?style=for-the-badge"> <img align="center" alt="GitHub Stars" src="https://img.shields.io/github/stars/Kkkermit/Testify?style=for-the-badge"> <img align="center" alt="GitHub Forks" src="https://img.shields.io/github/forks/Kkkermit/Testify?style=for-the-badge"> <img align="center" alt="GitHub Contributors" src="https://img.shields.io/github/contributors/Kkkermit/Testify.svg?style=for-the-badge"> </p> <p align="center"> <img align="center" alt="GitHub Watchers" src="https://img.shields.io/github/watchers/Kkkermit/Testify?style=for-the-badge"> <img align="center" alt="GitHub Workflow" src="https://img.shields.io/github/actions/workflow/status/Kkkermit/Testify/run-tests.yml?style=for-the-badge"> <img align="center" alt="GitHub Commits-Since" src="https://img.shields.io/github/commits-since/Kkkermit/Testify/latest?style=for-the-badge"> <img align="center" alt="GitHub Version" src="https://img.shields.io/github/package-json/v/Kkkermit/Testify?style=for-the-badge"> </p> <p align="center"> <a href="https://buymeacoffee.com/kkermit" target="_blank"> <img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" height="60px" width="217px"> </a> </p> <p align="center"><strong> Advanced all-in-one discord bot with prefix & slash commands </strong></p> <p align="center"> With over 100 slash commands and over 50 prefix commands, Testify is an open source discord bot that's easy to set up and use and full of fun features for your servers! </p>

To test out Testify, be sure to invite him to your server by clicking here

[!CAUTION] Never share or commit your .env file or any of its values! These contain sensitive information including your bot token, MongoDB credentials, and API keys that could be used to compromise your systems or incur unwanted charges if leaked. Always add .env to your .gitignore file.

Table of Contents

• Features
• Compatibility
• Installation
• Usage
• Command Categories
• Setting-Audit-Logs
• Technical Features
• Contributors
• Support
• License

<h1 align="center"><strong> ⭐ If you're a fan of this repository or have used it or any of its code, please consider leaving us a star. It would be greatly appreciated and allows us to see if users value the bot! ⭐ </strong></h1>

Features

Moderation Tools

• Complete Moderation Suite: Ban, kick, timeout, warn, and mute functionality
• Auto-moderation: Filter profanity, spam, and inappropriate content
• Audit Logging: Comprehensive logging of all moderation actions
• Ticket System: Create and manage support tickets with transcripts

Entertainment & Fun

• Music System: Play music from YouTube, Spotify, and SoundCloud with queue management
• Leveling System: XP and ranking system with customizable rewards
• Mini-games: Variety of games including RPS, coinflip, 8ball, and more
• Meme Commands: Random memes, jokes, and fun interactions

Information & Utility

• User Info: Detailed user information with profile cards
• Server Info: Server statistics and information
• Role Info: Detailed role information including permissions
• Profile System: Create and customize user profiles

Integration & API Features

• Valorant Integration: View skins, store, and player info
• Instagram Notifications: Get notified of new posts from Instagram accounts
• Spotify Integration: Advanced Spotify tracking and integration
• Weather Information: Get weather forecasts for any location

Customization

• Custom Prefix: Set a custom prefix for your server
• Custom Embeds: Create and customize rich embeds
• Announcement System: Create professional announcements
• Thread Management: Create and manage threads

Compatibility

System Requirements

| Operating System | Support Status | Notes | |------------------|---------------|-------| | Windows 11 | ✅ Full Support | Recommended for development | | Windows 10 | ✅ Full Support | Recommended for development | | macOS | ✅ Full Support | Tested on macOS Ventura+ | | Linux (Ubuntu) | ✅ Full Support | Tested on Ubuntu 20.04 LTS+ | | Linux (Debian) | ✅ Full Support | Tested on Debian 11+ | | Linux (CentOS) | ✅ Full Support | Tested on CentOS 8+ | | Linux (Fedora) | ✅ Full Support | Tested on Fedora 34+ |

Node.js Support

| Node.js Version | Support Status | Notes | |-----------------|---------------|-------| | v18.13.0+ | ✅ Supported | Minimum required version | | v19.x | ✅ Supported | | | v20.x | ✅ Supported | Recommended for best performance | | v21.x | ✅ Supported | Latest features |

[!IMPORTANT] If you're struggling to use a certain node version, I'd suggest either downgrading or upgrading your version using nvm To install nvm, please follow this link.

Installation

• Download Node.js.
• Download Visual Studio Code.

Usage

• Project Setup

  1. Fork the Github project :

     1. Sign up / Sign in to GitHub.
     2. Navigate to Testify.
     3. Click Star to support development.
     4. Click Fork to copy all code to your own repository.

  2. Click the Code button. From the drop-down that appears, click Download ZIP to download the entire repository as a ZIP folder.

  3. Extract the files to a new folder and open it with Visual Studio Code.

• Obtain Discord Bot Token

  1. Sign in to Discord Developer Portal.

  2. Create a bot :

     1. Enter the left side Applications.
     2. Click New Application in the upper right corner and enter the name of the bot. After confirmation, enter the new page.
     3. Click on the left side Bot.
     4. Enable all intents listed under Privileged Gateway Intents and click Save Changes.
     5. View and copy the token by clicking the Reset Token button.

  3. Set up OAuth2 :

     1. Click on OAuth2 in the left column.
     2. Click on URL Generator in the left column.
     3. In the right column, select bot and applications.commands under SCOPES.
     4. Scroll down and select Administrator under BOT PERMISSIONS.
     5. Copy the URL at the bottom and paste it into your browser.
     6. Choose the server you want to add the bot to and click Continue > Authorize.

• Obtain MongoDB Connection String

  1. Sign up / Sign in to MongoDB.
  2. Choose your preferred cloud database plan.
  3. Customize the cluster settings to your preference and click Create Cluster.
  4. Navigate to the Network Access page, click Add IP Address and select Allow access from anywhere.
  5. Navigate back to the Database page and click Connect.
  6. Create a database user, click Choose a connection method and select Connect your application.
  7. Copy your connection string and replace <password> with the password for the database user that you created earlier.

• Setting up the env file

  If you go along with this, you can ignore the parts in the Project Execution that explain how to generate and fill in the .env

  1. For easy setup of the env files, ( .env & .development.env ) you can run the command npm run setup-env:prod
  2. Once you've ran the command, it generates a script in the console
  3. You need to then fill out the fields in the console. Fields marked with the text "Required" are you required fields and you need to fill those ones in. The script will not continue if you ignore to fill in those fields.
  4. Once you've filled in the field, it will write those fields into and generate the .env.
  5. Alternatively, you can ignore this and fill in the fields yourself by viewing the .example.env file.
  6. If you then want to setup the .env.development file, you can run the command npm run setup-env:dev and follow the steps above again.

• Project Execution

  1. Rename the filed named example.env to .env
  2. Navigate to the Bot page on the Discord Developer Portal and click Reset Token. Afterwards, create a .env file within the root directory.
  3. Paste your bot token into the token variable inside the .env file.
  4. Paste your MongoDB connection string into the mongodb variable inside the .env file.
  5. Navigate to the OAuth2 page and copy the CLIENT ID.
  6. Paste your client ID into the clientid variable inside the .env file.
  7. Navigate to your discord server, enable developer mode and right click the dropdown beside