How lazaroagomez/beatdock works
BeatDock is a Discord music bot: users issue slash commands or interact with search/player controls, the bot validates requests and manages a Lavalink player and queue, then reports playback state in Discord. The graph preserves documented source support, autoplay, queue controls, filtering, lyrics, permissions, localization, and public-node fallback. Some subsystems are documented or indexed but not excerpted, so their internal links are omitted rather than inferred; optional external services are shown as integrations.
Main entry points: commands Slash commands · interactionCreate.js Interaction routing · PlayerController.js Player controller · searchNavigation.js Search navigation
Components 26
Discord interaction
- Slash commands
src/commands - Interaction routing
src/events/interactionCreate.js - Search navigation
src/interactions/searchNavigation.js - Filter navigation
src/interactions/filterNavigation.js - Role permissions
src/utils/permissionChecker.js - Query validation
src/utils/queryGuard.js - Search sessions
src/utils/searchSessions.js
Playback experience
- Queue controls
src/utils/PlayerActions.js - Player controller
src/utils/PlayerController.js - Playback commands
src/commands - Lyrics lookup
src/commands/lyrics.js - Playback embeds
src/utils/embeds.js - Track selection
src/utils/trackSelectMenu.js
Player runtime
- Autoplay
src/utils/autoplay.js - Player lifecycle
src/utils/playerLifecycle.js - Playback resilience
src/utils/playbackFailureTracker.js - Lavalink player
Lavalink connectivity
- Connection manager
src/utils/LavalinkConnectionManager.js - Public node provider
src/utils/PublicNodeProvider.js
Bot services
- Language manager
src/LanguageManager.js - Guild and voice events
src/events - Network safety
src/utils/networkGuard.js - Logging
src/utils/logger.js
Other components
- Discord user
- Discord platform
- Lavalink nodes
Connections 32
- Discord user → Discord platform: submits interactions
README.md - Discord platform → Interaction routing: routes interactions
src/events/interactionCreate.js - Interaction routing → Slash commands: dispatches commands
src/events/interactionCreate.js - Interaction routing → Search navigation: dispatches selections
src/events/interactionCreate.js - Interaction routing → Filter navigation: dispatches filters
src/events/interactionCreate.js - Interaction routing → Role permissions: checks access
src/events/interactionCreate.js - Slash commands → Query validation: validates queries
src/commands/play.js - Slash commands → Search sessions: stores results
src/commands/search.js - Search navigation → Search sessions: pages results
src/interactions/searchNavigation.js - Search navigation → Lavalink player: adds selected track
src/interactions/searchNavigation.js - Search navigation → Player controller: updates player UI
src/interactions/searchNavigation.js - Slash commands → Lavalink player: searches and plays
src/commands/play.js - Playback commands → Lavalink player: controls playback
- Slash commands → Queue controls: shuffles queue
src/commands/shuffle.js - Interaction routing → Queue controls: handles player actions
src/events/interactionCreate.js - Queue controls → Track selection: builds track choices
src/utils/PlayerActions.js - Player controller → Playback embeds: formats playback
src/utils/PlayerController.js - Player controller → Track selection: truncates track text
src/utils/PlayerController.js - Lyrics lookup → Lavalink player: reads current track
- Lavalink player → Autoplay: requests recommendations
- Lavalink player → Player lifecycle: drives cleanup
- Lavalink player → Playback resilience: records playback outcomes
- Connection manager → Lavalink nodes: connects and reconnects
src/utils/LavalinkConnectionManager.js - Connection manager → Public node provider: selects public node
src/utils/LavalinkConnectionManager.js - Public node provider → Lavalink nodes: fetches node list
src/utils/PublicNodeProvider.js - Lavalink player → Lavalink nodes: streams tracks
README.md - Query validation → Network safety: checks hosts
src/utils/queryGuard.js - Guild and voice events → Search sessions: cleans guild sessions
src/events/guildDelete.js - Guild and voice events → Player lifecycle: cleans player state
src/events/guildDelete.js - Discord platform → Player controller: displays player controls
src/utils/PlayerController.js - Slash commands → Language manager: localizes replies
- Player controller → Language manager: localizes embeds
src/utils/PlayerController.js