• Ticket System - Automated support tickets for Plex and TV services
• Plex Integration - Automatic user management and library sharing
• Ko-fi Webhooks - Real-time donation notifications with multi-language support
• Captcha Verification - Secure member verification system
• Moderation Tools - Comprehensive server management commands
• Custom Logos & Embeds - Branded channel setup and server customization
• Slash & Prefix Commands - Modern slash commands with legacy prefix support
• Web Dashboard - Comprehensive web interface for bot management and monitoring

The bot includes a modern, mobile-responsive web dashboard with the following features:

• Real-time Bot Monitoring - Live bot status, uptime, and system statistics with auto-refresh
• Ticket Management - View, search, filter, and manage support tickets
• Database Browser - Explore and query SQLite databases with hierarchical navigation
• Invite Tracking - Monitor server invites and usage analytics
• Settings Management - Configure bot settings through an intuitive interface
• Service Status - Monitor Plex and other integrated services
• About Page - Bot information, version tracking, and system details

• Dark Theme - Modern dark interface optimized for readability
• Mobile Responsive - Fully functional on desktop, tablet, and mobile devices
• Auto Version Checking - Automatic GitHub release version comparison
• Advanced Search - Filter and search across all data views
• Live Updates - Real-time dashboard updates without page refresh
• Database Tools - Query executor and schema viewer for database management

The dashboard is accessible at http://your-server:5000 once the bot is running. The web interface runs alongside the Discord bot automatically.

• Python 3.12+
• Discord Bot Token
• (Optional) Plex Media Server
• (Optional) Ko-fi account for donations

1. Clone the repository:

git clone https://github.com/cyb3rgh05t/discord-bot.git
cd discord-bot

2. Configure settings:

cp config/settings.py.example config/settings.py

Edit config/settings.py with your configuration.

3. Run with Docker Compose:

docker-compose up -d

1. Clone the repository:

git clone https://github.com/cyb3rgh05t/discord-bot.git
cd discord-bot

2. Create a virtual environment:

python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

3. Install dependencies:

pip install -r requirements.txt

4. Configure settings:

cp config/settings.py.example config/settings.py

Edit config/settings.py with your configuration.

5. Run the bot:

python bot.py

Edit config/settings.py with the following required values:

BOT_TOKEN = "your_discord_bot_token"
GUILD_ID = "your_server_id"
COMMAND_PREFIX = "!"  # Default command prefix

PLEX_ENABLED = True
PLEX_TOKEN = "your_plex_token"
PLEX_BASE_URL = "http://your-plex-server:32400"
PLEX_SERVER_NAME = "Your Server Name"
PLEX_ROLES = "member"  # Roles eligible for Plex access
PLEX_LIBS = "all"  # Libraries to share

KOFI_WEBHOOK_PORT = 3033
KOFI_VERIFICATION_TOKEN = "your_kofi_verification_token"
KOFI_CHANNEL_ID = 123456789012345678
KOFI_NAME = "Your Ko-fi Name"
KOFI_LANGUAGE = "en"  # Supported: 'en', 'de', 'fr'

WELCOME_CHANNEL_ID = 123456789012345678
SYSTEM_CHANNEL_ID = 123456789012345678
TICKET_CATEGORY_ID = 123456789012345678
RULES_CHANNEL_ID = 123456789012345678

UNVERIFIED_ROLE = "unverified"
VERIFIED_ROLE = "verified"
MEMBER_ROLE = "member"
STAFF_ROLE = "staff"

• /ping - Check bot latency
• /kick - Kick a member (requires permissions)
• /plex - Plex management commands
• /ticket - Create support tickets

Moderation:

• !verify - Setup verification system
• !rules - Manage server rules
• !channels - Channel management

Logos & Branding:

• !welcome - Set welcome channel logo
• !plex - Set Plex channel logo
• !donate - Set donation channel logo

1. Configure Ko-fi settings in config/settings.py
2. Start the bot (webhook server runs on configured port)
3. In your Ko-fi settings, add webhook URL:

   http://your-server-ip:3033/kofi-webhook
   

4. Set the verification token in both Ko-fi and your config

The bot will post donation notifications to the configured channel with:

• Donor information
• Amount and type (one-time/subscription)
• Custom message support
• Multi-language support (EN, DE, FR)

The bot includes full Docker support with:

• Multi-stage builds for efficiency
• Python 3.14 slim base image
• Automatic restart policies
• Volume mounts for persistent data
• Integrated web dashboard on port 5000

The Docker container includes:

• Discord bot functionality
• Web dashboard server
• Database persistence
• Automatic version tracking
• Log file management

# Build and run
docker-compose up -d

# View logs
docker-compose logs -f

# Stop bot
docker-compose down

# Access web dashboard
# Navigate to http://localhost:5000 in your browser

• Port 5000 - Web Dashboard (HTTP)
• Port 3033 - Ko-fi Webhook (if enabled)

Make sure these ports are exposed in your docker-compose.yml:

ports:
  - "5000:5000" # Web Dashboard
  - "3033:3033" # Ko-fi Webhook (optional)

Logs are stored in the logs/ directory with configurable levels:

• DEBUG - Detailed debugging information
• INFO - General informational messages
• WARNING - Warning messages
• ERROR - Error messages
• CRITICAL - Critical issues

Set logging level in config/settings.py:

LOGGING_LEVEL = "INFO"
LOG_FILE = "logs/bot.log"

This project is licensed under the MIT License - see the LICENSE file for details.

For issues, questions, or contributions, please open an issue on GitHub.