A clean, modern Discord bot template built with discord.py.
- Modern Command Structure: Using both traditional prefix commands and slash commands
- Organized Codebase: Modular design with cogs for easy expansion
- Ready for Development: Example commands and utilities included
- Configuration System: Simple JSON-based configuration
- Python 3.11+
- discord.py 2.5.0+
- Dependencies listed in
requirements.txt
- Fork this repository
- Install dependencies:
pip install -r requirements.txt
- Copy
.env.exampleto.envand update with your bot token:cp .env.example .env
- Edit
.envwith your Discord Bot Token and preferred prefix - Copy
.config.json.exampleto.config.jsonand update with your Discord User ID:cp .config.json.example config.json
- Edit
config.jsonwith your Discord User ID
The config.json file contains the following settings:
owner_ids: Your Discord user ID (for owner-only commands)prefix: Command prefix for traditional commands (e.g., "!")version: Version of your bot (if you want to track the version with Discord commands maybe?)
The .env file contains the following values:
TOKEN: Your Discord bot token, never share it, never show it, strictly keep it for yourself.
Run the bot with:
python main.pyDiscord-Bot/
├── cogs/ # Command modules
├── utils/ # Utility functions
├── main.py # Bot entry point
├── config.json # Bot configuration
├── .env # Sensitive information (Bot token)
└── README.md # This file
Caution
Never give your bot token to anyone. Never show your .env file on a screenshot or screenshare.
This project is licensed under the MIT License - see the LICENSE file for details.