Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/hurricanodev/hurricano
An amazing open-source Discord bot using MongoDB with many features such as a customizable prefix, a reaction menu, music, role requirement giveaways and much more!
https://github.com/hurricanodev/hurricano
bot contributions-welcome discord discord-api discord-bot discord-js discordjs giveaways hacktoberfest mongodb music
Last synced: about 1 month ago
JSON representation
An amazing open-source Discord bot using MongoDB with many features such as a customizable prefix, a reaction menu, music, role requirement giveaways and much more!
- Host: GitHub
- URL: https://github.com/hurricanodev/hurricano
- Owner: HurricanoDev
- License: gpl-3.0
- Created: 2021-01-25T09:07:26.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2023-09-05T15:34:18.000Z (about 1 year ago)
- Last Synced: 2024-09-29T08:42:15.748Z (about 1 month ago)
- Topics: bot, contributions-welcome, discord, discord-api, discord-bot, discord-js, discordjs, giveaways, hacktoberfest, mongodb, music
- Language: JavaScript
- Homepage: https://dsc.gg/hurricano
- Size: 2.02 MB
- Stars: 92
- Watchers: 5
- Forks: 32
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# Development for this bot has been paused indefinitely. It probably will not be continued. Feel free to hit me up at `dragonizedpizza` on Discord if you want to hire me for a commission.
Hurricano™ 🌀
An open source Discord bot!
Invite Hurricano 🌀
Features⭐ :
⭐ Mongoose-Based Command Cooldowns
⭐ Command Permissions
⭐ Slash Command Handler
⭐ Subcommands system
⭐ OwnerOnly Commands
⭐ Args required or not Option
⭐ Permissions handler
⭐ Role-Requirement Giveaways
⭐ Customizable server settings using MongoDB
⭐ Button help-menu
⭐ Starboard
⭐ Logging
⭐ a lot of `/` commands
⭐ ...And many interesting commands!
Getting Started 🚀
These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.
Prerequisites 📋
You'll need Git and Node.js (which comes with NPM) installed on your computer.
```
[email protected] or higher
[email protected] or higher
[email protected] or higher
```
Bot setup 🔧
1. Lets get started by cloning Hurricano on your local machine.
```bash
# cloning the repository
$ git clone https://github.com/HurricanoBot/Hurricano.git
# go into the repository
$ cd Hurricano
```
2. Now rename the config.example.json file to config.json and the required enviromental variables like bot token, ownerIds etc.
```json
{
"token": "Your bot token",
"mongouri": "Mongodb uri",
"prefix": "Your prefix",
"ownerIds": ["Owner's USER IDs", "Like this", "can be as many"],
"statcordKey": "optional, leave empty if you don't want statcord",
"website": {
"enabled": false,
"ip": "Website IP",
"port": "Port"
},
"topgg": {
"enabled": false,
"token": "only put something here if you set top.gg api to true",
"webhook": {
"enabled": false,
"webhookPassword": "top.gg vote webhook password",
"webhookPort": 1234,
"channel": "vote webhook channel ID",
"webhookIP": "vote webhook IP"
}
},
"botChannels": {
"bugReport": "...",
"feedback": "...",
"serverJoinChannel": "..."
}
}
```
3. Now install all the required dependecies for the bot and run the bot.
```bash
# install the required dependencies
$ npm install
# Run the bot
$ node .
```
Hosting ☁️
So you might be thinking how to host your bot on a cloud service so that it remains active 24/7 so currently we are hosting Hurricano on heroku which supports node v14.0.0 and npm v7.0.0 and above.
Star Chart 🌟
## Project Maintainers ✨
Dragonizedpizza
Militia21
Achal Jhawar
🤝 Contributing
Any idea on how we can make this more awesome ? [Open a new issue](https://github.com/Hurricanobot/Hurricano/issues)! We need all the help we can get to make this project awesome! You can also join the discord server to give suggestions. You can read the [Contributing guidelines](CONTRIBUTING.md).
## All Stargazers ✨
[](https://github.com/Hurricanobot/Hurricano/stargazers)
## License 📝
Hurricano™ Bot is licensed under the GPL 3.0 license. See the file `LICENSE` for more information. If you plan to use any part of this source code in your own bot, We would be grateful if you would include some form of credit somewhere.