How navosx/byte works
Byte is a Discord server bot. Its main workflow is Discord events routed by the handler into message, slash-command, and member-join features: messages earn XP and may invoke Gemini chat; commands inspect levels or change color roles; joins receive roles and a welcome embed. Level data is stored in MongoDB and used for rank display and color eligibility. The graph preserves the README’s advertised media-chat and help capabilities. Edges reflect shown calls or README-described behavior; unsampled integrations are not inferred beyond those documented.
Main entry points: handler.js Event Handler · changeColor.js Color Command · levelSchema.js Level Record Model · main.js Message Router
Components 19
Discord Runtime
- Bot Startup
src/main.js - Ready Event
src/events/ready.js - Event Handler
src/handler.js - Message Router
src/events/messages/main.js - Command Router
src/events/commands/main.js
Community Features
- Welcome Flow
src/events/welcome.js - Color Command
src/events/commands/changeColor.js - Add Role
src/utils/addRole.js - Remove Role
src/utils/removeRole.js
Leveling
- XP Awarding
src/events/messages/giveXp.js - Rank Inspection
src/events/commands/inspectLevel.js - Level XP Formula
src/utils/calculateLevelXp.js - Level Fetch
src/utils/fetchDB.js - Level Record Model
src/models/levelSchema.js
AI Chat
- Gemini Chat
src/gemini/chat/main.js
External Services
- Discord Gateway
- MongoDB
- Gemini API
Other components
- Server Member
Connections 23
- Server Member → Discord Gateway: sends events
README.md - Discord Gateway → Event Handler: delivers events
src/handler.js - Bot Startup → Ready Event: starts
src/main.js - Ready Event → Event Handler: registers handlers
src/events/ready.js - Event Handler → Message Router: routes messages
src/handler.js - Event Handler → Command Router: routes commands
src/handler.js - Event Handler → Welcome Flow: routes joins
src/handler.js - Message Router → XP Awarding: awards XP
src/events/messages/main.js - Message Router → Gemini Chat: invokes on mention
src/events/messages/main.js - Command Router → Color Command: dispatches color
src/events/commands/main.js - Command Router → Rank Inspection: dispatches level
src/events/commands/main.js - Welcome Flow → Add Role: assigns roles
src/events/welcome.js - Color Command → Level Fetch: checks eligibility
src/events/commands/changeColor.js - Color Command → Remove Role: removes old color
src/events/commands/changeColor.js - Color Command → Add Role: assigns selected color
src/events/commands/changeColor.js - XP Awarding → Level XP Formula: checks threshold
src/events/messages/giveXp.js - Rank Inspection → Level XP Formula: calculates XP
src/events/commands/inspectLevel.js - XP Awarding → Level Record Model: reads and saves
src/events/messages/giveXp.js - Rank Inspection → Level Record Model: queries records
src/events/commands/inspectLevel.js - Level Fetch → Level Record Model: queries records
src/utils/fetchDB.js - Level Record Model → MongoDB: persists level data
README.md - Gemini Chat → Gemini API: generates responses
src/gemini/chat/main.js - Gemini Chat → Server Member: replies with text or media
src/gemini/chat/main.js