{"id":14983189,"url":"https://github.com/namvr/discordbot-template","last_synced_at":"2025-04-05T14:08:54.096Z","repository":{"id":37407136,"uuid":"364676755","full_name":"NamVr/DiscordBot-Template","owner":"NamVr","description":"A boilerplate / template for discord.js v14 bots with 100% coverage of Discord API, command handler, error handler based on https://discordjs.guide/","archived":false,"fork":false,"pushed_at":"2024-05-30T15:17:54.000Z","size":178,"stargazers_count":325,"open_issues_count":0,"forks_count":79,"subscribers_count":12,"default_branch":"master","last_synced_at":"2025-04-05T14:08:50.054Z","etag":null,"topics":["boilerplate-template","buttons","command-handler","context-menus","discord","discord-api","discord-bot","discord-bot-template","discord-js","discord-ts","discordjs","error-handler","nodejs","select-menus","slash-commands","typescript","typings","v14","vsc"],"latest_commit_sha":null,"homepage":"https://djs.docs.namanvrati.me/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/NamVr.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":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-05-05T18:52:18.000Z","updated_at":"2025-03-22T06:55:11.000Z","dependencies_parsed_at":"2024-09-28T08:40:46.659Z","dependency_job_id":null,"html_url":"https://github.com/NamVr/DiscordBot-Template","commit_stats":{"total_commits":37,"total_committers":6,"mean_commits":6.166666666666667,"dds":"0.16216216216216217","last_synced_commit":"5da22efe3c6c7537ced740a2afbed5e04b761c5a"},"previous_names":[],"tags_count":8,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NamVr%2FDiscordBot-Template","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NamVr%2FDiscordBot-Template/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NamVr%2FDiscordBot-Template/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NamVr%2FDiscordBot-Template/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/NamVr","download_url":"https://codeload.github.com/NamVr/DiscordBot-Template/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247345854,"owners_count":20924102,"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":["boilerplate-template","buttons","command-handler","context-menus","discord","discord-api","discord-bot","discord-bot-template","discord-js","discord-ts","discordjs","error-handler","nodejs","select-menus","slash-commands","typescript","typings","v14","vsc"],"created_at":"2024-09-24T14:06:52.565Z","updated_at":"2025-04-05T14:08:54.064Z","avatar_url":"https://github.com/NamVr.png","language":"JavaScript","readme":"\u003ch1 align=\"center\"\u003eWelcome to NamVr Discord Bot Template 👋\u003c/h1\u003e\n\u003cp\u003e\n  \u003cimg alt=\"Version\" src=\"https://img.shields.io/badge/version-v3.3-blue.svg?cacheSeconds=2592000\" /\u003e\n  \u003ca href=\"https://github.com/NamVr/DiscordBot-Template#readme\" target=\"_blank\"\u003e\n    \u003cimg alt=\"Documentation\" src=\"https://img.shields.io/badge/documentation-yes-brightgreen.svg\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/NamVr/DiscordBot-Template/graphs/commit-activity\" target=\"_blank\"\u003e\n    \u003cimg alt=\"Maintenance\" src=\"https://img.shields.io/badge/Maintained%3F-yes-green.svg\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://twitter.com/namanvrati\" target=\"_blank\"\u003e\n    \u003cimg alt=\"Twitter: namanvrati\" src=\"https://img.shields.io/twitter/follow/namanvrati.svg?style=social\" /\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003e An **open source** `discord.js` bot template which is based on official [discord.js guide](https://discordjs.guide/) to get started on making your very personal discord bot!\n\n### 🏠 [Homepage](https://github.com/NamVr/DiscordBot-Template#readme)\n\n## Introduction\n\n`NamVr` Discord Bot Template is an open source discord.js based bot template to get started on a new bot project. It is classic javascript template, not requiring any external dependencies unlike other famous frameworks. (This is not a framework!)\nYou can scale any kind of bot project using this template. (single server based or multiple server based) It all depends on your creativity!\n\n\u003e 🛠️ **NEW!** _This template now supports **in-built typing (typescript-assistance) support** too, which means you will get all typescript-like assistant in vanilla javascipt! (Visual Studio Code tested, working 100% as expected)_\n\n### Features:\n\nThis template comes in with many in-built useful and flexible features, such as\n\n#### • **Dynamic Command Handler:**\n\n- My template comes in with a dynamic command handler! Using the command handler, you don't need to indulge in main bot files to create your very own command!\n- You can simply make command groups (categorized as folders) in the [commands](https://github.com/NamVr/DiscordBot-Template/tree/master/commands/) folder.\n- Your JavaScript commands goes inside respective category folders. A sample command is provided as [ping](https://github.com/NamVr/DiscordBot-Template/blob/master/commands/misc/ping.js) command. You can use the same skeleton for all commands you want!\n\n#### • **Dynamic Event Handler:**\n\n- All events goes inside the [events](https://github.com/NamVr/DiscordBot-Template/blob/master/events/) folder. You don't need to use `client.on()` in the main `bot.js` file to handle events.\n- Using simple skeleton code for events, you can make any amount of events in the events folder using the event handler.\n\n#### • **Dynamic Trigger Handler:**\n\n- Triggers occur when a specific \"phrase\" is said in a message content. For example, if you want your bot to react with :heart: when someone say `welcome` in their message, you can do that with this trigger handler!\n- Trigger Handler also has the same skeleton structure as of command handler. The trigger handler is associated with the [triggers](https://github.com/NamVr/DiscordBot-Template/tree/master/triggers/) folder. There are trigger categories, like [reactions](https://github.com/NamVr/DiscordBot-Template/tree/master/triggers/reactions) folder, in the trigger folder.\n- A sample trigger command is given in the [`hello.js`](https://github.com/NamVr/DiscordBot-Template/tree/master/triggers/reactions/hello.js) trigger file.\n\n#### • **Dynamic Slash Command Handler:**\n\n- My template comes with a dynamic slash command handler with very easy to customize and make slash commands.\n- The commands, in the slashCommands folder, receive an [`CommandInteraction`](https://discord.js.org/#/docs/main/stable/class/CommandInteraction) object. You can see the [documentation of discord.js](https://discord.js.org/#/docs/main/stable/class/CommandInteraction) for all the properties and methods available.\n- **IMPORTANT:** In the template, we are sending the slash commands to discord to be registered only to 1 guild. That is because their are 2 types of slash commands, guild and global. Guild commands are restricted to 1 guild but whenever you update them, they take effect immediately, whereas global commands take upto 1 hour to take effect. So use guild commands in development and global commands for production.\n\n#### • **Dynamic Buttons Interaction Handler:**\n\n- This template comes with a dynamic button interaction handler to receive and process button interactions.\n- Buttons can be classified in two category folders.\n\n#### • **Dynamic Modals Interaction Handler:**\n\n- Easily handle incoming modal submittions using the template handler!\n- Modals can be categorized in different folders.\n\n#### • **Dynamic Context Menu Handler:**\n\n- All new addition to discord API is context menus! You can right click a user or message -\u003e Apps to find these options!\n- This template will register all your context menu options and dynamically interact with them! Worth a try.\n\n#### • **[NEW] Dynamic Autocomplete Interaction Request Handler:**\n\n- Easily handle incoming autocomplete requests using the template handler!\n- Perfectly dynamic for all your needs!\n\n#### • **Highly Customizable:**\n\nUsing the template is so easy and fun, you would know. As the template does not rely on any external dependencies and written in javascript, it is highly customizable to any extend. There's no end to your creativity!\n\n#### • **Open source and self-hosted:**\n\n\u003e It's yours, you have full control.\n\n## Install\n\n```sh\nnpm install\n```\n\n## Configuration\n\n- Rename [`config-example.json`](https://github.com/NamVr/DiscordBot-Template/blob/master/config-example.json) to `config.json` and fill the token and other values. Extend config.json according to your needs!\n\n## Run your bot\n\n```sh\nnpm start\n```\n\n## Support \u0026 Documentation\n\nI'm working to make it more professional and easy to use for everyone. There will be a documentation out very soon.\n\n\u003e WIP : https://djs.docs.namanvrati.cf/\n\n## Author\n\n👤 **Naman Vrati**\n\n- Website: https://namanvrati.cf/ [broken lol]\n- Twitter: [@namanvrati](https://twitter.com/namanvrati) [inactive]\n- Github: [@NamVr](https://github.com/NamVr) [follow here]\n\n### Contributors\n\n👤 Thank you so much to **[Krish Garg](https://github.com/KrishGarg)** and **[Thomas Fournier](https://github.com/GoudronViande24)** for giving awesome contributions to the project.\n\n## 🤝 Contributing\n\nContributions, issues and feature requests are welcome!\u003cbr /\u003eFeel free to check [issues page](https://github.com/NamVr/DiscordBot-Template/issues). You can also take a look at the [contributing guide](https://github.com/NamVr/DiscordBot-Template/blob/master/CONTRIBUTING.md).\n\n## Show your support\n\nGive a ⭐️ if this project helped you! Star-ring the project gives me encouragement to continue it.\nYou can also [sponsor](https://ko-fi.com/namanvrati) the project and get listed as a contributer! Thanks a lot.\n\n## 📝 License\n\nCopyright © 2021 [Naman Vrati](https://github.com/NamVr).\u003cbr /\u003e\nThis project is [Apache-2.0](LICENSE) licensed.\n\n---\n","funding_links":["https://ko-fi.com/namanvrati"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnamvr%2Fdiscordbot-template","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnamvr%2Fdiscordbot-template","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnamvr%2Fdiscordbot-template/lists"}