Skip to content
/ Urvo Public

πŸ€– A multi-purpose Discord bot built using discord.js | Over 65 Commands across 8 categories πŸ”₯

License

Notifications You must be signed in to change notification settings

vikiru/Urvo

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Urvo

MIT License Badge Documentation Static Badge Release Closed Issues Closed PRs


Urvo Demo GIF

Urvo is a versatile Discord bot that offers over 65 commands across 8 categories to enhance your Discord experience!

  • πŸ“· Images: Enhance your mood with a random image of an animal from the available options or an image of coffee to boost your energy!
  • ❓ Information: Whether you’re a fan of anime or manga, Digimon or Disney, or just curious about a term, you’ll find everything you need here!
  • πŸ˜‚ Memes: Generate memes to enjoy with your friends, using easy prompts!
  • πŸ•ΉοΈ Minigames: The cure for boredom. Beat the bot and have a blast!
  • πŸ›‘οΈ Moderation: Use these commands to manage the server effectively and efficiently!
  • 🎲 Random: An assortment of commands that provide you with random pieces of information such as motivating you with a quote or making you laugh with a joke!
  • βš”οΈ Troopica: Rise to the top of your server by amassing wealth and troops!
  • πŸ› οΈ Utility: Additional commands that can prove useful to yourself or the server!

A comprehensive overview detailing all available commands can be located within the documentation under the Category Overview section. Each command has a dedicated page detailing its usage, including optional parameters, cooldowns (if any), required user permissions, any associated external APIs, and finally, a demonstration of the command is also provided for clarity.

πŸ“– Table of Contents

πŸ“ Prerequisites

Ensure that the following dependencies are installed onto your machine by following the Setup Instructions.

⚑ Setup Instructions

  1. Clone this repository to your local machine.
git clone https://github.com/vikiru/Urvo.git
cd Urvo
  1. Download & install all dependencies.
pnpm install
  1. Setup your .env file with the required values.
TOKEN=your-token-goes-here
CLIENT_ID=your-client-id-here
DB_USER=your-user-here
DB_PASS=your-pass-here

TOKEN: This is the token for your Discord bot, retrievable upon the creation of a new application via the Discord Developer Portal.

CLIENT_ID: This is the ID associated with your Discord bot, also accessible via the Discord Developer Portal post-application creation.

DB_USER: This is the username utilized when connecting to the SQLite Database for all 'Troopica' commands. This can be customized as per your preference.

DB_PASS: This is the password used when connecting to the SQLite Database for all 'Troopica' commands. This can be set to any secure string.

  1. Deploy all commands, binding them to the Discord Bot application you've created previously.
pnpm run deploy
  1. Ensure functionality of 'Troopica' commands by initializing the SQLite database.
pnpm init-db

Upon completion of these steps, the Discord bot can be added to servers and all commands will be operational πŸŽ‰

πŸ“œ Available Scripts

Start the Discord bot.

pnpm start

Deploy Discord bot commands.

pnpm deploy

Initialize SQLite database for Troopica commands.

pnpm init-db

Run tests using Mocha.

pnpm test

Lint files using Biome.

pnpm lint

Format files using Biome.

pnpm format

Run TypeScript type checks without emitting files.

pnpm typecheck

Check unused dependencies and files with Knip.

pnpm unused

Prepare Git hooks via Lefthook.

pnpm postinstall

πŸ” Testing

The comprehensive suite of tests for this project is housed within the test directory. These tests are primarily designed to verify the functionality and reliability of the external APIs.

The tests can be run with the following command:

pnpm test

✨ Acknowledgments

Additionally, the majority of the commands provided by this bot would not be possible without all of the various APIs that are being used, see API Reference.

©️ License

The contents of this repository are licensed under the terms and conditions of the MIT license.

MIT Β© 2021-present Visakan Kirubakaran.

About

πŸ€– A multi-purpose Discord bot built using discord.js | Over 65 Commands across 8 categories πŸ”₯

Resources

License

Stars

Watchers

Forks

Contributors 4

  •  
  •  
  •  
  •