JohnnyBot does all of the stuff Discord bizarrely won't let you do! Designed to automate tons of server management and enforce some rules while you're at it. It provides features such as automatic role assignment, message deletion, and user management to ensure a smooth server experience. Most commands are limited to users with the MODERATOR_ROLE_NAME, however the PetBot commands can be leveraged by all users.
For complete documentation, installation guides, and command references, visit the JohnnyBot Wiki.
- Wiki Home - Project overview and features
- Setup Guide - Complete installation and configuration
- Commands Reference - All available commands with examples
- Command-based Moderation - Slash commands for member and message management
- Voice Channel Chaperone - Automatic safety monitoring for voice channels
- Reminder System - Recurring reminders with persistent scheduling
- Event Feed Integration - Calendar feed notifications and Discord events
- Message Archive - User message dumps with temporary download links
- Channel Write Protection - Enforce read-only channels
- PetBot Interactions - Fun bot interactions for all users
-
Clone and Install:
git clone https://github.com/burbsec/johnnybot.git cd johnnybot pip install -r requirements.txt -
Configure: Edit
config.pywith your server settings -
Set Token: Add your Discord bot token as environment variable:
export DISCORD_BOT_TOKEN="your_bot_token_here"
-
Run:
python bot.py
Need help? Check the Setup Guide for detailed instructions.
- Python 3.7+ (tested up to 3.13)
- Dependencies: Listed in
requirements.txt - Network: TCP port 80 access for message archive hosting
Contributions are welcome! If you encounter any bugs or have suggestions, feel free to open an issue or submit a pull request.
For detailed development information, see the Wiki.
This project is licensed under the GNU General Public License v3.0.
Attribution: Bot interaction functionality adapted from PetBot under MIT License.