How pon1147/bot-klb works
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: df Delta Force commands · dfStatsSelect.handler.ts Stats interaction · popup.js DF Toolbox popup · df-claim-handler.ts Account linking
Components 28
Discord runtime
- Bot startup
src/index.ts - Command loader
src/handlers/command.handler.ts - Event handlers
src/events
Delta Force
- Delta Force commands
src/commands/df - Stats interaction
src/events/dfStatsSelect.handler.ts - Stats rendering
src/renderers/df-stats - Account linking
src/services/df-claim-handler.ts - Team finding
src/commands/df/team-find.handlers.ts - Daily codes
src/services/df-codes-scheduler.ts - Delta Force API
src/services/deltaforce.api.ts
Server features
- Container editor
src/commands/container - Container interaction routing
src/commands/container/container-routers.ts - Container rendering
src/utils/container.utils.ts - Welcome and booster
src/events - Server setup commands
src/commands/welcome/setup.command.ts
Persistence and services
- Guild settings service
src/services/settings.service.ts - Guild settings database
src/database/guild.settings.db.ts - Welcome database
src/database/welcome.database.ts - Account bindings
src/database/df-binding.db.ts - Claim codes
src/database/df-claim.db.ts - Legacy tokens
src/database/df.token.db.ts
Chrome extension
- DF Toolbox popup
garena-redeem-code/popup/popup.js - Background worker
garena-redeem-code/background/service-worker.js - Auth state engine
garena-redeem-code/content/auth-state-engine.js - Garena redemption
garena-redeem-code/content/redeem-engine.js - Discord link capture
garena-redeem-code/content/link-content.js
Other components
- Discord user
- Extension user
Connections 28
- Bot startup → Command loader: loads commands
src/index.ts - Bot startup → Event handlers: loads events
src/index.ts - Discord user → Delta Force commands: invokes slash commands
README.md - Discord user → Container editor: edits settings
README.md - Discord user → Server setup commands: configures server
README.md - Delta Force commands → Stats interaction: opens stats flow
README.md - Stats interaction → Account bindings: reads active binding
src/events/dfStatsSelect.handler.ts - Stats interaction → Legacy tokens: reads fallback token
src/events/dfStatsSelect.handler.ts - Stats interaction → Delta Force API: requests season data
src/events/dfStatsSelect.handler.ts - Stats interaction → Stats rendering: builds stats view
src/events/dfStatsSelect.handler.ts - Delta Force commands → Account linking: starts account link
README.md - Delta Force commands → Team finding: starts team search
README.md - Delta Force commands → Daily codes: configures code posts
README.md - Account linking → Claim codes: stores claim state
src/services/df-claim-handler.ts - Account linking → Account bindings: updates binding
src/services/df-claim-handler.ts - Account linking → Delta Force API: validates account
src/services/df-claim-handler.ts - Container editor → Container interaction routing: routes interactions
src/commands/container/container-routers.ts - Container interaction routing → Container rendering: builds error display
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
src/services/settings.service.ts - Bot startup → Welcome database: initializes database
src/index.ts - Extension user → DF Toolbox popup: uses toolbox
README.md - DF Toolbox popup → Background worker: dispatches extension work
- DF Toolbox popup → Auth state engine: tracks authentication
README.md - DF Toolbox popup → Garena redemption: redeems codes
README.md - DF Toolbox popup → Discord link capture: supports account linking
README.md