How developer-land/mm-utilities works
MM-Utilities is a Discord bot for the MM Gamer community. Members interact through slash commands and message components; the bot provides community utilities, ticketing, suggestions, self-roles, leveling and music. Its client dynamically loads handlers and routes Discord interactions, while Mongoose models hold ticket, leveling and other feature state. The README also lists a YouTube feed, but its implementation and wiring were not sampled, so that capability is shown without an asserted internal call path. Some feature links are documented capabilities rather than inspected handler calls.
Main entry points: Client.ts Extended client · interactionCreate.ts Interaction router · music.ts Music commands · leveling.ts Leveling and ranks
Components 23
Bot runtime
- Extended client
src/Structures/Client.ts - Bot entry point
src/index.ts - Interaction router
src/Events/Bot/interactionCreate.ts - Slash commands
src/Commands - Button handlers
src/Buttons
Community features
- Leveling and ranks
src/Commands/Staff/leveling.ts - Self roles
src/Commands/Staff/buttonrole.ts - AFK utilities
src/Models/Go/afk.ts - Info commands
src/Commands/Info - YouTube feed
src/Events
Support workflows
- Ticket workflow
src/Buttons/Ticket - Suggestions
src/Commands/Utilities/suggestions.ts - Reports and appeals
src/Commands/Utilities/report.ts
Music playback
- Music commands
src/Commands/Music/music.ts - Extended player
src/Structures/ExtendedPlayer.ts - Lavalink system
src/Systems/lavalink.ts
Persistence
- Mongoose models
src/Models - Ticket records
src/Models/Ticket/ticket.ts - Leveling records
src/Models/Leveling - Suggestion records
src/Models/Suggestion/suggestion.ts
Other components
- Discord member
- Discord platform
- MongoDB
Connections 24
- Discord member → Discord platform: uses
- Discord platform → Interaction router: sends interactions
src/Events/Bot/interactionCreate.ts - Bot entry point → Extended client: starts
src/index.ts - Extended client → Slash commands: loads handlers
src/Structures/Client.ts - Extended client → Button handlers: loads handlers
src/Structures/Client.ts - Interaction router → Slash commands: dispatches commands
src/Events/Bot/interactionCreate.ts - Interaction router → Button handlers: dispatches buttons
src/Events/Bot/interactionCreate.ts - Discord member → Leveling and ranks: uses
- Discord member → Self roles: uses
- Discord member → AFK utilities: uses
- Discord member → Info commands: requests information
- Discord member → YouTube feed: receives feed
- Discord member → Ticket workflow: opens and manages
- Discord member → Suggestions: submits
- Discord member → Reports and appeals: submits
- Discord member → Music commands: requests playback
- Music commands → Extended player: uses
src/Commands/Music/music.ts - Music commands → Lavalink system: controls playback
src/Commands/Music/music.ts - Lavalink system → Discord platform: sends voice payloads
src/Systems/lavalink.ts - Extended client → MongoDB: connects
src/Structures/Client.ts - Mongoose models → MongoDB: stores documents
- Ticket workflow → Ticket records: reads and writes
src/Buttons/Ticket/create_ticket.ts - Leveling and ranks → Leveling records: uses
src/Commands/Staff/leveling.ts - Suggestions → Suggestion records: persists suggestions