LukBot Music & Queue

When to use

• •Changing play, queue, skip, pause, volume, autoplay, repeat, shuffle
• •Fixing track or queue display
• •Player lifecycle, errors, or extractors

Player access

• •Use useMainPlayer() from discord-player where the player is available (e.g. after client ready).
• •Play: player.play(voiceChannel, searchResult, { nodeOptions: { metadata } }). Search via player.search(query, { requestedBy }).

Command locations

• •Play: packages/bot/src/functions/music/commands/play/ — processor, queryDetector, queueManager, spotify/youtube handlers
• •Queue: packages/bot/src/functions/music/commands/queue/ — formatter, embed, grouping, stats
• •Control: packages/bot/src/functions/music/commands/ — skip, pause, resume, remove, clear, volume, repeat, shuffle, leave, stop

Handlers

• •Player: packages/bot/src/handlers/player/ — trackHandlers, errorHandlers, lifecycleHandlers, playerFactory
• •Events: packages/bot/src/handlers/player/trackHandlers.ts and related — wire player events to replies and history

Shared state

• •Track history and recommendations: use services from @lukbot/shared (e.g. TrackHistoryService, recommendation) when persisting; do not duplicate queue state in Redis/DB beyond what shared exposes.

Validations

• •Ensure user is in a voice channel; bot has join permissions. Use existing queue/voice validators before touching queue or player.