{"id":22829147,"url":"https://github.com/eric-philippe/discord-bot-starter-kit","last_synced_at":"2026-05-06T03:35:12.524Z","repository":{"id":199143163,"uuid":"702216071","full_name":"Eric-Philippe/Discord-Bot-Starter-Kit","owner":"Eric-Philippe","description":"A fresh and ready to run Typescript / Bun Discord Bot attached to a sqlite database !","archived":false,"fork":false,"pushed_at":"2023-10-08T21:58:46.000Z","size":12,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-10-24T22:39:21.616Z","etag":null,"topics":["begginers","bot","bun","discord","easy","sqlite","typescript"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/Eric-Philippe.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}},"created_at":"2023-10-08T20:32:37.000Z","updated_at":"2023-10-08T21:54:41.000Z","dependencies_parsed_at":null,"dependency_job_id":"133a78dd-a703-4b7c-9b0a-e00416d249c0","html_url":"https://github.com/Eric-Philippe/Discord-Bot-Starter-Kit","commit_stats":null,"previous_names":["eric-philippe/discord-bot-starter-kit"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/Eric-Philippe/Discord-Bot-Starter-Kit","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Eric-Philippe%2FDiscord-Bot-Starter-Kit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Eric-Philippe%2FDiscord-Bot-Starter-Kit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Eric-Philippe%2FDiscord-Bot-Starter-Kit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Eric-Philippe%2FDiscord-Bot-Starter-Kit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Eric-Philippe","download_url":"https://codeload.github.com/Eric-Philippe/Discord-Bot-Starter-Kit/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Eric-Philippe%2FDiscord-Bot-Starter-Kit/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32677932,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-06T02:33:58.958Z","status":"ssl_error","status_checked_at":"2026-05-06T02:33:39.611Z","response_time":117,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5: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":["begginers","bot","bun","discord","easy","sqlite","typescript"],"created_at":"2024-12-12T19:13:26.784Z","updated_at":"2026-05-06T03:35:12.489Z","avatar_url":"https://github.com/Eric-Philippe.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Discord Bot Starter Kit\n\nThis is a starter kit for a Discord bot written in TypeScript and using Bun. The main goal of this project is to provide a simple and easy to use starter kit for anyone who wants to create a Discord bot using TypeScript. it's quick and easy to launch your first bot with this starter kit !\n\n## Summary\n\n- [Discord Bot Starter Kit](#discord-bot-starter-kit)\n  - [Summary](#summary)\n  - [First Features](#first-features)\n    - [Commands](#commands)\n    - [XP System](#xp-system)\n    - [A structured project](#a-structured-project)\n  - [How to use](#how-to-use)\n    - [Requirements](#requirements)\n    - [Copy the project](#copy-the-project)\n    - [Install the dependencies](#install-the-dependencies)\n    - [Create the .env file](#create-the-env-file)\n    - [Create and dump the database](#create-and-dump-the-database)\n    - [Create the Discord Bot](#create-the-discord-bot)\n      - [Get the bot token](#get-the-bot-token)\n      - [Get the client ID](#get-the-client-id)\n      - [Give the bot the Privileged Gateway Intents](#give-the-bot-the-privileged-gateway-intents)\n    - [Invite the bot to your server](#invite-the-bot-to-your-server)\n    - [Run the bot](#run-the-bot)\n  - [How to add a command](#how-to-add-a-command)\n    - [Create the command file](#create-the-command-file)\n  - [Feedback or issues](#feedback-or-issues)\n\n## First Features\n\n### Commands\n\nThe starter kit comes with a simple command handler. You can create commands in the `commands` folder. The command handler will automatically load them and make them available in your Discord server.\n\n### XP System\n\nThe kit implements a really simple and basic XP system to show you how to use the bun implemented sqlite database. Feel free to improve it and make it better !\n\n### A structured project\n\nThe project is structured in a way that makes it easy to understand and to use. You can easily add new commands, events, etc. Also showing a database table manager as in the `src/UserProfileManager.ts` file.\n\n## How to use\n\n### Requirements\n\n- Ubuntu (Or MacOs / WSL), bun is not available on Windows yet\n\n- Bun v1.0.0 or higher [Download Link Here](https://bun.sh)\n\n### Copy the project\n\n```bash\n$ git clone https://github.com/Eric-Philippe/Discord-Bot-Starter-Kit.git\n\n\u003e Cloning into 'Discord-Bot-Starter-Kit'...\n```\n\n### Install the dependencies\n\n```bash\n$ cd Discord-Bot-Starter-Kit\n$ bun i\n```\n\n### Create the .env file\n\n```bash\n$ cp .env.example .env\n```\n\n### Create and dump the database\n\n```bash\n$ bun run src/database/scripts/dump.ts\n```\n\n### Create the Discord Bot\n\nGo on the [Discord Developer Portal](https://discord.com/developers/applications) and create a new application. Then go to the `Bot` tab and create a new bot.\n\n#### Get the bot token\n\nYou can get the bot token by clicking on the `Copy` button in the `Token` section and then paste it in the `.env` file in the `BOT_TOKEN` variable.\n\n#### Get the client ID\n\nYou can get the client ID on the `General Information` tab. Copy it and paste it in the `.env` file in the `CLIENT_ID` variable.\n\n#### Give the bot the Privileged Gateway Intents\n\nGo back on the `Bot` tab and check the `Presence Intent` and `Server Members Intent` and `Message Content Intent` checkboxes. This will allow the bot to get the list of members in a server and to get the content of a message.\n\n### Invite the bot to your server\n\nGo back on the `Oauth2 -\u003e URL Generator` tab and check the `bot` checkbox.\nThen, give your bot the permissions you want it to have and copy the generated URL. Paste it in your browser and select the server you want to invite the bot to.\n\n### Run the bot\n\nGo back to the project folder and run the bot\n\n```bash\nbun start\n\n\u003e Ready !\n```\n\nor if you want to run it in the background\n\n```bash\nbun start \u0026\n\n\u003e Ready !\n```\n\nNow you can use your bot !\n\n## How to add a command\n\n### Create the command file\n\nCreate a new file in the `src/commands` folder. The file name will be the command name. For example, if you want to create a `ping` command, create a `Ping.ts` file.\n\nI then invite you to read the [Command documentation](https://discordjs.guide/creating-your-bot/slash-commands.html#individual-command-files) !\n\n## Feedback or issues\n\nIf you have any feedback or issue, feel free to open an issue on the [GitHub repository](https://github.com/Eric-Philippe/Discord-Bot-Starter-Kit/issues) or if you need any help feel free to contact me on Discord `zaorhion` !\n\n_I would also be really glad to have some feedback on the project !_\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feric-philippe%2Fdiscord-bot-starter-kit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Feric-philippe%2Fdiscord-bot-starter-kit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feric-philippe%2Fdiscord-bot-starter-kit/lists"}