How freycikkk/invitron works
Invitron is a Discord bot for tracking server invitations and administering invite-related settings. The main workflow is: Discord interactions or member-join events enter the bot, commands/components handle configuration and invite management, and database-backed state supports tracking, leaderboard and role features. The README also documents fraud detection and manual invite adjustments; those feature areas are represented, though their internal call paths were not sampled. Edges are limited to relationships visible in excerpts or explicitly documented; unsampled subsystem links are omitted.
Main entry points: Sqlite.ts Database adapter · client.ts Discord client · loader.ts Module loader · GuildMemberAdd.ts Member-join tracking
Components 19
Bot Runtime
- Shard manager
src/index.ts - Discord client
src/client.ts - Module loader
src/utils/loader.ts - Interaction router
src/events/interaction/InteractionCreate.ts
Invite Tracking
- Member-join tracking
src/events/guild/member/GuildMemberAdd.ts - Invite lifecycle events
src/events/invite - Fraud detection
src/events/guild/member/GuildMemberAdd.ts
Commands and Setup
- Invite management
src/commands/commons/Invites.ts - Invite leaderboard
src/commands/commons/Leaderboard.ts - Guild administration
src/commands/admins - Setup command
src/commands/utils/Setup.ts - Setup interface
src/components/utils/Setup.ts - Component base
src/components/Component.ts - Command base
src/commands/Command.ts
Persistence and Utilities
- Database adapter
src/database/Sqlite.ts - MySQL adapter
src/database/MySql.ts - Invite cache and roles
src/utils/ClientUtils.ts - Bot configuration
src/config.ts
Other components
- Discord users and servers
Connections 22
- Discord users and servers → Shard manager: starts bot
src/index.ts - Shard manager → Discord client: spawns shards
src/index.ts - Discord client → Database adapter: connects when SQLite
src/client.ts - Discord client → MySQL adapter: connects when MySQL
src/client.ts - Discord client → Bot configuration: loads
src/client.ts - Discord client → Module loader: loads modules
src/client.ts - Module loader → Command base: instantiates
src/utils/loader.ts - Module loader → Component base: instantiates
src/utils/loader.ts - Module loader → Interaction router: registers listeners
- Discord users and servers → Interaction router: sends interactions
src/events/interaction/InteractionCreate.ts - Interaction router → Command base: dispatches commands
src/events/interaction/InteractionCreate.ts - Interaction router → Component base: dispatches components
src/events/interaction/InteractionCreate.ts - Discord users and servers → Member-join tracking: joins server
src/events/guild/member/GuildMemberAdd.ts - Member-join tracking → Database adapter: reads and writes
src/events/guild/member/GuildMemberAdd.ts - Member-join tracking → Invite cache and roles: updates inviter role
src/events/guild/member/GuildMemberAdd.ts - Member-join tracking → Fraud detection: checks join
src/events/guild/member/GuildMemberAdd.ts - Invite management → Database adapter: manages invite data
- Invite leaderboard → Database adapter: reads rankings
- Guild administration → Database adapter: changes settings
- Setup command → Setup interface: opens setup flow
- Setup interface → Database adapter: saves configuration
- Invite lifecycle events → Invite cache and roles: refreshes invite state