Skip to content

Music

Armory Bot plays music where people have said yes to hearing it — and nowhere else. There's no DJ role and no surprise audio: the bot plays in the Music Channel your Admin picked, or in another voice channel only after the people in it vote to invite it.

Members Come to the Music — It Never Comes to Them

Consent is spatial — you opt in by being in the room:

  • An Admin designates one Music Channel per server, on the Dashboard's Voice page. That channel carries standing consent: the bot can always play there.
  • Joining the Music Channel is how you opt in to hearing music; leaving it is how you opt out. Nobody is ever moved.
  • Want music in a different voice channel? /play from inside it starts a consent vote in that channel's chat. Everyone present gets a say, a single NO blocks it, and silence can't block a room that's otherwise on board. A passed vote lets the bot play there until that session ends — no standing designation, no sneaking in later.
  • Anyone currently in the channel where music is playing can control playback. Admins and Moderators can control it from anywhere, but the audio still only plays where consent exists.
  • 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.