(or: How to play a song as the next song / playtop, How to pre shuffle a queue)
What flags are and why they are used
To minimize the number of commands you have to remember, Groovy has a unique way of combining commands like /play next, /play shuffled, or similar ideas, into just the play command.
This works using flags. Flags are a small addition to an existing command that work across multiple different commands. The above two commands for example would be /play -n and /play -s respectively.
Let's say you want to queue a playlist. But you've already listened to Despacito 101 times so you'd rather not have it be the first song each time.
Other bots usually use a command like /shuffleplay for this.
With Groovy, you'd instead type /play [playlist link] -s, where the -s stands for "shuffle".
This doesn't only work with -play though. If you used /saved queues load [name] -s, you'd also shuffle the saved queue.
Using flags, you don't have to remember lots of different commands. Also, you can mix and match multiple flags at once to do exactly what you want, e.g. /saved queues load favorites -s -j to load the playlist "favorites" in random order and directly start playing them.
All available flags
To give you an overview of what's available, I've sent our elite code ninjas to collect all the flags you can use:
This instructs Groovy to queue all returned songs. The notable case where this happens is when you queue a YouTube video in a playlist. Normally, Groovy will only queue the video. However, this flag changes the behavior so that Groovy will queue the entire playlist. This is especially useful for queueing YouTube mixes.
If you don't wanna get bored, you can randomize the order of songs in the playlist before it's added to the queue using -s.
Using this, the song you queued is placed directly after the playing track in the queue. Less moving, more grooving.
Instantly jumps to the track you just queued. By instantly, I mean it skips the current song and goes straight to your new one. Perfect for rickrolls.
The choice is yours. Instead of Groovy automatically picking the song closest to your query, you'll get all of them in a neat list and the option to choose which ones you want to queue.
Mix up your playlists and confuse your friends by playing them in reverse order. I wonder what happens if you put this twice. (This doesn't play the actual audio in reverse, just the order of the tracks)