‼️REBUILD PHASE‼️

🚀 Hopeless - A Discord Music Bot

Hopeless Bot is a discord bot, specially made for Music Streaming. It is built along with discord.js, a powerful Node.js module that allows you to easily interact with the Discord API, and Lavalink, a powerful audio streaming server.

✉️ Invite Hopeless • 🆘 Support Server • 📝 Bug & Request Feature

📊 Road Map

• Basic Bot
• Music Bot
• Information Bot
• Website
• Dashboard
• Documentation

💡 Features

• Advanced Logger
• Music Streaming
• Highly Customizable
• Multi-Language Support
• Advanced Error Handler
• Basic Sharding
• Advanced Validation

🔧 Requirements

Before you get started, you need to have the following:

• (Recommend LTS or Higher)
• (V4 or Higher)
• (Required for MongoDB database)

🚀 Get Started

1. Install pnpm if you don’t have it installed

npm install -g pnpm

1. First clone the repository:

git clone https://github.com/rafisarkar0128/hopeless-bot.git

1. Change to the directory:

cd hopeless-bot

1. Install the required packages:

pnpm install # you can also use npm if you want

1. Copy example.lavalink-nodes.js to lavalink-nodes.js and add your external nodes here if you are going to use any.

2. Copy .env.example to .env and fill in all the required values.

3. Now go to Discord Developer Page select your application and head to OAuth2 tab. In OAuth2 URL Generator select “bot” and “application.commands” scopes, scroll down select “Administrator” permission, copy the URL, open the URL and invite the bot to your server.

4. Start the bot:

# You can also use npm if you want
pnpm start
pnpm run dev # if you want to run in dev mode

1. Start using the bot. Use /ping or /botinfo commands.

NOTE

By default, the bot doesn’t load slash commands globally. To load slash commands globally, go to .env, change the value of GLOBAL_COMMANDS to true. This will make sure that the slash commands are available globally.

🗝️ Sharding

Sharding is not recommended for bots that are in less than 2,000 servers. By default the bot runs without sharding. To enable sharding, start the bot like this:

pnpm run shard
pnpm run devShard # if you want to run in dev mode

📜 Commands

There will be a dedicated markdown file for commands in future. For now here are some public commands of the bot.

Name	Description
ping	🏓 Pong! Replies with bot’s response time.
botinfo	📖 View bot’s information.
invite	returns a link button with bot’s invite URL.
language	🌐 Change your language for the bot.
play	▶ Play songs or tracks from available sources.

🤝 Contributing

Please check the issues page for open issues and feature requests.

Thank you for your interest in contributing to this project! Remember to follow these guidelines when contributing:

1. Fork the repository and create a new branch for your feature or bug fix.
2. Write clean and concise code that follows the established coding style.
3. Create detailed and thorough documentation for any new features or changes.
4. Write and run tests for your code.
5. Submit a pull request with your changes. Your contribution will be reviewed, and any necessary feedback or changes will be discussed with you.

💖 I appreciate your help in making this project better!

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.

👥 Contributors

Thanks go to these wonderful people for their contributions: