Blaze Isle Bot

A feature-rich Discord bot originally built for the Blaze Isle community.

Guild Setup

Automatic Setup Guidance

When the bot joins your server, the server owner automatically receives a welcome DM with complete setup instructions. No more guessing what needs to be configured!

Easy Configuration with Modals

The bot uses an intelligent configuration system that prevents crashes and guides you through setup. The modal-based /config command provides an intuitive interface for setting up all bot features with built-in validation.

#### Configuration Commands

• /config view - Displays the current settings for the server
• /config set - Opens an interactive interface with buttons for each setting

Advanced Features

Twitch Stream Notifications

The bot features a comprehensive Twitch integration system with real-time monitoring:

#### Management Commands (Mod/Admin only)

• /twitch add <username> - Subscribe to a Twitch channel for notifications
• /twitch remove <username> - Unsubscribe from a Twitch channel
• /twitch list - List all subscribed channels with who added them
• /twitch status <username> - Check a channel's current live status

#### Features

• Real-time monitoring: Checks streams every 1 minutes
• Smart notifications: Only notifies when streams go from offline to live
• Rich embeds: Stream notifications include title, game, viewer count, and thumbnail
• Database persistence: All subscriptions and stream states are stored in SQLite
• OAuth2 integration: Uses proper Twitch API authentication
• Error handling: Robust error handling for API failures and missing channels

Rules & Welcome System

• Automated role assignment: Users get the Members role when they react with ✅ to the rules
• Welcome messages: Sent to the configured welcome channel (not hardcoded to #general)
• Loyalty system integration: New members are automatically added to the XP system
• DM notifications: Users receive a private message confirming rule acceptance

Advanced Loyalty/XP System

The bot features a sophisticated leveling system designed to reward active community members:

#### Scaled Leveling Formula

• Exponential progression: Level requirements scale with formula level^2.5 * 100
• Progressive difficulty: Level 0 starts at 0 XP, Level 1 needs 100 XP, Level 2 needs 566 XP, Level 3 needs 1,548 XP
• Multi-level jumping: Users can gain multiple levels from large XP amounts
• Efficient calculation: Uses binary search algorithm for optimal performance

#### XP Sources & Rewards

• Chat activity: 1 XP per message for participating in conversations
• Game victories: 10-50 XP for winning games (RPS: 10 XP, TicTacToe/Connect4: 50 XP)
• Social interactions: 25 XP for hug and comfort commands
• Animal commands: 3 XP for cute animal picture commands (cat, dog, fox, bunny, duck)

#### Level Categories & Badges

• 🥚 Starting (Level 0): Brand new members (0-99 XP)
• 🌱 Newcomer (Levels 1-4): New community members
• 🥉 Bronze (Levels 5-14): Regular participants
• 🥈 Silver (Levels 15-29): Active community members
• 🏆 Gold (Levels 30-49): Dedicated contributors
• 💎 Diamond (Levels 50+): Elite community champions

#### Commands & Features

• /xp [user]: View your XP and progress with visual progress bar
• /level [user]: See detailed level information and category badge
• /leaderboard: Top 10 users with XP, levels, and badges
• Level-up notifications: Automatic announcements in dedicated loyalty channel (or welcome channel as fallback)
• Rich embeds: Beautiful displays with progress bars and statistic