Queue

Constructor

Queue : options

new Magmastream.Queue(guildId: string, manager: Manager)

Parameter	Type	Description
guildId	string as Guild.id	The guild ID
manager	Manager	The Manager instance.

Table of contents

Properties	Methods
current	add()
guildId	clear()
manager	duration()
previous	remove()
	roundRobinShuffle()
	shuffle()
	size()
	totalSize()
	userBlockShuffle()

Properties

current

The current track

Return: track{} | unresolvedTrack{} | null

guildId

The guild ID property.

Return: string as Guild.id

manager

The Manager instance.

Return: Manager

previous

The previous track

Return: track{} | unresolvedTrack{} | null

Methods

add(track, offset)

Adds a track to the queue.

Return: void

Parameter	Type	Description	Optional
track	(track{} | unresolvedTrack{}) | (track{} | unresolvedTrack{})[]	The track or tracks to add. Can be a single Track or an array of Tracks.
offset	number	The position to add the track(s) at. If not provided, the track(s) will be added at the end of the queue.

clear()

Clears the queue.

This will remove all tracks from the queue and emit a state update event.

Return: void

duration()

The total duration of the queue in milliseconds.

This includes the duration of the currently playing track.

Return: number

remove(start | position, end)

Removes track(s) from the queue.

Return: (track{} | unresolvedTrack{})[]

Remove track with position

Parameter	Type	Description	Optional
position	number	If a single number is provided, it will be treated as the position of the track to remove.

const { Manager } = require('magmastream');

const manager = new Manager({
    ...ManagerOptions
})

const searchResponse = await manager.search('Never Gonna Give You Up');

const player = client.lavalink.create({
        ...PlayerOptions
    });

player.connect()
player.queue.add(searchResponse.tracks);

player.play();

setTimeout(() => {
    player.queue.remove(2)
}, 5000);

Remove tracks with range of positions

Parameter	Type	Description	Optional
start	number	Position for start range to remove
end	number	Position for end range to remove

const { Manager } = require('magmastream');

const manager = new Manager({
    ...ManagerOptions
})

const searchResponse = await manager.search('Never Gonna Give You Up');

const player = client.lavalink.create({
    ...PlayerOptions
});

player.connect()
player.queue.add(searchResponse.tracks);

player.play();

setTimeout(() => {
    player.queue.remove(2, 5)
}, 5000);

Remove track with start or position and/or end

Parameter	Type	Description	Optional
startOrPosition	number	If a single number is provided, it will be treated as the position of the track to remove. If two numbers are provided, they will be used as the start and end of a range of tracks to remove.
end	number	Optional, end of the range of tracks to remove.

const { Manager } = require('magmastream');

const manager = new Manager({
    ...ManagerOptions
})

const searchResponse = await manager.search('Never Gonna Give You Up');

const player = client.lavalink.create({
    ...PlayerOptions
});

player.connect()
player.queue.add(searchResponse.tracks);

player.play();

setTimeout(() => {
    // remove track at position 2
    player.queue.remove(2)
    // or
    // remove tracks from position 2 to 5
    player.queue.remove(2, 5)
}, 5000);

roundRobinShuffle()

Shuffles the queue to play tracks requested by each user one by one.

Return: void

shuffle()

Shuffles the queue.

This will randomize the order of the tracks in the queue and emit a state update event.

Return: void

size()

The size of tracks in the queue.

This does not include the currently playing track.

Return: number

totalSize()

The total size of tracks in the queue including the current track.

This includes the current track if it is not null.

Return: number

userBlockShuffle()

Shuffles the queue to play tracks requested by each user one block at a time.

Return: void