{"id":14983303,"url":"https://github.com/hurricanodev/hurricano","last_synced_at":"2025-04-06T16:10:23.336Z","repository":{"id":44538048,"uuid":"332688643","full_name":"HurricanoDev/Hurricano","owner":"HurricanoDev","description":"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!","archived":false,"fork":false,"pushed_at":"2025-03-15T20:34:49.000Z","size":2124,"stargazers_count":92,"open_issues_count":2,"forks_count":31,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-03-30T15:07:22.397Z","etag":null,"topics":["bot","contributions-welcome","discord","discord-api","discord-bot","discord-js","discordjs","giveaways","hacktoberfest","mongodb","music"],"latest_commit_sha":null,"homepage":"https://dsc.gg/hurricano","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/HurricanoDev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-01-25T09:07:26.000Z","updated_at":"2025-03-15T20:34:52.000Z","dependencies_parsed_at":"2024-10-12T03:01:32.368Z","dependency_job_id":"721a755d-0697-440c-b92a-7b771b129d80","html_url":"https://github.com/HurricanoDev/Hurricano","commit_stats":{"total_commits":759,"total_committers":17,"mean_commits":44.64705882352941,"dds":0.5862977602108037,"last_synced_commit":"51c5f0391e6cbac7a7f8332ae26021189de8a80b"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HurricanoDev%2FHurricano","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HurricanoDev%2FHurricano/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HurricanoDev%2FHurricano/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HurricanoDev%2FHurricano/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/HurricanoDev","download_url":"https://codeload.github.com/HurricanoDev/Hurricano/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247509221,"owners_count":20950232,"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","contributions-welcome","discord","discord-api","discord-bot","discord-js","discordjs","giveaways","hacktoberfest","mongodb","music"],"created_at":"2024-09-24T14:07:02.222Z","updated_at":"2025-04-06T16:10:23.314Z","avatar_url":"https://github.com/HurricanoDev.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Development for this bot has been paused indefinitely. It probably will not be continued. Feel free to hit me up at `vbwr` on Discord if you want to hire me for a commission.\n\n\u003ch1 align=\"center\"\u003e Hurricano™  🌀\u003c/h1\u003e\n\u003cp align=\"center\"\u003e\n\u003ca href=\"https://github.com/HurricanoBot/Hurricano/blob/main/LICENSE.md\"\u003e\u003cimg alt=\"GitHub license\" src=\"https://img.shields.io/github/license/HurricanoBot/Hurricano?style=for-the-badge\"\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/HurricanoBot/Hurricano/stargazers\"\u003e\u003cimg alt=\"GitHub stars\" src=\"https://img.shields.io/github/stars/HurricanoBot/Hurricano?style=for-the-badge\"\u003e\u003c/a\u003e \n\u003ca href=\"https://github.com/HurricanoBot/Hurricano/network\"\u003e\u003cimg alt=\"GitHub forks\" src=\"https://img.shields.io/github/forks/HurricanoBot/Hurricano?style=for-the-badge\"\u003e\u003c/a\u003e\n\u003ca href=\"https://discord.gg/vMvdy39qYD\"\u003e\u003cimg alt=\"GitHub forks\" src=\"https://img.shields.io/badge/Discord-7289DA?style=for-the-badge\u0026logo=discord\u0026logoColor=white\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\u003ch3 align=\"center\"\u003eAn open source Discord bot!\u003c/h3\u003e\n\n\u003ch2\u003eInvite Hurricano 🌀\u003c/h2\u003e\n\u003cdiv align=center\u003e\n\u003ca href=\"https://discordbotlist.com/bots/803169312827113483\"\u003e\u003cimg src=\"https://discordbotlist.com/api/v1/bots/803169312827113483/widget\"\u003e\u003c/a\u003e\n\u003ca href=\"https://top.gg/bot/803169312827113483\"\u003e\u003c/center\u003e\n\u003cimg src=\"https://top.gg/api/widget/803169312827113483.svg\" alt=\"HurricanoBot\"/\u003e\n\u003c/a\u003e\n\n\u003c/div\u003e\n\n\u003ch2\u003eFeatures⭐ :\u003c/h2\u003e\n\n⭐ Mongoose-Based Command Cooldowns\n\u003cbr/\u003e\n⭐ Command Permissions\n\u003cbr/\u003e\n⭐ Slash Command Handler\n\u003cbr/\u003e\n⭐ Subcommands system\n\u003cbr/\u003e\n⭐ OwnerOnly Commands\n\u003cbr/\u003e\n⭐ Args required or not Option\n\u003cbr/\u003e\n⭐ Permissions handler\n\u003cbr/\u003e\n⭐ Role-Requirement Giveaways\n\u003cbr/\u003e\n⭐ Customizable server settings using MongoDB\n\u003cbr/\u003e\n⭐ Button help-menu\n\u003cbr/\u003e\n⭐ Starboard\n\u003cbr/\u003e\n⭐ Logging\n\u003cbr/\u003e\n⭐ a lot of `/` commands\n\u003cbr/\u003e\n⭐ ...And many interesting commands!\n\n\u003ch1\u003e Getting Started  🚀\u003c/h1\u003e\n\nThese 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.\n\n\u003ch2\u003e Prerequisites 📋 \u003c/h2\u003e\nYou'll need Git and Node.js (which comes with NPM) installed on your computer.\n\u003c/br\u003e\n\u003c/br\u003e\n\n```\nnode@v14.0.0 or higher\nnpm@7.0.0 or higher\ngit@2.17.1 or higher\n```\n\n\u003chr\u003e\n\u003ch2\u003eBot setup  🔧\u003c/h2\u003e\n1. Lets get started by cloning Hurricano on your local machine.\n\u003c/br\u003e\n\u003c/br\u003e\n\n```bash\n# cloning the repository\n$ git clone https://github.com/HurricanoBot/Hurricano.git\n\n# go into the repository\n$ cd Hurricano\n\n```\n\n2. Now rename the config.example.json file to config.json and the required enviromental variables like bot token, ownerIds etc.\n\n```json\n{\n\t\"token\": \"Your bot token\",\n\t\"mongouri\": \"Mongodb uri\",\n\t\"prefix\": \"Your prefix\",\n\t\"ownerIds\": [\"Owner's USER IDs\", \"Like this\", \"can be as many\"],\n\t\"statcordKey\": \"optional, leave empty if you don't want statcord\",\n\t\"website\": {\n\t\t\"enabled\": false,\n\t\t\"ip\": \"Website IP\",\n\t\t\"port\": \"Port\"\n\t},\n\t\"topgg\": {\n\t\t\"enabled\": false,\n\t\t\"token\": \"only put something here if you set top.gg api to true\",\n\t\t\"webhook\": {\n\t\t\t\"enabled\": false,\n\t\t\t\"webhookPassword\": \"top.gg vote webhook password\",\n\t\t\t\"webhookPort\": 1234,\n\t\t\t\"channel\": \"vote webhook channel ID\",\n\t\t\t\"webhookIP\": \"vote webhook IP\"\n\t\t}\n\t},\n\t\"botChannels\": {\n\t\t\"bugReport\": \"...\",\n\t\t\"feedback\": \"...\",\n\t\t\"serverJoinChannel\": \"...\"\n\t}\n}\n```\n\n3. Now install all the required dependecies for the bot and run the bot.\n\n```bash\n# install the required dependencies\n$ npm install\n\n# Run the bot\n$ node .\n```\n\n\u003ch2 align=\"center\"\u003e Hosting ☁️\u003c/h2\u003e\n\u003cp align=\"center\"\u003e\n\u003ca href=\"https://heroku.com/\"\u003e\u003cimg alt=\"heroku\" src=\"https://img.shields.io/badge/Heroku-430098?style=for-the-badge\u0026logo=heroku\u0026logoColor=white\"\u003e\u003c/a\u003e\n\u003c/p\u003e\nSo 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. \n\u003ch2 align=\"center\"\u003eStar Chart 🌟 \u003c/h2\u003e\n\u003ca href=\"https://github.com/HurricanoBot/Hurricano/stargazers\"\u003e\n    \u003cimg src=\"https://starchart.cc/HurricanoBot/Hurricano.svg\" alt=\"HurricanoBot\"/\u003e\n\u003c/a\u003e\n\n## Project Maintainers ✨\n\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://github.com/Dragonizedpizza\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/70718540?v=4\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eDragonizedpizza\n\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://github.com/Militia21\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/70501605?v=4\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eMilitia21\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003c/td\u003e\n     \u003ctd align=\"center\"\u003e\u003ca href=\"https://github.com/achaljhawar\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/35405812?v=4\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eAchal Jhawar\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\u003cimg src=\"https://raw.githubusercontent.com/HurricanoBot/HurricanoImages/d0facab8f7e20042e5f1381525d6a80ada6e62e6/other/undraw_real_time_collaboration_c62i.svg\" width=\"50%\" align=\"right\"\u003e\n\u003ch2\u003e🤝 Contributing\u003c/h2\u003e\n\nAny 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).\n\n\u003cbr/\u003e\n\u003cbr/\u003e\n\u003cbr/\u003e\n\u003cbr/\u003e\n\u003cbr/\u003e\n\u003cbr/\u003e\n\n## All Stargazers ✨\n\n[![Stargazers repo roster for @Hurricanobot/Hurricano](https://reporoster.com/stars/Hurricanobot/Hurricano)](https://github.com/Hurricanobot/Hurricano/stargazers)\n\n## License 📝\n\nHurricano™ 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.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhurricanodev%2Fhurricano","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhurricanodev%2Fhurricano","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhurricanodev%2Fhurricano/lists"}