Skip to content

Music

Armory Bot plays music in one designated voice channel per server. There is no per-request voting, no DJ role, and no surprise audio: the bot only ever joins the channel your Admin picked.

Members Come to the Music — It Never Comes to Them

Consent is spatial, not per-request:

  • An Admin designates one Music Channel per server, on the Dashboard's Voice page.
  • The bot never connects to any other voice channel to play music.
  • Joining the Music Channel is how you opt in to hearing music; leaving it is how you opt out. Nobody is ever moved.
  • Anyone currently in the Music Channel can control playback. Admins and Moderators can control it from anywhere, but the audio still only plays in the Music Channel.
  • Want to sit in the Music Channel without hearing music? Right-click the bot and choose Mute — Discord's own per-listener mute, and it sticks until you undo it. The bot can't set this for you (Discord doesn't allow it); /music mute just explains the steps.

Setup

  1. Open /dashboard → Voice.
  2. Pick a Music Channel from the picker (disabled until your server is entitled).
  3. Save. That channel is now the only place the bot will play music.

There is no separate /music-config slash command — the Music Channel is configured on the web, same as other voice settings.

/play

Command Description
/play <query> Play a song now, or queue it if something's already playing. Accepts a search phrase, a YouTube URL, or a Spotify link.

/play requires you to be in the Music Channel, unless you're an Admin or Moderator. If no Music Channel is configured yet, the bot tells you to ask an Admin to pick one on the Dashboard.

/music Commands

Command Description
/music skip Skip the current track
/music pause Pause playback
/music resume Resume playback
/music stop Stop playback, clear the queue, and leave the channel
/music queue Show the current queue (now playing + up to 15 upcoming tracks)
/music nowplaying Show the track currently playing
/music volume <0-100> Set playback volume
/music shuffle Shuffle the queue
/music remove <position> Remove a queued track by its position (as shown in /music queue)
/music mute Ephemeral how-to for Discord's native per-listener mute — the bot cannot mute itself for you

Every /music control command follows the same rule as /play: you must be in the Music Channel, unless you're an Admin or Moderator.

Sources

  • YouTube — search by name, or paste a video URL.
  • Spotify — paste a track link. Spotify is catalog-only: Armory Bot matches the track and plays the equivalent audio from YouTube. No Spotify audio streaming or playback licensing exists for third-party bots, so this is the only way a Spotify link can play anywhere.
  • Livestreams are refused. A live YouTube URL won't queue — it never ends, so it can't be a queue item.
  • Queueing a playlist link only imports up to a capped number of tracks (currently the first 50); huge playlists are trimmed instead of rejected outright.
  • The queue itself has a capacity; once full, /play reports the queue is full and adds nothing.

Auto-Leave

The bot leaves the Music Channel on its own so it never squats there:

  • Empty channel — if every human leaves the Music Channel, the bot disconnects after a short grace period (a few seconds).
  • Silence — if nothing is queued and nothing is playing for a few minutes, the bot disconnects.

Restarts Clear the Queue

The queue lives in memory only — nothing about it is saved to disk. If the bot restarts (deploys, crashes, maintenance), the queue is gone and playback stops by design. Nothing else about your server is affected; just re-queue after a restart.

Troubleshooting

/play says music isn't set up

An Admin hasn't picked a Music Channel yet. Open /dashboard → Voice and set one.

/play or /music commands say to join the Music Channel

You're not currently in the configured Music Channel. Join it to control playback, or ask an Admin/Moderator if you need control from elsewhere.

Commands say Music is a Premium Feature

Your server isn't currently entitled. Apply an active Subscription to the server at the Dashboard.

Try a more specific search phrase, or paste the direct YouTube/Spotify URL instead of a name.

The bot left the channel on its own

Expected behavior — either the channel emptied out or playback sat silent for a few minutes. /play again to bring it back.