Skip to main content

Overview

Control music playback with pause and resume commands. These commands allow you to temporarily halt playback and continue from where you left off.

Pause Command

Pauses the currently playing music.

Usage

r!pause

Behavior

1

Check Queue

Verifies music is currently playing
2

Check Pause State

Confirms music isn’t already paused
3

Pause Playback

Halts the audio stream

Examples

# Pause currently playing music
r!pause
# ⏸️ ¡Música pausada!

Implementation

From commands/music/pause.js:4-14:
async execute(message, args, client) {
    const queue = client.distube.getQueue(message);
    if (!queue) return message.reply('❌ ¡No hay nada reproduciéndose!');
    
    if (queue.paused) {
        return message.reply('⚠️ ¡La música ya está pausada! Usa !resume para reanudar.');
    }

    queue.pause();
    message.reply('⏸️ ¡Música pausada!');
}

Resume Command

Resumes playback after pausing.

Usage

r!resume

Behavior

1

Check Queue

Verifies a queue exists
2

Check Pause State

Confirms music is paused
3

Resume Playback

Continues audio from pause point

Examples

# Resume paused music
r!resume
# ▶️ ¡Música reanudada!

Implementation

From commands/music/resume.js:4-16:
async execute(message, args, client) {
    const queue = client.distube.getQueue(message);
    if (!queue) return message.reply('❌ ¡No hay nada reproduciéndose!');

    if (queue.paused) {
        queue.resume();
        return message.reply('▶️ ¡Música reanudada!');
    }
    
    queue.pause();
    message.reply('⏸️ ¡Música pausada!');
}
The resume command also acts as a toggle - it can pause if music is playing. However, the dedicated r!pause command is clearer for this purpose.

Requirements

Music must be currently playing
An active queue must exist

Error Messages

No Music Playing

r!pause
# ❌ ¡No hay nada reproduciéndose!

Already Paused

r!pause
# ⚠️ ¡La música ya está pausada! Usa !resume para reanudar.

Use Cases

Take a Break

Pause music during conversations or breaks

Answer Call

Quickly pause when you need to take a call

Announcement

Pause for important announcements in voice

AFK Moment

Pause when stepping away temporarily

State Management

Both commands use DisTube’s queue state management:
  • queue.paused - Boolean indicating if playback is paused
  • queue.pause() - Method to pause playback
  • queue.resume() - Method to resume playback
The queue maintains playback position, so resuming continues from the exact point where you paused.
  • r!stop - Completely stop playback and clear queue (cannot resume)
  • r!skip - Move to next song instead of pausing
  • r!play - Start playing music

Tips

Use r!pause for temporary breaks - your spot in the song is saved
If you use r!stop instead of pause, the queue is cleared and you cannot resume

Build docs developers (and LLMs) love