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 & ARCHITECTURE
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
