{"id":14983248,"url":"https://github.com/rafisarkar0128/hopeless-bot","last_synced_at":"2025-10-29T21:30:40.965Z","repository":{"id":251569314,"uuid":"837797232","full_name":"theassassin0128/hopeless-bot","owner":"theassassin0128","description":"A discord bot for your every need.","archived":false,"fork":false,"pushed_at":"2024-12-30T01:41:58.000Z","size":75964,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-02T04:51:16.326Z","etag":null,"topics":["bot","discord","discord-bot","discordjs","javascript"],"latest_commit_sha":null,"homepage":"https://theassassin0128.github.io/hopeless-bot/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/theassassin0128.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-08-04T04:12:25.000Z","updated_at":"2024-12-30T01:42:02.000Z","dependencies_parsed_at":"2024-08-24T03:30:17.021Z","dependency_job_id":"7b81468d-fc6b-4d34-a34c-9a908309096f","html_url":"https://github.com/theassassin0128/hopeless-bot","commit_stats":{"total_commits":69,"total_committers":1,"mean_commits":69.0,"dds":0.0,"last_synced_commit":"ded0c347ab1b4a72d56c272fc5a9d98adc42c33f"},"previous_names":["theassassin0128/hopeless-bot"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theassassin0128%2Fhopeless-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theassassin0128%2Fhopeless-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theassassin0128%2Fhopeless-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theassassin0128%2Fhopeless-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/theassassin0128","download_url":"https://codeload.github.com/theassassin0128/hopeless-bot/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238892289,"owners_count":19548166,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bot","discord","discord-bot","discordjs","javascript"],"created_at":"2024-09-24T14:06:57.656Z","updated_at":"2025-10-29T21:30:40.959Z","avatar_url":"https://github.com/theassassin0128.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ‼️REBUILD PHASE‼️\n\n[![Version][version-shield]][version-shield-link]\n[![Contributors][contributors-shield]][contributors-url]\n[![Forks][forks-shield]][forks-url]\n[![Stargazers][stars-shield]][stars-url]\n[![Issues][issues-shield]][issues-url]\n[![Support Server][support-shield]][support-server]\n[![MIT License][license-shield]][license-url]\n[![CodeQL][codeql]][codeql-url]\n[![Dependency Review][dependency-review]][dependency-review-url]\n[![CodeFactor][code-factor]][code-factor-url]\n\n## 🚀 Hopeless - A Discord Music Bot\n\n**Hopeless Bot** is a discord bot, specially made for **Music Streaming**. It is built along with [discord.js](https://github.com/discordjs/discord.js), a powerful [Node.js](https://nodejs.org) module that allows you to easily interact with the [Discord API](https://discord.com/developers/docs/intro), and [Lavalink](https://github.com/lavalink-devs/lavalink), a powerful audio streaming server.\n\n[✉️ Invite Hopeless][bot-invite] • [🆘 Support Server][support-server] • [📝 Bug \u0026 Request Feature][issues-url]\n\n## 📊 Road Map\n\n- [x] **Basic Bot**\n- [x] **Music Bot**\n- [x] **Information Bot**\n- [x] **Website**\n- [ ] **Dashboard**\n- [ ] **Documentation**\n\n## 💡 Features\n\n- **Advanced Logger**\n- **Music Streaming**\n- **Highly Customizable**\n- **Multi-Language Support**\n- **Advanced Error Handler**\n- **Basic Sharding**\n- **Advanced Validation**\n\n## 🔧 Requirements\n\nBefore you get started, you need to have the following:\n\n- [![Node.JS](https://img.shields.io/badge/Node.js-43853D?style=for-the-badge\u0026logo=node.js\u0026logoColor=white)](https://nodejs.org/en/download/) (Recommend LTS or Higher)\n- [![Lavalink](https://img.shields.io/badge/Lavalink-7289DA?style=for-the-badge\u0026logo=discord\u0026logoColor=white)](https://github.com/lavalink-devs/lavalink) (V4 or Higher)\n- [![MongoDB](https://img.shields.io/badge/MongoDB-47A248?style=for-the-badge\u0026logo=mongodb\u0026logoColor=white)](https://www.mongodb.com/try/download/community) (Required for MongoDB database)\n\n## 🚀 Get Started\n\n0. Install `pnpm` if you don't have it installed\n\n```bash\nnpm install -g pnpm\n```\n\n1. First clone the repository:\n\n```bash\ngit clone https://github.com/rafisarkar0128/hopeless-bot.git\n```\n\n2. Change to the directory:\n\n```bash\ncd hopeless-bot\n```\n\n3. Install the required packages:\n\n```bash\npnpm install # you can also use npm if you want\n```\n\n4. Copy `example.lavalink-nodes.js` to `lavalink-nodes.js` and add your external nodes here if you are going to use any.\n\n5. Copy `.env.example` to `.env` and fill in all the required values.\n\n6. Now go to [Discord Developer Page](https://discord.com/developers/applications) 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.\n\n7. Start the bot:\n\n```bash\n# You can also use npm if you want\npnpm start\npnpm run dev # if you want to run in dev mode\n```\n\n8. Start using the bot. Use `/ping` or `/botinfo` commands.\n\n### NOTE\n\nBy default, the bot loads slash commands globally. To load slash commands only in specified guild, go to `.env`, change the value of `GLOBAL_COMMANDS` to `false`. This will make sure that the slash commands are available only in the specified guild.\n\n## 🗝️ Sharding\n\n**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:\n\n```bash\npnpm run shard\npnpm run devShard # if you want to run in dev mode\n```\n\n## 📜 Commands\n\n\u003e There will be a dedicated markdown file for commands in future.\n\u003e For now here are some public commands of the bot.\n\n| Name     | Description                                     |\n| -------- | ----------------------------------------------- |\n| ping     | 🏓 Pong! Replies with bot's response time.      |\n| botinfo  | 📖 View bot's information.                      |\n| invite   | returns a link button with bot's invite URL.    |\n| language | 🌐 Change your language for the bot.            |\n| play     | ▶ Play songs or tracks from available sources. |\n\n## 🤝 Contributing\n\nPlease check the [issues page](https://github.com/rafisarkar0128/hopeless-bot/issues) for open issues and feature requests.\n\nThank you for your interest in contributing to this project! Remember to follow these guidelines when contributing:\n\n1. Fork the repository and create a new branch for your feature or bug fix.\n2. Write clean and concise code that follows the established coding style.\n3. Create detailed and thorough documentation for any new features or changes.\n4. Write and run tests for your code.\n5. Submit a pull request with your changes. Your contribution will be reviewed, and any necessary feedback or changes will be discussed with you.\n\n💖 I appreciate your help in making this project better!\n\n## 📄 License\n\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.\n\n## 👥 Contributors\n\nThanks go to these wonderful people for their contributions:\n\n\u003ca href=\"https://github.com/rafisarkar0128/hopeless-bot/graphs/contributors\"\u003e\n\u003cimg src=\"https://contrib.rocks/image?repo=rafisarkar0128/hopeless-bot\" /\u003e\n\u003c/a\u003e\n\n[bot-invite]: https://discord.com/oauth2/authorize?client_id=1272259032098275358\n[version-shield]: https://img.shields.io/github/package-json/v/rafisarkar0128/hopeless-bot?style=for-the-badge\n[version-shield-link]: https://github.com/rafisarkar0128/hopeless-bot\n[contributors-shield]: https://img.shields.io/github/contributors/rafisarkar0128/hopeless-bot?style=for-the-badge\n[contributors-url]: https://github.com/rafisarkar0128/hopeless-bot/graphs/contributors\n[forks-shield]: https://img.shields.io/github/forks/rafisarkar0128/hopeless-bot?style=for-the-badge\n[forks-url]: https://github.com/rafisarkar0128/hopeless-bot/network/members\n[stars-shield]: https://img.shields.io/github/stars/rafisarkar0128/hopeless-bot?style=for-the-badge\n[stars-url]: https://github.com/rafisarkar0128/hopeless-bot/stargazers\n[issues-shield]: https://img.shields.io/github/issues/rafisarkar0128/hopeless-bot?style=for-the-badge\n[issues-url]: https://github.com/rafisarkar0128/hopeless-bot/issues\n[support-shield]: https://img.shields.io/discord/1054284394791178291?logo=discord\u0026colorB=7289DA\u0026style=for-the-badge\n[support-server]: https://discord.gg/E6H9VvBdTk\n[license-shield]: https://img.shields.io/github/license/rafisarkar0128/hopeless-bot?style=for-the-badge\n[license-url]: https://github.com/rafisarkar0128/hopeless-bot/blob/master/LICENSE\n[codeql]: https://img.shields.io/github/actions/workflow/status/rafisarkar0128/hopeless-bot/codeql.yml?style=for-the-badge\u0026logo=github\u0026label=Codeql\n[codeql-url]: https://github.com/rafisarkar0128/hopeless-bot/actions/workflows/codeql.yml\n[dependency-review]: https://img.shields.io/github/actions/workflow/status/rafisarkar0128/hopeless-bot/dependency-review.yml?style=for-the-badge\u0026label=Dependency%20Review\u0026logo=github\n[dependency-review-url]: https://github.com/rafisarkar0128/hopeless-bot/actions?query=workflow%3A%22Dependency+Review%22\n[code-factor]: https://img.shields.io/codefactor/grade/github/rafisarkar0128/node?logo=codefactor\u0026logoColor=%23F44A6A\u0026style=for-the-badge\n[code-factor-url]: https://www.codefactor.io/repository/github/rafisarkar0128/node\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frafisarkar0128%2Fhopeless-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frafisarkar0128%2Fhopeless-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frafisarkar0128%2Fhopeless-bot/lists"}