discord.js-musicbot-addon-niels v6.0.2

For some reason, The Den (discord server) no longer exists. A new server has been created and will be re-made overtime for those interested in joining. https://discord.gg/FKYrX4X
NOTE: 10.0.3-aplha is not a real update and will contain broken code. Please do not use it for production.

This module may be buggy and need some fine tuning. Feel free to let me know what problems you encounter by opening an issue on the repo. This was originally an update of the original bot from ruiqimao by nexu-dev, but is now a updated version (again) for Discord.js's version 11.2^. Fixes deprecated warnings, video playback issues, along with various other add-ons and tweaks to the priors. For support/questions join the Discord server for a faster response than the repo.

The commands available are: (default names)

• musichelp [command]: Displays help text for commands by this addon, or help for a specific command.
• play <url>|<search string>: Play audio from YouTube.
• skip [number]: Skip a song or multi songs with skip some number,
• queue: Display the current queue.
• pause: Pause music playback.
• resume: Resume music playback.
• volume: Adjust the playback volume between 1 and 200.
• leave: Clears the song queue and leaves the channel.
• clearqueue: Clears the song queue.
• owner: Various owner commands/actions. (W.I.P)

Permissions:

• If anyoneCanSkip is true, anyone can skip songs in the queue.
• If anyoneCanAdjust is true, anyone can adjust the volume.
• If ownerOverMember is true, the set ID of the user (botOwner) will over-ride CanAjust and CanSkip.

Installation

Pre-installation:
1. npm install discord.js
It is recommended to have the stable branch.

2. ffmpeg installed correctly for your OS/env.
   Allows the bot to join voice as well as speak.

3. npm install node-opus or npm install opusscript
   Required for voice. Discord.js prefers node-opus.

Installation:

• npm install discord.js-musicbot-addon

Common installation issues:
Issue: (Trivial) FFMPEG was not found on your system.
Fix: Make sure ffmpeg is installed correctly and set in your PATH variable.

Issue: (Uncommon) Couldn't find an Opus engine.
Fix: npm install node-opus or npm install opusscript

Issue: (Rare) NPM ERR Cannot read property '0' of undefined
Fix: npm i -g npm@4.6.1 or another lower version of npm.

Issue: (Rare) TypeError: Invalid non-string/buffer chunk
Fix: Stop using ffmpeg-binaries. Seriously. It's been said enough to use ffmpeg itself by now.

Issue: (Trivial) Any node-gyp errors. (build fail, missing cl.exe, etc.)
Fix: This one is a little more complicated.
1. Download and install Visual Studio 2015
2. New project -> Visual C++
3. Install Visual C++

If that doesn't fix your issue;
1. Download and install the Windows 8.1 SDK

Issue: (Uncommon) ffluent-ffmpeg errors. 1. Download and install ffmpeg correctly for your OS/env. 2. Stop asking and make sure it's installed right.

Basic Example.

This addon is easy to use, and doesn't require any extra configuration besides a YouTube Data API key to run.
More examples can be found on the repo or once downloaded in examples.

Example basic code, standalone:

const Discord = require('discord.js');
const Music = require('discord.js-musicbot-addon');
const client = new Discord.Client();

const music = new Music(client, {
  youtubeKey: 'sum-key_hhereas'
});

client.login("token");

Options & Config.

Most options are optional and thus not needed.
The options you can pass in music(client, {options}) and their types is as followed:
Note: All boolean options default false.

Basic Options.

Other Options.

Command Options.

An example of a few custom options would be:

const music = new Music(client, {
  prefix: ">",
  maxQueueSize: "100",
  disableLoop: true,
  leaveHelp: "Bad help text.",
  leaveAlt: ["lve","leev","un1c0rns"],
  helpCmd: 'mhelp',
  leaveCmd: 'begone',
  ownerOverMember: true,
  botOwner: '123456789101112',
  youtubeKey: 'some-key_here'
});

Changelog

10.0.3-aplha

• A faux update to alert people of the old server just poofing out of existence. DO NOT use it for production use, as it is broken.

1.10.3

• Removed lockChan and unused related items.

1.10.2

• Bot now supports multiple prefix's.
• Added advancedMode, multiPrefix, advancedMode object settings. Please see examples (advancedModeBot.js) or the discord server.
• Fixed leave.
• Fixed note function errors.
• Added set command.
• Boolean options are now always Booleans. Always.
• Added botAdmins. Adding an ID will allow this user to override every permission.

1.10.1

• Corrected streamMode error.

1.10.0

• Added the search command.
• Added the thumbnailType option.
• Play command now plays the first result instead of searching.
• Links might work now.
• anyoneCanLeave allows anyone to use leave.
• Maximum call stack errors should occur less or not at all.
• You can now change between using ytdl-core and youtube-audio-stream to stream music with streamMode.
• Small fixes.

1.9.1

• Fixed looping errors.
• May have fixed some link related errors.
• Added the maxWait option.
• Fixed command run functions.

1.9.0

• Requires Node 8+.
• Added aliases support.
• Small changes to some code.
• Started the owner command.
• Commands are now mapped on startup.
• Added custom help text for commands.
• Looping & last played are per-server.
• Looping & last played have new functions.
• Prefix and command names are now case sensitive.
• May have fixed some 'undefined' errors with play.
• Pause now doesn't pause if it's already paused. Yeah...
• Alive message now replaces {{username}} with the bots username.
• When looping music, no longer shows a "Now Playing" for the same song.
• Added messageHelp, if true will attempt message a user on help usage.
• Alive message now replaces {{starttime}} with the bots readyAt time.
• Help command now sends both embeds and non-embed messages according to permissions.
• Errors now display when queueing a song rather than showing "timed out" when one actually occurs. Probably.

1.8.2

• Actually fixed the play function queueing the wrong song. (update: I lied)

1.8.1

• Fixed the queueing error within the play function.

1.8.0

• Updated the searching for the play command, you can now choose out of 10 results.
• Tried to fix weird bug with link queueing, still broken.
• Probably caused more issues than I fixed.
• Removed maxChecks.

1.7.2

• Added maxChecks option.
• Now checks after searching for videos if the link to be played is a video.

1.7.1

• Fixed clearInvoker. I think.

1.7

• Added fancy embeds to some commands.
• Able to use !queue [songNumber] to view info on a specific song in the queue.
• Checks whether the requester of the song is available for the bot.
• Stores the avi-url of the requester for the song.
• Prevents some errors from crashing the bot.
• Fixed the alive messages, along with a startup message (console).
• Added option (inlineEmbeds) to make embeds by the bot inline. See the embed field documention for info.
• Fixed playlist fetching when the link had something like &list=RDOeJKsrD791A&t=66 to prevent throwing errors or crashes.
• Looping force disables on clearQueue, leave and skip.
• Removed events/emitters because I forgot what the hell I was doing with them.

1.6.10

• Fixed queue, NowPlaying's.

1.6.8

• Added error catching for new features to help prevent bot crashing and error logging.
• Put random shit in so I could call this a real update.

1.6.7

• (probable) Error fix.

1.6.6

• rocky_road.jpeg

1.6.5

• Fixed a typo from 1.6.4 that crashes the bot.

1.6.4

• Pull requests merged/edited (mcao, Erik). For most changes, take a look at their pull requests.
• Added requesterName.

1.6.3

• Brought back disabling commands.
• Fixed help function.

1.6.2

• Nothing notable.

1.6.1

• Fixed some typos and minor errors.

1.6

• Removed asynchronous functions since some people don't like using the latest and greatest.
• Added enabling/disabling commands.
• Added looping.
• "Class" update.
• Fixed some errors/bugs from 1.5.
• Added alive message function && (heh) options.
• Removed enabling/disabling commands until further notice.
• Added all additions from pull requests to the main npm module.
• Updated examples.

1.5.1

• Added playlist support (thanks Rodabaugh for reminding me).
• Fixed clearqueue crashing if queue is empty.
• Fixed skip crashing if the queue is empty.
• Now requires ffmpeg installed over ffmpeg-binaries.

1.4.0

• Added wrapping.
• Added owner over member options.
• Fixed errors.
• Reworked the playing music method.
• Fixed UnknownSpawn errors.
• Bot now requires your own YouTube Data API3 key for searching.
• Music is less likely to cut out now.
• Volume works again (again).

1.3.1 - 1.3.6

• These were testing updates to just see how it would work on different platforms, which code still needed to be fixed, error testing, etc.

1.3.0:

• Added errors.
• Fixed volume crashing the bot (thanks TheTimmaeh).
• Added future support for events.
• Minor bug fixes.

1.2.0:

• Marked "stable".
• Finished module for full public access.

1.1.0 and lower:

• No idea.