Music

Configure music playback settings, Lavalink nodes, and audio features

Introduction

The Music configuration file (music.json) controls Lavalink node connections, default playback settings, channel restrictions, and autoplay features.

---

Lavalink Nodes

Type: Array of Objects

Configure Lavalink servers for music playback.

lavalink_nodes: [
    {
        name: 'Iynx',
        url: '127.0.0.1:2333',
        auth: 'youshallnotpass',
        secure: false,
    },
]

name - Descriptive name for the node url - Server address in format ip:port auth - Lavalink server password secure - Whether to use secure connection (true/false)

You can add multiple nodes and the bot will automatically select the one with the lowest traffic for optimal performance.

Lavalink Addon Users: If you have the Lavalink premium addon, this configuration is automatically overridden by the addon's servers.

---

Default Volume

Type: Number

Starting volume level for new music sessions.

default_volume: 60

Valid range: 1 to 1000

This is the volume level used when the bot first starts playing music. Users can adjust it afterward using music commands.

---

Whitelist Channels

Restrict music commands to specific channels.

enabled

Type: Boolean

Whether to enable channel restrictions.

whitelist_channels: {
    enabled: false,
}

When true: Music commands only work in configured channels When false: Music commands work everywhere

---

channels

Type: Array of Strings

List of channel IDs where music commands are allowed.

channels: ["804354119523500082", "947577986939514881"]

Only applies when enabled is set to true.

---

Use Own Lavalink

Type: Boolean

Override addon Lavalink servers with your own configuration.

use_own_lavalink: false

When true: Uses your configured Lavalink nodes even if you own the addon When false: Uses premium addon Lavalink servers (if you have the addon)

This option only matters if you have purchased the Lavalink addon.

---

Autoplay Enabled by Default

Type: Boolean

Automatically add similar songs to the queue.

autoplay_enabled_by_default: false

When true: After the first song plays, the bot automatically adds similar tracks based on metadata When false: Bot only plays queued songs

---

Complete Configuration Example

Here's a production-ready music configuration:

{
    config: {
        lavalink_nodes: [
            {
                name: 'Primary Node',
                url: '127.0.0.1:2333',
                auth: 'yourpassword',
                secure: false,
            },
            {
                name: 'Backup Node',
                url: '192.168.1.100:2333',
                auth: 'yourpassword',
                secure: false,
            },
        ],

        default_volume: 60,

        whitelist_channels: {
            enabled: true,
            channels: ["804354119523500082", "947577986939514881"],
        },

        use_own_lavalink: false,

        autoplay_enabled_by_default: false,
    }
}