myleskeeffe / PiksDungeon

Yet another discord management bot

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

PiksDungeon has been archived.

When I originally forked evobot, I intended to add a couple commands for a couples of friends servers for fun. However, know that we are wanting more functionality, it has become harder to keep adding it to evobot, as evobot was primarily a music button and built for that. So I will instead create a separate management/fun bot, and run Evobot separately (directly built from their source) so that way I avoid command conflicts, and different coding styles. The latest build of this codebase will NOT work, as it needed some more fixes to work with the upstream merges.


Deploy

logo

πŸ€– EvoBot (Discord Music Bot)

EvoBot is a Discord Music Bot built with discord.js & uses Command Handler from discordjs.guide

Requirements

  1. Discord Bot Token Guide
  2. YouTube Data API v3 Key Guide
    2.1 (Optional) Soundcloud Client ID Guide
  3. Node.js v12.0.0 or newer

πŸš€ Getting Started

If deploying to Heroku make sure to create config variables

heroku

git clone https://github.com/eritislami/evobot.git
cd evobot
npm install

After installation finishes you can use node index.js to start the bot.

βš™οΈ Configuration

Copy or Rename config.json.example to config.json and fill out the values:

⚠️ Note: Never commit or share your token or api keys publicly ⚠️

{
  "TOKEN": "",
  "YOUTUBE_API_KEY": "",
  "SOUNDCLOUD_CLIENT_ID": "",
  "MAX_PLAYLIST_SIZE": 10,
  "PREFIX": "/",
  "PRUNING": false,
  "STAY_TIME": 30
}

πŸ“ Features & Commands

Note: The default prefix is '/'

  • 🎢 Play music from YouTube via url

/play https://www.youtube.com/watch?v=GLvohMXgcBo

  • πŸ”Ž Play music from YouTube via search query

/play under the bridge red hot chili peppers

  • 🎢 Play music from Soundcloud via url

/play https://soundcloud.com/blackhorsebrigade/pearl-jam-alive

  • πŸ”Ž Search and select music to play

/search Pearl Jam

Reply with song number or numbers seperated by comma that you wish to play

Examples: 1 or 1,2,3

  • πŸ“ƒ Play youtube playlists via url

/playlist https://www.youtube.com/watch?v=YlUKcNNmywk&list=PL5RNCwK3GIO13SR_o57bGJCEmqFAwq82c

  • πŸ”Ž Play youtube playlists via search query

/playlist linkin park meteora

  • Now Playing (/np)
  • Queue system (/queue, /q)
  • Loop / Repeat (/loop)
  • Shuffle (/shuffle)
  • Volume control (/volume, /v)
  • Lyrics (/lyrics, /ly)
  • Pause (/pause)
  • Resume (/resume, /r)
  • Skip (/skip, /s)
  • Skip to song # in queue (/skipto, /st)
  • Remove song # from queue (/remove, /rm)
  • Toggle pruning of bot messages (/pruning)
  • Help (/help, /h)
  • Command Handler from discordjs.guide
  • Media Controls via Reactions reactions

🀝 Contributing

  1. Fork the repository
  2. Clone your fork: git clone https://github.com/your-username/evobot.git
  3. Create your feature branch: git checkout -b my-new-feature
  4. Commit your changes: git commit -am 'Add some feature'
  5. Push to the branch: git push origin my-new-feature
  6. Submit a pull request

πŸ“ Credits

@iCrawl For the queue system used in this application which was adapted from @iCrawl/discord-music-bot

About

Yet another discord management bot

License:MIT License


Languages

Language:JavaScript 99.2%Language:Dockerfile 0.8%