# pon1147/bot-klb architecture

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

- Interactive diagram: https://gitdiagram.com/pon1147/bot-klb
- Repository: https://github.com/pon1147/bot-klb

## Overview

KL BOT is a Discord bot for Delta Force servers, with a companion Chrome extension. The main user flow is a Discord slash command or interaction, routed to a feature handler, which may retrieve account/settings data and return a response. Major branches include Delta Force stats, linking and team-finding; configurable welcome, booster and container features; and extension-based code redemption and account linking. The source excerpts support only selected internal calls, so unsampled feature connections are omitted or marked unverified.

Main entry points: [`src/commands/df`](https://github.com/pon1147/bot-klb/tree/main/src/commands/df) (Delta Force commands), [`src/events/dfStatsSelect.handler.ts`](https://github.com/pon1147/bot-klb/blob/main/src/events/dfStatsSelect.handler.ts) (Stats interaction), [`garena-redeem-code/popup/popup.js`](https://github.com/pon1147/bot-klb/blob/main/garena-redeem-code/popup/popup.js) (DF Toolbox popup), [`src/services/df-claim-handler.ts`](https://github.com/pon1147/bot-klb/blob/main/src/services/df-claim-handler.ts) (Account linking)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Discord runtime"]
  node_bot_boot["Bot startup<br/>[index.ts]"]
  node_command_loader["Command loader<br/>[command.handler.ts]"]
  node_event_handlers["Event handlers"]
end

subgraph group_deltaforce["Delta Force"]
  node_df_commands["Delta Force commands"]
  node_df_stats["Stats interaction"]
  node_stats_view["Stats rendering"]
  node_df_link["Account linking"]
  node_df_team["Team finding"]
  node_df_codes["Daily codes"]
  node_df_api["Delta Force API<br/>[deltaforce.api.ts]"]
end

subgraph group_server["Server features"]
  node_container_editor["Container editor"]
  node_container_router["Container interaction routing"]
  node_container_builder["Container rendering<br/>[container.utils.ts]"]
  node_welcome_booster["Welcome and booster"]
  node_server_setup["Server setup commands<br/>[setup.command.ts]"]
end

subgraph group_storage["Persistence and services"]
  node_guild_settings["Guild settings service"]
  node_settings_db[("Guild settings database")]
  node_welcome_db[("Welcome database")]
  node_df_binding_db[("Account bindings<br/>[df-binding.db.ts]")]
  node_df_claim_db[("Claim codes<br/>[df-claim.db.ts]")]
  node_df_token_db[("Legacy tokens<br/>[df.token.db.ts]")]
end

subgraph group_extension["Chrome extension"]
  node_extension_popup["DF Toolbox popup<br/>[popup.js]"]
  node_extension_worker["Background worker<br/>[service-worker.js]"]
  node_auth_engine["Auth state engine"]
  node_redeem_engine["Garena redemption<br/>[redeem-engine.js]"]
  node_discord_link_capture["Discord link capture<br/>[link-content.js]"]
end

node_discord_user(("Discord user"))
node_extension_user(("Extension user"))

node_bot_boot -->|"loads commands"| node_command_loader
node_bot_boot -->|"loads events"| node_event_handlers
node_discord_user -.->|"invokes slash commands"| node_df_commands
node_discord_user -.->|"edits settings"| node_container_editor
node_discord_user -.->|"configures server"| node_server_setup
node_df_commands -.->|"opens stats flow"| node_df_stats
node_df_stats -->|"reads active binding"| node_df_binding_db
node_df_stats -->|"reads fallback token"| node_df_token_db
node_df_stats -->|"requests season data"| node_df_api
node_df_stats -->|"builds stats view"| node_stats_view
node_df_commands -.->|"starts account link"| node_df_link
node_df_commands -.->|"starts team search"| node_df_team
node_df_commands -.->|"configures code posts"| node_df_codes
node_df_link -->|"stores claim state"| node_df_claim_db
node_df_link -->|"updates binding"| node_df_binding_db
node_df_link -->|"validates account"| node_df_api
node_container_editor -->|"routes interactions"| node_container_router
node_container_router -->|"builds error display"| node_container_builder
node_container_router -.->|"handles save action"| node_guild_settings
node_server_setup -.->|"updates configuration"| node_guild_settings
node_welcome_booster -.->|"loads feature settings"| node_guild_settings
node_guild_settings -->|"loads and saves"| node_settings_db
node_bot_boot -->|"initializes database"| node_welcome_db
node_extension_user -.->|"uses toolbox"| node_extension_popup
node_extension_popup -.->|"dispatches extension work"| node_extension_worker
node_extension_popup -.->|"tracks authentication"| node_auth_engine
node_extension_popup -.->|"redeems codes"| node_redeem_engine
node_extension_popup -.->|"supports account linking"| node_discord_link_capture

click node_bot_boot "https://github.com/pon1147/bot-klb/blob/main/src/index.ts"
click node_command_loader "https://github.com/pon1147/bot-klb/blob/main/src/handlers/command.handler.ts"
click node_event_handlers "https://github.com/pon1147/bot-klb/tree/main/src/events"
click node_df_commands "https://github.com/pon1147/bot-klb/tree/main/src/commands/df"
click node_df_stats "https://github.com/pon1147/bot-klb/blob/main/src/events/dfStatsSelect.handler.ts"
click node_stats_view "https://github.com/pon1147/bot-klb/tree/main/src/renderers/df-stats"
click node_df_link "https://github.com/pon1147/bot-klb/blob/main/src/services/df-claim-handler.ts"
click node_df_team "https://github.com/pon1147/bot-klb/blob/main/src/commands/df/team-find.handlers.ts"
click node_df_codes "https://github.com/pon1147/bot-klb/blob/main/src/services/df-codes-scheduler.ts"
click node_df_api "https://github.com/pon1147/bot-klb/blob/main/src/services/deltaforce.api.ts"
click node_container_editor "https://github.com/pon1147/bot-klb/tree/main/src/commands/container"
click node_container_router "https://github.com/pon1147/bot-klb/blob/main/src/commands/container/container-routers.ts"
click node_container_builder "https://github.com/pon1147/bot-klb/blob/main/src/utils/container.utils.ts"
click node_welcome_booster "https://github.com/pon1147/bot-klb/tree/main/src/events"
click node_server_setup "https://github.com/pon1147/bot-klb/blob/main/src/commands/welcome/setup.command.ts"
click node_guild_settings "https://github.com/pon1147/bot-klb/blob/main/src/services/settings.service.ts"
click node_settings_db "https://github.com/pon1147/bot-klb/blob/main/src/database/guild.settings.db.ts"
click node_welcome_db "https://github.com/pon1147/bot-klb/blob/main/src/database/welcome.database.ts"
click node_df_binding_db "https://github.com/pon1147/bot-klb/blob/main/src/database/df-binding.db.ts"
click node_df_claim_db "https://github.com/pon1147/bot-klb/blob/main/src/database/df-claim.db.ts"
click node_df_token_db "https://github.com/pon1147/bot-klb/blob/main/src/database/df.token.db.ts"
click node_extension_popup "https://github.com/pon1147/bot-klb/blob/main/garena-redeem-code/popup/popup.js"
click node_extension_worker "https://github.com/pon1147/bot-klb/blob/main/garena-redeem-code/background/service-worker.js"
click node_auth_engine "https://github.com/pon1147/bot-klb/blob/main/garena-redeem-code/content/auth-state-engine.js"
click node_redeem_engine "https://github.com/pon1147/bot-klb/blob/main/garena-redeem-code/content/redeem-engine.js"
click node_discord_link_capture "https://github.com/pon1147/bot-klb/blob/main/garena-redeem-code/content/link-content.js"

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_bot_boot,node_command_loader,node_event_handlers,node_discord_user,node_extension_user toneBlue
class node_df_commands,node_df_stats,node_stats_view,node_df_link,node_df_team,node_df_codes,node_df_api toneAmber
class node_container_editor,node_container_router,node_container_builder,node_welcome_booster,node_server_setup toneMint
class node_guild_settings,node_settings_db,node_welcome_db,node_df_binding_db,node_df_claim_db,node_df_token_db toneRose
class node_extension_popup,node_extension_worker,node_auth_engine,node_redeem_engine,node_discord_link_capture toneIndigo
```

## Components

### Discord runtime

- [Bot startup](https://github.com/pon1147/bot-klb/blob/main/src/index.ts): `src/index.ts`
- [Command loader](https://github.com/pon1147/bot-klb/blob/main/src/handlers/command.handler.ts): `src/handlers/command.handler.ts`
- [Event handlers](https://github.com/pon1147/bot-klb/tree/main/src/events): `src/events`

### Delta Force

- [Delta Force commands](https://github.com/pon1147/bot-klb/tree/main/src/commands/df): `src/commands/df`
- [Stats interaction](https://github.com/pon1147/bot-klb/blob/main/src/events/dfStatsSelect.handler.ts): `src/events/dfStatsSelect.handler.ts`
- [Stats rendering](https://github.com/pon1147/bot-klb/tree/main/src/renderers/df-stats): `src/renderers/df-stats`
- [Account linking](https://github.com/pon1147/bot-klb/blob/main/src/services/df-claim-handler.ts): `src/services/df-claim-handler.ts`
- [Team finding](https://github.com/pon1147/bot-klb/blob/main/src/commands/df/team-find.handlers.ts): `src/commands/df/team-find.handlers.ts`
- [Daily codes](https://github.com/pon1147/bot-klb/blob/main/src/services/df-codes-scheduler.ts): `src/services/df-codes-scheduler.ts`
- [Delta Force API](https://github.com/pon1147/bot-klb/blob/main/src/services/deltaforce.api.ts): `src/services/deltaforce.api.ts`

### Server features

- [Container editor](https://github.com/pon1147/bot-klb/tree/main/src/commands/container): `src/commands/container`
- [Container interaction routing](https://github.com/pon1147/bot-klb/blob/main/src/commands/container/container-routers.ts): `src/commands/container/container-routers.ts`
- [Container rendering](https://github.com/pon1147/bot-klb/blob/main/src/utils/container.utils.ts): `src/utils/container.utils.ts`
- [Welcome and booster](https://github.com/pon1147/bot-klb/tree/main/src/events): `src/events`
- [Server setup commands](https://github.com/pon1147/bot-klb/blob/main/src/commands/welcome/setup.command.ts): `src/commands/welcome/setup.command.ts`

### Persistence and services

- [Guild settings service](https://github.com/pon1147/bot-klb/blob/main/src/services/settings.service.ts): `src/services/settings.service.ts`
- [Guild settings database](https://github.com/pon1147/bot-klb/blob/main/src/database/guild.settings.db.ts): `src/database/guild.settings.db.ts`
- [Welcome database](https://github.com/pon1147/bot-klb/blob/main/src/database/welcome.database.ts): `src/database/welcome.database.ts`
- [Account bindings](https://github.com/pon1147/bot-klb/blob/main/src/database/df-binding.db.ts): `src/database/df-binding.db.ts`
- [Claim codes](https://github.com/pon1147/bot-klb/blob/main/src/database/df-claim.db.ts): `src/database/df-claim.db.ts`
- [Legacy tokens](https://github.com/pon1147/bot-klb/blob/main/src/database/df.token.db.ts): `src/database/df.token.db.ts`

### Chrome extension

- [DF Toolbox popup](https://github.com/pon1147/bot-klb/blob/main/garena-redeem-code/popup/popup.js): `garena-redeem-code/popup/popup.js`
- [Background worker](https://github.com/pon1147/bot-klb/blob/main/garena-redeem-code/background/service-worker.js): `garena-redeem-code/background/service-worker.js`
- [Auth state engine](https://github.com/pon1147/bot-klb/blob/main/garena-redeem-code/content/auth-state-engine.js): `garena-redeem-code/content/auth-state-engine.js`
- [Garena redemption](https://github.com/pon1147/bot-klb/blob/main/garena-redeem-code/content/redeem-engine.js): `garena-redeem-code/content/redeem-engine.js`
- [Discord link capture](https://github.com/pon1147/bot-klb/blob/main/garena-redeem-code/content/link-content.js): `garena-redeem-code/content/link-content.js`

### Other components

- **Discord user**
- **Extension user**

## Connections

- Bot startup → Command loader: loads commands (evidence: `src/index.ts`)
- Bot startup → Event handlers: loads events (evidence: `src/index.ts`)
- Discord user → Delta Force commands: invokes slash commands (evidence: `README.md`)
- Discord user → Container editor: edits settings (evidence: `README.md`)
- Discord user → Server setup commands: configures server (evidence: `README.md`)
- Delta Force commands → Stats interaction: opens stats flow (evidence: `README.md`)
- Stats interaction → Account bindings: reads active binding (evidence: `src/events/dfStatsSelect.handler.ts`)
- Stats interaction → Legacy tokens: reads fallback token (evidence: `src/events/dfStatsSelect.handler.ts`)
- Stats interaction → Delta Force API: requests season data (evidence: `src/events/dfStatsSelect.handler.ts`)
- Stats interaction → Stats rendering: builds stats view (evidence: `src/events/dfStatsSelect.handler.ts`)
- Delta Force commands → Account linking: starts account link (evidence: `README.md`)
- Delta Force commands → Team finding: starts team search (evidence: `README.md`)
- Delta Force commands → Daily codes: configures code posts (evidence: `README.md`)
- Account linking → Claim codes: stores claim state (evidence: `src/services/df-claim-handler.ts`)
- Account linking → Account bindings: updates binding (evidence: `src/services/df-claim-handler.ts`)
- Account linking → Delta Force API: validates account (evidence: `src/services/df-claim-handler.ts`)
- Container editor → Container interaction routing: routes interactions (evidence: `src/commands/container/container-routers.ts`)
- Container interaction routing → Container rendering: builds error display (evidence: `src/commands/container/container-routers.ts`)
- Container interaction routing → Guild settings service: handles save action
- Server setup commands → Guild settings service: updates configuration
- Welcome and booster → Guild settings service: loads feature settings
- Guild settings service → Guild settings database: loads and saves (evidence: `src/services/settings.service.ts`)
- Bot startup → Welcome database: initializes database (evidence: `src/index.ts`)
- Extension user → DF Toolbox popup: uses toolbox (evidence: `README.md`)
- DF Toolbox popup → Background worker: dispatches extension work
- DF Toolbox popup → Auth state engine: tracks authentication (evidence: `README.md`)
- DF Toolbox popup → Garena redemption: redeems codes (evidence: `README.md`)
- DF Toolbox popup → Discord link capture: supports account linking (evidence: `README.md`)
