MBot.py

Multipurpose collection of systems written from scratch for automation & moderation of chat communities. Used as Modmail on Dying Light's server.

Features

• Forum-based Modmail system forwarding communication between user direct messages and server moderation team's thread
• Logging
• Stream Log (based on presence)
• Infractions system with automated actions
• Info (about Discord objects (User, Role, Channel, Guild etc)
• Basic interacting as bot - (Say/React)
• Leaderboards
• Giveaways
• Reaction/Presence Roles
• Auto Moderation
• Ghostping detection
• Spoiler only channel
• Antiraid system (autokick)
• Database "Stash" for memes/rules etc
• Custom role for Nitro Users
• Tracking Chat/Voice/Presence activity
• Steam calculator
• Graphing (things like member join over time histograph)
• Auto dice roll in RPG channels
• Dynamic Voice Channel generation
• Voice & Text chat activity tracking
• Miscellaneous commands for random rolls (Dice roll, coinflip etc)
• Various converters (Like Morse Transaltor, Making text upsidedown or Currency Converter)
• Searching other APIs (Like Steam, UrbanDict or Word Definitions)
• Story conversation executor (Reads json or yaml file with story flow and responds to user accordingly)

Minigames

• Hangman game
• Wordle
• Halloween
• Reaction Hunt events
• Christmas

---

Running locally

Run once to generate secrets.ini, modify to suit your needs. Make sure to set intents in bot section to at least 1.

Docker Compose:

docker compose up -f .docker/docker-compose.yml

Docker

docker run -it Mmesek/MFramework \
    -v data:/app/data \
    -v bot:/app/bot \
    -v locale:/app/locale \

Manually

Install required packages

python -m pip install -r requirements.txt

Run

python -m MFramework bot