How tassiocarvalho/bot_marc works
bot_marc is a multifunction WhatsApp bot built on Baileys. WhatsApp events enter through the connection and event loader; incoming messages are filtered, enriched with common command functions, and dispatched to commands or group-moderation handlers, which reply or act through the WhatsApp socket. The product also includes administration, media/download and AI commands, games, and group-status features. The graph emphasizes this runtime path and the central internal services. Several command families and integrations are documented by the tree or README but were not sampled, so their internal call paths are not inferred.
Main entry points: member Member Commands · onMesssagesUpsert.js Message Events · connection.js Connection · loader.js Event Loader
Components 31
Runtime and Events
- Bot Entry
src/index.js - Connection
src/connection.js - Event Loader
src/loader.js - Message Events
src/middlewares/onMesssagesUpsert.js - Participant Events
src/middlewares/onGroupParticipantsUpdate.js - Command Dispatch
src/utils/dynamicCommand.js
Bot Commands
- Command Families
src/commands - Admin Commands
src/commands/admin - Member Commands
src/commands/member - Owner Commands
src/commands/owner
Group Moderation
- Message Moderation
src/middlewares/messageHandler.js - Middleware Policy
src/middlewares/index.js
Domain Services
- Download Queue
src/services/download-queue.js - Spider X API
src/services/spider-x-api.js - Sticker Processing
src/services/sticker.js - Pet Game
src/services/pet.js - Pet Artwork
src/services/pet-art.js - Group Status
src/services/groupStatus.js - Status Video
src/services/statusVideo.js - Rock Paper Scissors
src/services/rock-paper-scissors.js - Hangman
src/services/hangman.js - Tic Tac Toe
src/services/tic-tac-toe.js
Shared Foundation
- Command Context
src/utils/loadCommonFunctions.js - Local State
src/utils/database.js - Bot Configuration
src/config.js - Shared Utilities
src/utils/index.js - Message Envelope
src/utils/messageEnvelopeRegistry.js - Payment Detection
src/utils/paymentMessage.js - Session Error Handling
src/utils/badMacHandler.js
Other components
- External APIs
Connections 35
- Bot Entry → Connection: starts
src/index.js - Connection → WhatsApp: connects
src/connection.js - Connection → Event Loader: loads events
src/connection.js - Event Loader → Message Events: registers
src/loader.js - Message Events → Message Moderation: checks messages
src/middlewares/onMesssagesUpsert.js - Message Events → Participant Events: dispatches updates
src/middlewares/onMesssagesUpsert.js - Message Events → Command Context: builds context
src/middlewares/onMesssagesUpsert.js - Message Events → Command Dispatch: dispatches commands
src/middlewares/onMesssagesUpsert.js - Command Dispatch → Command Families: loads command
- Message Moderation → Local State: reads restrictions
src/middlewares/messageHandler.js - Message Moderation → Middleware Policy: checks admin
src/middlewares/messageHandler.js - Middleware Policy → Local State: reads prefix
src/middlewares/index.js - Message Moderation → Payment Detection: detects payments
src/middlewares/messageHandler.js - Message Events → Message Envelope: records envelope
src/middlewares/onMesssagesUpsert.js - Event Loader → Download Queue: connects queue
src/loader.js - Event Loader → Local State: loads queue state
src/loader.js - Event Loader → Session Error Handling: handles errors
src/loader.js - Connection → Session Error Handling: handles session errors
src/connection.js - Connection → Pet Game: prepares group folders
src/connection.js - Pet Game → Pet Artwork: uses artwork
src/services/pet.js - Participant Events → Local State: reads state
src/middlewares/onGroupParticipantsUpdate.js - Command Families → Admin Commands: contains
- Command Families → Member Commands: contains
- Command Families → Owner Commands: contains
- Admin Commands → Local State: uses group state
- Member Commands → Spider X API: uses API
src/commands/member/search/yt-search.js - Member Commands → Sticker Processing: uses stickers
src/commands/member/funny/pet.js - Member Commands → Rock Paper Scissors: supports games
- Member Commands → Hangman: supports games
- Member Commands → Tic Tac Toe: supports games
- Member Commands → Group Status: uses status
- Member Commands → Status Video: uses status video
- Command Dispatch → Shared Utilities: uses utilities
- Command Context → Bot Configuration: uses settings
src/utils/loadCommonFunctions.js - Spider X API → External APIs: calls API