{"id":47783710,"url":"https://github.com/matta-official/discord-bot","last_synced_at":"2026-04-03T14:02:46.979Z","repository":{"id":138924761,"uuid":"391430772","full_name":"MattA-Official/discord-bot","owner":"MattA-Official","description":"🤖 A simple Discord bot framework/template.","archived":false,"fork":false,"pushed_at":"2021-09-10T16:24:14.000Z","size":119,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-05-02T05:24:12.912Z","etag":null,"topics":["bot","discord","nodejs"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MattA-Official.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2021-07-31T18:08:41.000Z","updated_at":"2021-09-10T16:24:17.000Z","dependencies_parsed_at":"2023-05-04T15:46:49.061Z","dependency_job_id":null,"html_url":"https://github.com/MattA-Official/discord-bot","commit_stats":null,"previous_names":[],"tags_count":0,"template":true,"template_full_name":null,"purl":"pkg:github/MattA-Official/discord-bot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MattA-Official%2Fdiscord-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MattA-Official%2Fdiscord-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MattA-Official%2Fdiscord-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MattA-Official%2Fdiscord-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MattA-Official","download_url":"https://codeload.github.com/MattA-Official/discord-bot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MattA-Official%2Fdiscord-bot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31355741,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-03T08:03:20.796Z","status":"ssl_error","status_checked_at":"2026-04-03T08:00:37.834Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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","nodejs"],"created_at":"2026-04-03T14:01:34.417Z","updated_at":"2026-04-03T14:02:46.964Z","avatar_url":"https://github.com/MattA-Official.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🤖 Discord Bot\n\nA simple Discord bot \u0026 command/event framework. Supporting slash and message commands.\n\n## Features\n\n- Slash Commands\n- Message Commands\n- Full API coverage (using [discord.js](https://discord.js.org))\n- Runs on Node\n- `es6` syntax\n\n## Run Locally\n\nClone the project\n\n```bash\ngit clone https://github.com/matta-official/bot.git\n```\n\nGo to the project directory\n\n```bash\ncd bot\n```\n\nInstall dependencies\n\n```bash\nyarn install\n#or\nnpm install\n```\n\nStart the server\n\n```bash\nyarn start\n#or\nnpm run start\n```\n\n## Environment Variables\n\nTo run this project, you will need to add the following environment variables to your .env file\n\n1. `BOT_TOKEN` - Your bot token found at the [Discord Developer Portal](https://discord.com/developers)\n2. `REDIS_URI` - The URI to your [Redis](https://redis.io) db instance. Usually `redis://\u003cuser\u003e:\u003cpass\u003e@127.0.0.1:6379`\n3. `GUILD_ID` - The ID of the guild you want to run the bot in.\n\n## Contributing\n\nContributions are always welcome!\n\nSee [`contributing.md`](/contributing.md) for ways to get started.\n\nPlease adhere to this project's [`code of conduct`](/code_of_conduct.md).\n\n## Authors\n\n- [@matta-official](https://www.github.com/matta-official)\n\n# Reference\n\n## Commands\n\nAll commands require the following data export:\n\n```js\nexport const data = {\n\tname: 'name',\n\tdescription: 'a description of what the command does',\n\toptions: [], // optional - array of #ApplicationCommandOption\n\tdefaultPermissions: false, // optional - boolean whether to allow access by default\n};\n\nexport const permissions = []; // optional - array of #ApplicationCommandPermission\n```\n\n### Message\n\nMessage commands should be exported as shown below:\n\n```js\nexport const message = true;\n\nexport const execute = async (client, msg, args) =\u003e {\n\t// command logic in here\n};\n```\n\n### Slash\n\nSlash commands should be exported as shown below:\n\n```js\nexport const slash = true;\n\nexport const interaction = async (client, interaction) =\u003e {\n\t// command logic in here\n};\n```\n\n## Components\n\nComponents are are a framework for adding interactive elements to messages. All components require the following exports:\n\n```js\nexport const data = {\n\tid: 'id',\n};\n\nexport const interaction = async (client, interaction) =\u003e {\n\t// component logic in here\n};\n```\n\n## Events\n\nEvents have a different number of arguments passed, check the discord.js documentation for information on each. Always pass the client before any additional arguments.\n\n```js\nexport const name = 'name';\nexport const once = true;\n\nexport const execute = async (client, ...args) =\u003e {\n\t// event logic in here\n};\n```\n\n## Database\n\nCurrently, the database only supports Redis. However, it is planned to support other databases in the future. This is due to the ease of using mulitple databases in Keyv. The database is accessed through the `client.db` object. It is not required to use a persistant database, but it is recommended. If `REDIS_URI` is not set, an in-memory store will be used.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmatta-official%2Fdiscord-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmatta-official%2Fdiscord-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmatta-official%2Fdiscord-bot/lists"}