Overview
The r!volume command adjusts or displays the current playback volume. Volume ranges from 0 (muted) to 100 (maximum).
Usage
Volume level between 0-100. Omit to check current volume.
Set Volume
Adjust playback volume to a specific level:
# Set volume to 50%
r!volume 50
# 🔊 Volumen ajustado a: `50%`
# Set volume to maximum
r!volume 100
# 🔊 Volumen ajustado a: `100%`
# Mute (set to 0)
r!volume 0
# 🔊 Volumen ajustado a: `0%`
Check Current Volume
Omit the level parameter to check current volume:
r!volume
# 🔊 Volumen actual: `75%`
Implementation
From commands/music/volume.js:4-20:
async execute(message, args, client) {
const queue = client.distube.getQueue(message);
if (!queue) return message.reply('❌ ¡No hay nada reproduciéndose!');
const volume = parseInt(args[0]);
if (isNaN(volume)) {
return message.reply(`🔊 Volumen actual: \`${queue.volume}%\``);
}
if (volume < 0 || volume > 100) {
return message.reply('❌ ¡Por favor especifica un número entre 0 y 100!');
}
queue.setVolume(volume);
message.reply(`🔊 Volumen ajustado a: \`${volume}%\``);
}
Volume Behavior
Validate Queue
Checks if music is currently playing
Parse Input
- No input: Return current volume
- Number provided: Validate range 0-100
Apply Volume
Uses DisTube’s setVolume() method to adjust playback
Confirm Change
Sends confirmation message with new volume level
Valid Volume Range
Mutes audio completely (0%)
Values outside 0-100 range are rejected
Requirements
Music must be currently playing
An active queue must exist
Error Messages
No Music Playing
r!volume 50
# ❌ ¡No hay nada reproduciéndose!
Invalid Range
r!volume 150
# ❌ ¡Por favor especifica un número entre 0 y 100!
r!volume -10
# ❌ ¡Por favor especifica un número entre 0 y 100!
r!volume abc
# 🔊 Volumen actual: `75%`
Non-numeric input returns current volume instead of error
Common Volume Levels
Quiet (25%)
Background music during conversation
Normal (50%)
Balanced volume for casual listening
Loud (75%)
Energetic listening sessions
Maximum (100%)
Full volume for parties/events
Volume Examples
Typical Use Cases
# Background music
r!volume 30
# Normal listening
r!volume 60
# Party mode
r!volume 90
# Quick mute
r!volume 0
Check Before Adjusting
# Check current level
r!volume
# 🔊 Volumen actual: `45%`
# Increase it
r!volume 70
# 🔊 Volumen ajustado a: `70%`
Volume Persistence
Volume settings:
Persist during current session
Apply to all songs in queue
Apply instantly to current playback
Reset when bot disconnects
DisTube Volume Methods
The command uses DisTube’s queue volume management:
queue.volume // Get current volume (0-100)
queue.setVolume(level) // Set new volume level
Best Practices
Start at 50% and adjust up or down based on preference
Consider Discord’s user volume settings - they multiply with bot volume
Very high volumes (90-100%) may cause audio distortion
r!play - Start playing musicr!pause - Pause playback (preserves volume)r!resume - Resume at same volume levelr!status - View bot status
Discord Volume Interaction
Users can also adjust volume individually:
- Bot Volume: Set with
r!volume command (affects everyone)
- User Volume: Right-click bot in voice → Adjust user volume (personal)
- Final Volume: Bot volume × User volume
If bot volume is 50% and user sets personal volume to 50%, final volume is 25%
Tips for Different Scenarios
Voice Chat with Music
r!volume 25
# Low enough for conversation
Music Focus Session
r!volume 70
# Higher for immersive listening
Late Night Listening
r!volume 35
# Quieter to avoid disturbing others
Event/Party
r!volume 95
# Near maximum for energetic atmosphere
