a comprehensive Discord bot with staff check-in system, moderation tools, anti-raiding features, music system, and utility commands.

DISCLAIMER!

some of the code is ai assisted (or as i like to call it, vibe-coded). it is not entirely built with ai and was debugged and built humanely using my own, self-hosted ai service. this is an old project i made a good while back when i was learning and will likely no longer be updated, you're welcome to do your own thing with it and remove whatever ai code you want. i dislike ai in coding but i also recognize that it is a great learning tool, and as such, it must be treated like so.

features

staff management
moderation & safety
anti-raid & recovery
music integration
automated engagement
advanced logging
utilities

commands

moderation: mute, unmute, ban, unban, kick, warn, warnings, clearwarns, purge, slowmode, lock, unlock, nick, modlogs
anti-raid: snapshot, restore, autobackup, listsnapshots, deletesnapshot
music: join, leave, play, search, skip, stop, pause, resume, queue, nowplaying, volume
utilities: help, ping, uptime, serverinfo, userinfo, avatar, poll, remind, say, embed
configuration: set_welcome_channel, set_goodbye_channel, set_autorole, set_log_channel

installation

prerequisites

- python 3.8+
- ffmp(r)eg (system dependency for music)
- discord.py[voice]
- cryptography
- yt-dlp
- ffmpeg-python
- PyNaCl
- aiohttp

guide

1. install ffmpeg on your system (required for music)
2. install python dependencies: pip install -r requirements.txt
3. run the bot once to generate keys: python bot.py
4. set up your encrypted token: python update_config.py
5. run the bot: python bot.py

configuration

the bot uses config.py by default for configuration. set your token in:
ENCRYPTED_TOKEN = "your_encrypted_token"

architecture

the bot uses discord.py's cog feature to divide work done by parts:
- config,py
- database.py
- utils.py
- cogs/checkin.py
- cogs/moderation.py
- cogs/antiraid.py
- cogs/music.py
- cogs/utils.py

direct code download link