Skip to content
Jared Dantis edited this page Jan 21, 2024 · 13 revisions

Welcome to Blanco's wiki!

Command reference

Below is a list of the commands currently recognized by Blanco.

All of them are slash commands, so you will need to invoke them through Discord's in-app UI. Blanco will not read them if sent as a normal message.

Music player commands

Some of these commands can also be invoked using the controls on Blanco's Now Playing card.

Command Description Arguments VC required¹
/loop, /unloop Toggle repeat on/off for the current track.
/loopall, /unloopall Toggle repeat on/off for the current queue.
/pause, /unpause Pause or unpause the current track.
/play Add an item to the queue. query (required) Search string or URL
/playlists Get a list of your top 25 Spotify playlists that you can choose from for playback. ²
/previous, /skip Play the previous or next track in the queue.
/queue Display the current queue.
/remove Remove an item from the queue. position (required) Index of the item to remove. See indices using /queue.
/search Search Spotify's catalog for a track, album, artist⁴, or playlist to play. search_type (required) One of album, artist, playlist, or track.

query (required) A string to search on Spotify.
/shuffle, /unshuffle Toggle shuffling on/off for the current queue. ³
/stop Stop the current player, discard the queue, and disconnect from voice.
/volume Set the current player's volume. volume (optional) A number from 0 to 1000. If left blank, Blanco will tell you the current volume.

¹ Requires that you are already in a voice channel that Blanco can connect to (i.e., neither full nor private) and speak in

² Requires account linking through the bot dashboard (blanco.dantis.me for my instance, ask your Blanco instance owner for yours)

³ Tracks added to the queue after shuffling has been activated will be added normally to the end, in non-shuffled order.

⁴ Chosen artists will have their top tracks added to Blanco's queue.

Debugging commands

Command Description Arguments Owner only
/announce Send an announcement to all guilds that Blanco is a part of. ⁴ message (required)
/reload Reload Blanco's commands.
/stats Display statistics for all Lavalink nodes that Blanco is connected to.

⁴ Currently this only works in some servers, not sure how to debug this without bombarding every server with messages 😞

Deployment

If you're looking to deploy Blanco, head over to Prerequisites to make sure you're ready to deploy Blanco, then proceed to Configuration and Deployment.

Once the bot is up and running, invite it to your server with the following link, replacing CLIENT_ID with your bot's client ID:

https://discord.com/api/oauth2/authorize?client_id=CLIENT_ID&permissions=277036943360&scope=applications.commands%20bot

This gives the bot the bot and applications.commands scopes, along with the following permissions:

  • Send Messages
  • Send Messages in Threads
  • Embed Links
  • Use Slash Commands
  • Connect
  • Speak
  • Deafen Members (optional; Blanco uses this to deafen himself)

Then hop into a voice channel and hit /play to get started!

Clone this wiki locally