# kavibalan1904/resobott architecture

> Architecture diagram of the GitHub repository kavibalan1904/resobott, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kavibalan1904/resobott
- Repository: https://github.com/kavibalan1904/resobott

## Overview

Reso is a Discord music bot: users issue slash commands or player-button interactions, commands search and queue audio through Lavalink, and player events update playback messages and handle queue transitions. The map preserves the documented playback, queue, discovery, audio-control, and utility capabilities. Several command implementations and startup/event wiring are unsampled, so those broader subsystem links are shown only where the excerpts or README support them.

Main entry points: [`src/index.js`](https://github.com/kavibalan1904/resobott/blob/main/src/index.js) (Bot startup), [`src/commands/music`](https://github.com/kavibalan1904/resobott/tree/main/src/commands/music) (Music commands), [`src/handlers/playerEvents.js`](https://github.com/kavibalan1904/resobott/blob/main/src/handlers/playerEvents.js) (Player events), [`src/utils/embeds.js`](https://github.com/kavibalan1904/resobott/blob/main/src/utils/embeds.js) (Embeds and controls)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Bot runtime"]
  node_launcher["Process entry<br/>[index.js]"]
  node_app["Bot startup<br/>[index.js]"]
  node_commands["Slash command loader<br/>[commandHandler.js]"]
  node_events["Player events<br/>[playerEvents.js]"]
  node_utility["Utility commands"]
end

subgraph group_playback["Playback and queue"]
  node_music["Music commands"]
  node_play["Play and playlists<br/>[play.js]"]
  node_playnext["Priority queueing<br/>[playnext.js]"]
  node_queue["Queue controls"]
  node_controls["Playback controls"]
  node_buttons["Player buttons<br/>[buttonHandler.js]"]
end

subgraph group_discovery["Discovery and audio"]
  node_search["Search selection<br/>[search.js]"]
  node_filter["Audio filters<br/>[filter.js]"]
  node_recommend["Recommendations<br/>[recommendations.js]"]
  node_recommendcmd["Recommendation command<br/>[recommend.js]"]
  node_lyrics["Lyrics lookup<br/>[lyrics.js]"]
end

subgraph group_presentation["Interaction and presentation"]
  node_embeds["Embeds and controls<br/>[embeds.js]"]
  node_helpers["Playback helpers<br/>[helpers.js]"]
end

node_user(("Discord user"))
node_discord["Discord API"]
node_lavalink["Lavalink nodes"]
node_genius["Genius lyrics"]

node_launcher -->|"loads"| node_app
node_app -->|"loads commands"| node_commands
node_app -->|"sets up events"| node_events
node_app -->|"routes buttons"| node_buttons
node_commands -->|"loads commands"| node_music
node_user -.->|"interacts"| node_app
node_user -->|"issues commands"| node_music
node_user -->|"selects controls"| node_buttons
node_play -->|"searches and queues"| node_lavalink
node_playnext -->|"queues next"| node_lavalink
node_search -->|"searches tracks"| node_lavalink
node_music -.->|"manages queue"| node_queue
node_music -.->|"controls playback"| node_controls
node_filter -->|"updates filters"| node_lavalink
node_recommendcmd -->|"requests tracks"| node_recommend
node_events -->|"gets autoplay track"| node_recommend
node_events -->|"handles player events"| node_lavalink
node_lyrics -.->|"searches lyrics"| node_genius
node_buttons -->|"builds responses"| node_embeds
node_events -->|"builds player messages"| node_embeds
node_music -.->|"formats responses"| node_embeds
node_play -->|"uses utilities"| node_helpers
node_search -->|"uses utilities"| node_helpers
node_utility -.->|"formats responses"| node_embeds
node_lavalink -.->|"streams to voice"| node_discord

click node_launcher "https://github.com/kavibalan1904/resobott/blob/main/index.js"
click node_app "https://github.com/kavibalan1904/resobott/blob/main/src/index.js"
click node_commands "https://github.com/kavibalan1904/resobott/blob/main/src/handlers/commandHandler.js"
click node_music "https://github.com/kavibalan1904/resobott/tree/main/src/commands/music"
click node_play "https://github.com/kavibalan1904/resobott/blob/main/src/commands/music/play.js"
click node_playnext "https://github.com/kavibalan1904/resobott/blob/main/src/commands/music/playnext.js"
click node_search "https://github.com/kavibalan1904/resobott/blob/main/src/commands/music/search.js"
click node_queue "https://github.com/kavibalan1904/resobott/tree/main/src/commands/music"
click node_controls "https://github.com/kavibalan1904/resobott/tree/main/src/commands/music"
click node_filter "https://github.com/kavibalan1904/resobott/blob/main/src/commands/music/filter.js"
click node_recommend "https://github.com/kavibalan1904/resobott/blob/main/src/utils/recommendations.js"
click node_recommendcmd "https://github.com/kavibalan1904/resobott/blob/main/src/commands/music/recommend.js"
click node_lyrics "https://github.com/kavibalan1904/resobott/blob/main/src/commands/music/lyrics.js"
click node_buttons "https://github.com/kavibalan1904/resobott/blob/main/src/handlers/buttonHandler.js"
click node_events "https://github.com/kavibalan1904/resobott/blob/main/src/handlers/playerEvents.js"
click node_embeds "https://github.com/kavibalan1904/resobott/blob/main/src/utils/embeds.js"
click node_helpers "https://github.com/kavibalan1904/resobott/blob/main/src/utils/helpers.js"
click node_utility "https://github.com/kavibalan1904/resobott/tree/main/src/commands/utility"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_launcher,node_app,node_commands,node_events,node_utility,node_user toneBlue
class node_music,node_play,node_playnext,node_queue,node_controls,node_buttons toneAmber
class node_search,node_filter,node_recommend,node_recommendcmd,node_lyrics,node_discord toneMint
class node_embeds,node_helpers toneRose
class node_lavalink,node_genius toneIndigo
```

## Components

### Bot runtime

- [Process entry](https://github.com/kavibalan1904/resobott/blob/main/index.js): `index.js`
- [Bot startup](https://github.com/kavibalan1904/resobott/blob/main/src/index.js): `src/index.js`
- [Slash command loader](https://github.com/kavibalan1904/resobott/blob/main/src/handlers/commandHandler.js): `src/handlers/commandHandler.js`
- [Player events](https://github.com/kavibalan1904/resobott/blob/main/src/handlers/playerEvents.js): `src/handlers/playerEvents.js`
- [Utility commands](https://github.com/kavibalan1904/resobott/tree/main/src/commands/utility): `src/commands/utility`

### Playback and queue

- [Music commands](https://github.com/kavibalan1904/resobott/tree/main/src/commands/music): `src/commands/music`
- [Play and playlists](https://github.com/kavibalan1904/resobott/blob/main/src/commands/music/play.js): `src/commands/music/play.js`
- [Priority queueing](https://github.com/kavibalan1904/resobott/blob/main/src/commands/music/playnext.js): `src/commands/music/playnext.js`
- [Queue controls](https://github.com/kavibalan1904/resobott/tree/main/src/commands/music): `src/commands/music`
- [Playback controls](https://github.com/kavibalan1904/resobott/tree/main/src/commands/music): `src/commands/music`
- [Player buttons](https://github.com/kavibalan1904/resobott/blob/main/src/handlers/buttonHandler.js): `src/handlers/buttonHandler.js`

### Discovery and audio

- [Search selection](https://github.com/kavibalan1904/resobott/blob/main/src/commands/music/search.js): `src/commands/music/search.js`
- [Audio filters](https://github.com/kavibalan1904/resobott/blob/main/src/commands/music/filter.js): `src/commands/music/filter.js`
- [Recommendations](https://github.com/kavibalan1904/resobott/blob/main/src/utils/recommendations.js): `src/utils/recommendations.js`
- [Recommendation command](https://github.com/kavibalan1904/resobott/blob/main/src/commands/music/recommend.js): `src/commands/music/recommend.js`
- [Lyrics lookup](https://github.com/kavibalan1904/resobott/blob/main/src/commands/music/lyrics.js): `src/commands/music/lyrics.js`

### Interaction and presentation

- [Embeds and controls](https://github.com/kavibalan1904/resobott/blob/main/src/utils/embeds.js): `src/utils/embeds.js`
- [Playback helpers](https://github.com/kavibalan1904/resobott/blob/main/src/utils/helpers.js): `src/utils/helpers.js`

### Other components

- **Discord user**
- **Discord API**
- **Lavalink nodes**
- **Genius lyrics**

## Connections

- Process entry → Bot startup: loads (evidence: `index.js`)
- Bot startup → Slash command loader: loads commands (evidence: `src/index.js`)
- Bot startup → Player events: sets up events (evidence: `src/index.js`)
- Bot startup → Player buttons: routes buttons (evidence: `src/index.js`)
- Slash command loader → Music commands: loads commands (evidence: `src/handlers/commandHandler.js`)
- Discord user → Bot startup: interacts (evidence: `README.md`)
- Discord user → Music commands: issues commands (evidence: `README.md`)
- Discord user → Player buttons: selects controls (evidence: `README.md`)
- Play and playlists → Lavalink nodes: searches and queues (evidence: `src/commands/music/play.js`)
- Priority queueing → Lavalink nodes: queues next (evidence: `src/commands/music/playnext.js`)
- Search selection → Lavalink nodes: searches tracks (evidence: `src/commands/music/search.js`)
- Music commands → Queue controls: manages queue (evidence: `README.md`)
- Music commands → Playback controls: controls playback (evidence: `README.md`)
- Audio filters → Lavalink nodes: updates filters (evidence: `src/commands/music/filter.js`)
- Recommendation command → Recommendations: requests tracks (evidence: `src/commands/music/recommend.js`)
- Player events → Recommendations: gets autoplay track (evidence: `src/handlers/playerEvents.js`)
- Player events → Lavalink nodes: handles player events (evidence: `src/handlers/playerEvents.js`)
- Lyrics lookup → Genius lyrics: searches lyrics (evidence: `README.md`)
- Player buttons → Embeds and controls: builds responses (evidence: `src/handlers/buttonHandler.js`)
- Player events → Embeds and controls: builds player messages (evidence: `src/handlers/playerEvents.js`)
- Music commands → Embeds and controls: formats responses (evidence: `README.md`)
- Play and playlists → Playback helpers: uses utilities (evidence: `src/commands/music/play.js`)
- Search selection → Playback helpers: uses utilities (evidence: `src/commands/music/search.js`)
- Utility commands → Embeds and controls: formats responses (evidence: `README.md`)
- Lavalink nodes → Discord API: streams to voice (evidence: `README.md`)
