Player

const player = await lunacord
  .createPlayer()
  .setGuild(guildId)
  .setVoiceChannel(voiceChannelId)
  .setTextChannel(textChannelId)
  .preferRegion("us-east")
  .preferNodes(["main", "backup"])
  .withHistoryLimit(20)
  .onQueueEmpty(async (player, reason) => {
    // Called whenever the queue is empty. `reason` is "manual" or "trackEnd".
  })
  .withQueueEndDestroyDelay(120_000)  // ms before auto-cleanup (default 120s)
  .connect();

await player.play(track?, { noReplace?: boolean });
await player.pause(true);
await player.pause(false);
await player.stop();          // defaults: destroyPlayer=true, disconnectVoice=true
await player.skip();
await player.seek(30_000);
await player.setEndTime(60_000);
await player.setVolume(250);   // clamped 0–1000

const result = await player.search("ytsearch:daft punk harder", "ytsearch");
if (result.loadType === "playlist") {
  await player.addMany(result.tracks);
} else if (result.loadType === "search" || result.loadType === "track") {
  await player.play(result.tracks[0]);
}

// Or shortcut:
await player.searchAndPlay("https://youtu.be/...");

player.add(track);
player.addMany(tracks);
player.insert(0, track);
player.remove(2);
player.moveQueue(0, 3);
player.shuffleQueue();
player.removeDuplicateTracks();
player.clearQueue();
player.getQueue();      // array

const previous = await player.previous();
await player.rewindTrack();

player.repeatTrack(true);     // auto-disables repeatQueue
player.repeatQueue(true);     // auto-disables repeatTrack