https://github.com/tinspham209/discord-bot
Discord Moderation & Music BOT Application
https://github.com/tinspham209/discord-bot
discord-bot discordjs ffmpeg-static momentjs music-bot-discord nodejs opusscript webhooks ytdl-core
Last synced: about 1 year ago
JSON representation
Discord Moderation & Music BOT Application
- Host: GitHub
- URL: https://github.com/tinspham209/discord-bot
- Owner: tinspham209
- Created: 2020-08-25T04:41:14.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2023-12-15T11:44:35.000Z (over 2 years ago)
- Last Synced: 2025-04-30T07:50:04.235Z (about 1 year ago)
- Topics: discord-bot, discordjs, ffmpeg-static, momentjs, music-bot-discord, nodejs, opusscript, webhooks, ytdl-core
- Language: JavaScript
- Homepage:
- Size: 95.7 KB
- Stars: 0
- Watchers: 1
- Forks: 4
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Mini Project: Discord Moderation & Music BOT
## Date: 25 - Aug - 2020
### Tech-Stack
- NodeJS v14.7
- Discord.js v12
- dotenv : store variable `process.env.variable_name`
- ytdl-core : Convert youtube link to audio
- opusscript
- ffmpeg-static : Need FFMPEG For Any Music Bot To Work
- moment : time format
- ms : convert string seconds to number: Input: 100s > `numbers`
### Screenshot
### Functions
**MODERATION BOT:**
1. Kick : `$kick @[user_name] [reason-reason]`
- \$kick @Rafen spamming
2. Ban : `$ban @[user_name] [reason-reason]`
- \$ban @Rafen spamming
3. Soft ban : `$softban @[user_name] [reason-reason]` - default: 1 day
- \$softban @Rafen spamming
4. Temp ban: `$tempban @[user_name] [reason-reason] [seconds]s`
- \$tempban @Rafen Breaking-rule 200s
5. Mute : `$mute @[user_name] [reason-reason] [seconds]s`
- \$mute @Rafen spamming 100s
6. UnMute: `$unmute @[user_name] [reason-reason]`
- \$unmute @Rafen ccc
7. Reaction to set Role:
- Reaction :watermelon: icon to add `Verified` role
8. Send text in bot-command channel, BOT send announcements to specify channel: `$announce [text]`
- \$announce Hello everybody
**MUSIC BOT:**
1. Play: `$play [youtube_url]`
- \$play https://www.youtube.com/watch?v=gwpud7f_nDk
2. Add music to queue: `$play [youtube_url]`
- \$play https://www.youtube.com/watch?v=gwpud7f_nDk
3. Stop: `$stop`
4. Skip: `$skip`
5. Pause: `$pause`
6. Resume: `$resume`
7. change Volume : `$volume [1-5]` - default: 5
- \$volume 3
8. Now Playing: `$nowplaying`
9. check song queue: `$queue`
### Plan Of Action
- Project Setup
- Creating Discord Application
- Adding the Bot to our Discord Server
- Logging the bot In Discord Server
- Basic Events
- Ready Event
- Message Events
- Bot Responses
- Basic Chat Commands
- Kick Command
- Ban Command
- Message Reactions & Reaction Roles
- Announce command - Webhooks
- Play command
- Stop command
- Create Queue system
- Add song to queue
- Skip command
- Pause command
- Resume command
- change Volume command
- NowPlaying command
- check song queue command
- Refactor
- Kick with new logic
- Ban with new logic
- Soft Ban command
- Mute command
- UnMute command
- Temp Ban command
### After this project
Next Steps:
- Music is playing but response too longgggg 😂
- Add youtube search function
- Add/Remove Role
- Create/Delete Role
- Create/Delete Channel
- Refactor code by split specify function in specify folder
### Directory Structure
```
.
├── package.json
├── package-lock.json
├── README.md
├── .env
└── src
└── bot.js
```
### Set up
1. Clone repo to your computer:
```
git clone https://github.com/tinspham209/discord-bot.git
```
2. Install dependencies.
```
npm install
```
3. **Adding the Bot to discord server**
- https://discord.com/developers/applications > General Information > `CLIENT_ID`
- And type URL in your browser: https://discord.com/api/oauth2/authorize?client_id=`CLIENT_ID`&scope=bot
4. **Update variable in `.env`**
```js
// .env
DISCORDJS_BOT_TOKEN=
WEBHOOK_ID=
WEBHOOK_TOKEN=
REACTION_MESSAGE_ID=
ROLE_NAME=
ROLE_ID=
ROLE_MUTE_ID=
```
- `DISCORDJS_BOT_TOKEN`:
- https://discord.com/developers/applications ~> BOT > TOKEN
- Setting Webhooks in specify channel that you want BOT send announcements
- Setting text channel > Integrations > New Webhook > Copy Webhook URL
- Get `WEBHOOK_ID` & `WEBHOOK_TOKEN` in URL
- https://discordapp.com/api/webhooks/WEBHOOK_ID/WEBHOOK_TOKEN
- `REACTION_MESSAGE_ID` : ID of comment that you want to set function reaction to set role
- `ROLE_NAME` = icon that you want user react to set Role - example: `:watermelon:`
- `ROLE_ID` = ID of roles that you want to set in server setting > roles
- `ROLE_MUTE_ID` : Role ID that is already mute in server setting > roles
5. If you want to add more reaction roles. You need to update code at `src/bot.js` in function `messageReactionAdd` &`messageReactionRemove`
- Add new variable in `.env`. Example: `ROLE_NAME_2` & `ROLE_ID_2`
- Add more case at `switch case` on each functions
6. **Run in Production**
```
npm start
```
7. **Or run in development: nodemon**
```
npm run dev
```