JQBX-Bots

JQBX Bot Update 11/10/2021


JQBX Bot Update 11/07/2021


JQBX Bot Update 10/31/2021


JQBX Bot Update 10/30/2021

JQBX Bot Update 10/29/2021

Some great new features are coming to JQBX bots! Here are some of the upcoming changes to be aware of. With this update expect to see more plugins getting updated and released- many are already in the works.


Plugins

The Following Plugins are available with a standard JQBX bot. All plugins have some basic commands built in:

/plugin enable : This will enable this plugin along with all it's subcommands. Refer to plugin specific help for details on how individual commands or features can be enabled as supported.
/plugin disable : This will disable this plugin along with all it's subcommands. Refer to plugin specific help for details on how individual commands or features can be disabled as supported.
/plugin help : Print help + syntax information provided by the plugin author.
/plugin syntax : Print syntax information provided by the plugun author.
/plugin config : Print plugin configuration. Unless over-ridden by the plugin auth, this will be the JSON configuration.

AFK

This plugin automatically removes a user from the DJ queue when the set 'away-from-keyboard' conditions are met.

Commands: afk

AFK Syntax

/afk [minutes] : set inactive time
/afk : get configuration

Alias

This plugin will allow users to add commands that cause the bot to speak the defined message.

Commands: alias, aliases, unalias

Alias Syntax

/alias [name] [message] : to set an alias message.
/aliases : to list aliases.
/unalias [name] : to remove an alias.
/alias import : to import aliases from the old plugin.

AutoDJ

When enabled, this plugin will cause the bot to automatically step up and start playing from the bot's playlist when a user joins and there are no DJs. When all users leave the room, if the bot is DJing, it will step down. Note: this plugin requires that /botdj is enabled and has a playlist configured.

Commands: autodj

AutoDJ Syntax

/autodj

BotDJ

This plugin allows the bot to step up and start playing from the bot's playlist.

Commands: up, down, botdj
Sub Commands: playlist, shuffle, pushNextTrack, joinDjs, leaveDjs

BotDJ Syntax

/up : step up
/down : step down
/botdj playlist [spotifyuri] : set the bot's queue to a playlist
/botdj playlist : print the bot's current playlist
/botdj shuffle : shuffle the bot's current playlist

BotVote

This plugin allows the bot to nope, dope, star, etc.

Commands: dope, nope, star, boof
Aliases: ro, row, no

BotVote Syntax

/dope : 3 ro's and the bot will dope.
/nope : 3 no's and the bot will nope.
/star : 5 star's and the bot will star.
/boof : 5 boof's and the bot will boof-star

Choose

This plugin performs a highly advanced calculation using the latest AI technology to advise users on the optimal selection of available outcomes.

Commands: choose

Choose Syntax

/choose [choice], [choice], [...] : randomly choose from provided choices

Clear

Sometimes chat can get a little embarrassing or too spicy. We understand and this plugin allows the chat to be quickly cleared to get things back on topic.

Commands: clear, dotheclear

Clear Syntax

/clear : send configuraed number of blank alert lines to the chat window
/clear [count] [rate in ms]: send specified number of blank alert lines to the chat window at the specified rate. (a slower rate is better for mobile apps)

DadJoke

Request a dadjoke. Provide additional words to search for your favorite!

Commands: dadjoke

DadJoke Syntax

/dadjoke
/dadjoke [words...]

Dice

This plugin will roll x dice with x sides. Welcome to the dungeon!

Commands: dice, roll

Dice Syntax

/roll [#dice]d[#side] to roll the dice.
/roll 1d6 - rolls 1 6-sided dice (default).
/roll 5d10 - rolls 5 10-sided dice.

First

This plugin will return the first play of the currently playing song. This plugin can automatically print the first play on every song by toggling /first auto on.

Commands: first
Sub Commands: auto, status
Aliases: auto-first, autofirst, af

First Syntax

/first : provides information about the first play of the track (from JQBX's official stats).
/first auto : report status of auto-first
/first auto [enable|on|disable|off] : toggle auto first on or off.
/auto-first|autofirst|af : aliases for /first auto

Hay / WalkieTalkie

This plugin is used to send messages to other rooms.

Commands: hay
Aliases: yo, send

Hay / WalkieTalkie Syntax

/hay : list active rooms that can receive messages.
/hay [room-handle] [message] : send a message.

Help

This plugin provides basic user help.

Commands: help, audiohelp
Aliases: halp, bot, commands, what, how, h

Help Syntax

/help : display general bot and plugin help
/help plugins : display status of all plugins
/audiohelp : report status of auto-first

Inspire

This plugin asks for images from inspirobot.me. You're welcome?

Commands: inspire

Inspire Syntax

/inspire : display an inspirational image.
/inspire [season] : display a seasonal inspirational image.

Mock

This plugin mocks your friends and enemies alike.

Commands: mock

Mock Syntax

/mock

Spotify

This plugin will fetch information about the currently playing track from Spotify.

Commands: spotify, album, relink, genre, metrics
Aliases: metric

Spotify Syntax

/album : Fetch current track's album info from Spotify.
/genre : Fetch current track's genre info from Spotify.
/metrics : Fetch current track's metrics from Spotify.
/relink : Fetch current track's Spotify availability by country

Urban

Because switching tabs is so much work.

Commands: urban

Urban Syntax

/urban [query] : request the Urban Dictionary definition.

Weather

Get the weather for a location, or get the forecast. I don't care.

Commands: weather, forecast

Weather Syntax

/weather : Get the weather for the last requested location.
/forecast : Get the forecast for the last requested location.
/weather [location] : Get the weather.
/forecast [location] : Get the forecast.

WelcomeMessage

This plugin whispers a welcome message to users when they join. It can also announce when users join. Set either welcome message or announce message to nothing to disable just that message: /welcome message

Commands: welcome

WelcomeMessage Syntax

/welcome message [message] to set message whispered to users when they join.
/welcome announce [message] to set announce message when a user joins.
(note: @user will be replaced with the joining user's username)

YouHere

Answers the question: Are you here?

Commands: youhere
Aliases: youthere, you-there, you-here

YouHere Syntax

/youhere [username] : how long since this user did anything.

Youtube

This plugin automatically fetches a link to the current track in youtube form. For educational purposes only.

Commands: yt
Sub Commands: setup

Youtube Syntax

/yt : get youtube link for the current track
/yt setup [key]: set the youtube api key. For help getting a Youtube API key: https://developers.google.com/youtube/v3/getting-started
/yt relink [on|off] : automatically get a youtube link when /relink command returns track is not available.

Legacy Plugins

Config Commands

/config set name [name of bot] - sets name of your bot.
/config set [image | djImage | thumbsUpImage | thumbsDownImage] [URL] - sets image/djImage/thumbsUpImage/thumbsDownImage to the specified image (by URL).
/config set images - sets all bot's images to current user's images.

Song Interaction

/whosampled - attempts to return a link to whosampled if the current track uses samples from other songs

Social

/speak - send a message as the bot
/alert - send a room alert