VDO.Ninja Discord Bot

A comprehensive Discord bot for the VDO.Ninja community, providing automated support, content updates, and community management features.

Features

Community Support

• Command System: Access helpful information through a collection of easily invokable commands
• Automatic Thread Creation: Organizes support requests into threads for better management
• AI-Powered Support: Bot can provide immediate answers to common questions using LLM integration
• Anti-Spam Protection: Detects and manages spam messages and inappropriate content

Content Management

• Update Channel: Posts from the Discord #update channel are automatically published to updates.vdo.ninja
• YouTube Monitoring: Automatically posts new videos from specified YouTube channels
• Reddit Integration: Posts new content from r/VDONinja subreddit

Administration

• Thread Management: Automatically creates, renames, and archives threads
• Support Staff Tools: Login/logout system for support staff to receive notifications

Installation

Prerequisites

• Python 3.8+
• pip3
• A server to host the bot (Linux recommended)

Basic Setup

# Clone the repository
git clone https://github.com/steveseguin/discordbot.git
cd discordbot

# Update and install dependencies
sudo apt-get update
sudo apt-get upgrade
sudo apt-get install python3 python3-pip
sudo pip3 install -r requirements.txt

# Configure the bot (see Configuration section)
cp NinjaBot/discordbot.sample.cfg NinjaBot/discordbot.cfg
nano NinjaBot/discordbot.cfg

# Run the bot
sudo python3 main.py

Configuration

The bot requires several API keys and configuration options. Copy the sample config file and edit with your credentials:

Discord Setup

1. Create a Discord application at Discord Developer Portal
2. Create a bot for your application
3. Generate an invite link with Administrator permissions
4. Invite the bot to your server
5. Copy the bot token to discordbot.cfg as discordBotToken

Reddit API (Optional)

1. Create an app on Reddit
2. Copy the client ID and client secret to discordbot.cfg as redditClientId and redditClientSecret

YouTube API (Optional)

1. Create a project in Google API Console
2. Enable the "YouTube Data API v3"
3. Create an API key
4. Add the key to discordbot.cfg as youtubeApiKey

Gitbook API (Optional)

1. Create an API token in Gitbook personal settings → developer settings
2. Add to discordbot.cfg as gitbookApiKey

Github API (Optional)

1. Create an API token in Github settings → Developer settings → Personal access tokens → Tokens (classic)
2. Add to discordbot.cfg as githubApiKey

AI Integration (Optional)

The bot supports multiple AI providers for enhanced support capabilities:

"ai": {
    "enabled": true,
    "service": "GEMINI",  // Options: OPENAI, GEMINI, OLLAMA
    "api_key": "YOUR_API_KEY",
    "model": "gemini-2.0-flash",  // Adjust based on service
    "temperature": 0.7,
    "max_tokens": 1000
}

Production Deployment

For production environments, it's recommended to set up the bot as a system service:

Create a systemd service

sudo nano /etc/systemd/system/discordbot.service

Add the following content:

[Unit]
Description=VDO.Ninja Discord Bot
After=network.target

[Service]
User=your-username
WorkingDirectory=/path/to/discordbot
ExecStart=/usr/bin/python3 main.py
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target

Enable and start the service:

sudo systemctl enable discordbot.service
sudo systemctl start discordbot.service

Docker Deployment (Alternative)

For containerized deployments, you can use Docker:

# Build the image
docker build -t vdoninja-discordbot .

# Run the container
docker run -d \
  --name vdoninja-bot \
  --restart unless-stopped \
  -v /path/to/config:/app/NinjaBot \
  vdoninja-discordbot

Updates Channel

The bot manages the updates.vdo.ninja website, which displays updates from the Discord #updates channel. Messages posted by allowed users in the specified updates channel are automatically processed and published.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

For small code contributions, simply submit a PR. For larger changes or new features, please get in touch with the maintainers first.