Codespace probable adventure 7qvjrr6vgwr2x4v5

.gitignore

@@ -0,0 +1,46 @@
+# Environment variables
+.env
+.env.local
+.env.*.local
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+env/
+venv/
+ENV/
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Results
+valid.txt
+taken.txt
+censored.txt
+error.txt
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db

CHANGELOG.md

@@ -0,0 +1,148 @@
+# Changelog - Username Sniper Bot
+
+All notable changes to this project will be documented in this file.
+
+## [0.5] - 2026-01-07
+
+### 🌟 VIP Membership Program
+
+#### New Features
+- **Text Hunt Mode** (VIP Exclusive)
+  - UNLIMITED 500-letter custom hunts
+  - Optimized for small username patterns
+  - No usage limits or cooldowns
+  - Instant availability between hunts
+
+- **Enhanced Hunt Quotas** (VIP Users)
+  - 10,000 hunts per 3-day cycle
+  - Automatic reset on schedule
+  - All platforms supported
+
+- **Official X API v2 Integration**
+  - Batch username checking (up to 100 usernames per request)
+  - VIP users: 100 requests/hour limit
+  - Official API endpoint (no IP bans)
+  - Automatic logging of available usernames
+  - 10x faster checking than single-request method
+
+- **Premium User Interface**
+  - Exclusive gold-themed design for VIP members
+  - Visual tier differentiation
+  - Enhanced feature descriptions
+  - Premium help documentation
+
+- **Improved Permission System**
+  - Role-based access control
+  - Multiple tier support
+  - Real-time limit validation
+
+### Improvements
+- Streamlined VIP onboarding experience
+- Faster cooldown cycles (3 days vs 7 days)
+- Enhanced user feedback and status information
+- Separated UI/UX for different user tiers
+- Comprehensive help system for each tier
+- Official API integration for efficient batch checking
+
+---
+
+## [0.4] - 2026-01-07
+
+### Added
+- 🎯 **Tiered Hunt Rate Limiting System**
+  - Multiple user tier support with different quota levels
+  - Automatic quota resets
+  - Role-based access control
+
+- 👑 **User Permission Tiers**
+  - Owner tier with premium access
+  - Whitelisted tier with elevated quotas
+  - Standard tier for regular users
+
+- 📊 **Hunt Limit Enforcement**
+  - Real-time validation before hunt starts
+  - User-friendly status messages
+  - Automatic cooldown tracking
+
+- 📈 **Enhanced User Feedback**
+  - Tier information in command responses
+  - Remaining quota display
+  - Clear cooldown countdowns
+
+- 🔔 **Improved Logging**
+  - Version information on startup
+  - Configuration summary
+  - System status reporting
+
+### Changed
+- Updated core hunt validation system
+- Improved tier detection and assignment
+- Enhanced error messaging
+- Better user status visibility
+- Updated help documentation
+
+---
+
+## [0.3] - Previous Release
+
+### Features
+- Multi-platform username availability checking
+  - Roblox, Twitter/X, GitHub, TikTok, Discord
+- Multiple pattern generation options
+- Real-time progress tracking with visual indicators
+- Flexible export formats for results
+- Discord-native interface with interactive components
+- Optimized API rate limiting
+- Concurrent request management
+
+---
+
+## Getting Started
+
+### Installation
+1. Install required dependencies from requirements.txt
+2. Configure your bot token in environment settings
+3. Start the bot and use `/snipe` to begin hunting
+
+### Basic Usage
+- Run `/snipe` to start a username hunt
+- Select your target platforms
+- Choose or create username patterns
+- Enter desired quantity (based on your tier)
+- Export results in preferred format
+
+### Command Reference
+- `/snipe` - Start a new hunt session
+- `/help` - View detailed feature information
+- Select from interactive menus for configuration
+
+---
+
+## Features
+
+### Core Capabilities
+- **Multi-Platform Support**: Check availability across major platforms
+- **Pattern Generation**: Create custom or use preset patterns
+- **Real-Time Progress**: Visual feedback during hunts
+- **Flexible Export**: Multiple export formats available
+
+### Tier Benefits
+- **Standard Tier**: Basic hunting capabilities with reasonable quotas
+- **VIP Tier**: Enhanced quotas and exclusive text hunt mode
+
+---
+
+## Performance & Reliability
+
+- Optimized API request handling
+- Rate limiting to prevent platform blocks
+- Automatic request batching
+- Concurrent user session management
+- Graceful error handling
+- Official X API v2 integration for batch checking
+
+---
+
+## Support
+
+For questions about features, usage, or technical issues, please refer to the help command or contact support channels.

COMPARISON.md

@@ -0,0 +1,172 @@
+# 📋 CLI vs Discord Bot Comparison
+
+## File Comparison
+
+| Feature | main.py (CLI) | discord_bot.py (Discord) |
+|---------|---------------|------------------------|
+| **Interface** | Terminal prompts | Discord buttons/menus |
+| **Patterns** | 7 patterns | 15 patterns + custom |
+| **Alphabet Combos** | Basic (L, D) | Extended (L, l, D, S) |
+| **Export** | 3 text files | Multiple format options |
+| **Multi-user** | Single session | Per-user sessions |
+| **Real-time** | Shows results as checks | Progress bar + results |
+| **Symbols** | None | Dots (.), underscores (_), dashes (-) |
+
+## Pattern Examples
+
+### Basic Patterns (Both)
+- `X_XXX` → `A_BCD`
+- `XX_XX` → `AB_CD`
+- `XXX_X` → `ABC_D`
+
+### Extended Patterns (Discord Bot Only)
+- `XX11` → `AB12` (2 letters + 2 digits)
+- `1X1X1X` → `5A9B3C` (Alternating)
+- `X.X.X` → `A.B.C` (Dot-separated)
+- `X_X_X` → `A_B_C` (Underscore-separated)
+- `XX1XX` → `AB5CD` (Mixed arrangement)
+
+### Custom Patterns
+
+**CLI Format** (main.py):
+```
+L = Letter
+D = Digit
+Example: LLDLD → AB5C9
+```
+
+**Discord Format** (discord_bot.py):
+```
+L = Uppercase Letter (A-Z)
+l = Lowercase Letter (a-z)
+D = Digit (0-9)
+S = Symbol (_.-) 
+Example: LL.DD → AB.12, MZ.99
+Example: LLS_LD → AB_5D, MZ_3P
+```
+
+## Alphabet Combinations
+
+### CLI (main.py)
+```
+Letters: A-Z (uppercase only)
+Digits: 0-9
+No symbols supported
+```
+
+### Discord Bot (discord_bot.py)
+```
+Uppercase Letters: A-Z
+Lowercase Letters: a-z
+Digits: 0-9
+Symbols: _ (underscore), . (dot), - (dash)
+Separators: Underscore, dot, or dash in patterns
+```
+
+## Export/Results
+
+### CLI Results (main.py)
+Creates 3 files:
+- `valid.txt` - Available usernames
+- `taken.txt` - Taken usernames
+- `censored.txt` - Censored usernames
+
+Each file lists usernames with platform in parentheses.
+
+### Discord Bot Results (discord_bot.py)
+Downloads as files with filtering options:
+- **All Valid** - All available usernames (VALID status)
+- **By Platform** - Filter to specific service:
+  - `valid_roblox.txt`
+  - `valid_instagram.txt`
+  - `valid_tiktok.txt`
+  - `valid_twitter.txt`
+  - `valid_github.txt`
+  - `valid_discord.txt`
+- **All Results** - Complete status for each
+
+## Services Checked
+
+Both check these platforms:
+✅ Roblox
+✅ Instagram
+✅ Twitter/X
+✅ GitHub
+✅ TikTok
+✅ Discord
+
+**Difference**: Discord bot lets you check all at once and filter results by service!
+
+## Usage Example
+
+### Same Scenario, Different Approaches
+
+**Scenario**: Check 250 usernames with pattern `XX11` on all platforms
+
+#### CLI Approach (main.py)
+```bash
+$ python main.py
+Choose a pattern: 
+> [can't see new patterns, only 1-9]
+Enter your choice: 8
+Enter custom pattern: XX11
+How many usernames to check? 250
+SELECT PLATFORM(S) TO CHECK:
+1. Roblox
+...
+7. All Platforms
+Enter platform choice: 7
+[Checking...]
+Results saved to valid.txt, taken.txt, censored.txt
+```
+
+#### Discord Approach (discord_bot.py)
+```
+User: /snipe
+Bot: Shows 15 pattern options (including XX11)
+User: Selects "XX11"
+Bot: Shows quantity buttons (100, 250, 500, Custom)
+User: Clicks "250"
+Bot: Shows platform multi-select
+User: Selects "All Platforms"
+Bot: Shows "Start Checking" button
+User: Clicks it
+Bot: Live progress updates, then shows results
+User: Clicks "By Platform" export
+Bot: Select TikTok → Downloads valid_tiktok.txt
+Bot: Select Roblox → Downloads valid_roblox.txt
+```
+
+## Setup Differences
+
+### CLI (main.py)
+```bash
+pip install requests colorama
+python main.py
+```
+
+### Discord Bot (discord_bot.py)
+```bash
+cp .env.example .env
+# Edit .env and add your bot token
+pip install -r requirements.txt
+python discord_bot.py
+```
+
+## Which Should You Use?
+
+**Use main.py (CLI) if you**:
+- Want quick terminal-based checks
+- Don't have a Discord server
+- Prefer simple, direct interaction
+- Don't need advanced filtering
+
+**Use discord_bot.py if you**:
+- Have a Discord server
+- Want beautiful UI with buttons/menus
+- Need advanced export/filtering options
+- Want to share with multiple users
+- Like real-time progress updates
+- Want more alphabet combo options
+
+Both tools are powerful and complementary! 🚀