{"id":15211401,"url":"https://github.com/anidiotsguide/guidebot","last_synced_at":"2025-10-03T04:30:49.294Z","repository":{"id":22815619,"uuid":"95237186","full_name":"AnIdiotsGuide/guidebot","owner":"AnIdiotsGuide","description":"A boilerplate example bot with command handler and reloadable commands. Updated and Maintained by the Idiot's Guide Community","archived":true,"fork":false,"pushed_at":"2023-01-07T09:59:25.000Z","size":750,"stargazers_count":494,"open_issues_count":4,"forks_count":267,"subscribers_count":33,"default_branch":"master","last_synced_at":"2024-09-25T11:03:30.526Z","etag":null,"topics":["command-handler","discord","discord-bot-template","discord-js","nodejs"],"latest_commit_sha":null,"homepage":"","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/AnIdiotsGuide.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-06-23T16:27:24.000Z","updated_at":"2024-09-18T20:52:34.000Z","dependencies_parsed_at":"2023-01-14T07:45:49.060Z","dependency_job_id":null,"html_url":"https://github.com/AnIdiotsGuide/guidebot","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AnIdiotsGuide%2Fguidebot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AnIdiotsGuide%2Fguidebot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AnIdiotsGuide%2Fguidebot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AnIdiotsGuide%2Fguidebot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AnIdiotsGuide","download_url":"https://codeload.github.com/AnIdiotsGuide/guidebot/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":219876149,"owners_count":16554739,"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":["command-handler","discord","discord-bot-template","discord-js","nodejs"],"created_at":"2024-09-28T08:40:39.193Z","updated_at":"2025-10-03T04:30:44.010Z","avatar_url":"https://github.com/AnIdiotsGuide.png","language":"JavaScript","readme":"# Guide Bot\n\nA boilerplate of a Discord.js Bot Handler.\nUpdated and Maintained by the [Idiot's Guide Community](https://discord.gg/vXVxsAjSMF).\n\nGuidebot is an attempt to show the basics of command and event handling, in clear, concise,\nand commented code. Guidebot can be used as the template for any type of bot, and contains\nmost of the basic features you would need:\n\n- A command handler\n- A basic permission system\n- An event handler\n- Basic useful commands\n- Per-server configuration system\n- A logging system\n\nFunctionally [guidebot](https://github.com/AnIdiotsGuide/guidebot/) is identical to [guidebot class](https://github.com/AnIdiotsGuide/guidebot/tree/class), but the difference is that guidebot\nclass is created with classes whilst this version is purely function based.\n\nNeed support? Join the [Idiot's Guide Community](https://discord.gg/vXVxsAjSMF)!\n\n## Requirements\n\n- `git` command line ([Windows](https://git-scm.com/download/win) | [Linux](https://git-scm.com/download/linux) | [MacOS](https://git-scm.com/download/mac)) installed\n- `node` [Version 16.x](https://nodejs.org)\n- The node-gyp build tools. This is a pre-requisite for Enmap, but also for a **lot** of other modules. See [The Enmap Guide](https://enmap.evie.codes/install#pre-requisites) for details and requirements for your OS. Just follow what's in the tabbed block only, then come back here!\n\nYou also need your bot's token. This is obtained by creating an application in\nthe Developer section of discord.com. Check the [first section of this page](https://anidiots.guide/getting-started/getting-started-long-version)\nfor more info.\n\n## Intents\n\nYou can enable privileged intents in your bot page\n(the one you got your token from) under `Privileged Gateway Intents`.\n\nBy default GuideBot needs the Guilds, Guild Messages and Direct Messages intents to work.\nFor join messages to work you need Guild Members, which is privileged.\nUser counts that GuideBot has in places such as in the ready log, and the stats\ncommand may be incorrect without the Guild Members intent.\n\nIntents are loaded from the index.js file, and the installer is pre-set with the Guilds, Guild Messages and Direct Messages intents.\n\nFor more info about intents checkout the [official Discord.js guide page](https://discordjs.guide/popular-topics/intents.html) and the [official Discord docs page](https://discord.com/developers/docs/topics/gateway#gateway-intents).\n\n## Downloading\n\nCreate a folder within your projects directory and run the following inside it:\n\n`git clone https://github.com/anidiotsguide/guidebot.git .`\n\nOnce finished:\n\n- In the folder from where you ran the git command, run `npm install`, which will install the required packages.\n- **If you get any error about python or msibuild.exe or binding, read the requirements section again!**\n- Rename `config.js.example` to `config.js`, and give it the required intents and any partials you may require.\n- Rename `.env-example` to `.env` and put in your bot token in it and save.\n\n## Starting the bot\n\nTo start the bot, in the command prompt, run the following command:\n`node index.js`\n\n## Inviting to a guild\n\nTo add the bot to your guild, you have to get an oauth link for it.\n\nYou can use this site to help you generate a full OAuth Link, which includes a calculator for the permissions:\n[Permission Calculator](https://finitereality.github.io/permissions-calculator/?v=0)\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fanidiotsguide%2Fguidebot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fanidiotsguide%2Fguidebot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fanidiotsguide%2Fguidebot/lists"}