feat: Production-ready NameMC Sniper v2.0

- Ultra-fast sniping: 40 workers, 8ms precision
- Multi-token support for mass sniping
- Intelligent rate limiting with per-token tracking
- Advanced time synchronization and error recovery
- Oracle VPS optimization and proxy support
- Updated documentation and performance metrics

Author: zwroee

.gitignore

@@ -31,8 +31,6 @@ env.bak/
 venv.bak/
 
 # Configuration files (may contain sensitive data)
-config.yaml
-*.yaml
 !config.yaml.example
 !requirements.txt
 

Main.py

@@ -14,7 +14,7 @@
 import sys
 import signal
 from pathlib import Path
-from datetime import datetime
+from datetime import datetime, timezone
 
 import click
 from rich.console import Console
@@ -277,21 +277,28 @@ def snipe_at(config, username, drop_window):
             console.print(f"[red]Your input: '{drop_window}'[/red]")
             console.print(f"[red]Expected: M/D/YYYY • H∶MM∶SS AM/PM[/red]")
             return
-        # Treat as local time - assume it's already in the correct local timezone
-        # Convert to UTC by adding the local timezone offset
+        # NameMC displays times in the user's local timezone
+        # Convert from local timezone to UTC
         import time
+        from datetime import datetime, timezone, timedelta
+        
+        # Get the user's local timezone offset
         local_offset_seconds = -time.timezone if time.daylight == 0 else -time.altzone
         local_offset = timedelta(seconds=local_offset_seconds)
         local_tz = timezone(local_offset)
 
-        # Apply local timezone to parsed time
+        # Apply user's local timezone to parsed time
         parsed_time = parsed_time.replace(tzinfo=local_tz)
         parsed_time = parsed_time.astimezone(timezone.utc)
 
-        # Check if time is in the future
+        # Check if time is in the future (allow 60 seconds grace period for clock drift)
         now = datetime.now(timezone.utc)
-        if parsed_time <= now:
+        grace_period = timedelta(seconds=60)
+        if parsed_time <= (now - grace_period):
             console.print(f"[red]Error: Drop window time must be in the future.[/red]")
+            console.print(f"[yellow]Current time: {now.strftime('%Y-%m-%d %H:%M:%S UTC')}[/yellow]")
+            console.print(f"[yellow]Your time: {parsed_time.strftime('%Y-%m-%d %H:%M:%S UTC')}[/yellow]")
+            console.print(f"[yellow]Tip: Your system clock may be slow. Try a time 1+ minutes in the future.[/yellow]")
             return
 
         time_until = (parsed_time - now).total_seconds()
@@ -330,6 +337,101 @@ async def run_snipe():
 
     asyncio.run(run_snipe())
 
+@cli.command()
+@click.option('--username', '-u', required=True, help='Username to snipe')
+@click.option('--times', '-t', required=True, multiple=True, help='Drop times in NameMC format "M/D/YYYY • H∶MM∶SS AM/PM" (can specify multiple)')
+@click.option('--config', '-c', default='config.yaml', help='Configuration file path')
+def snipe_fallback(username, times, config):
+    """Snipe a username with multiple fallback drop times"""
+    if len(times) < 2:
+        console.print("[red]❌ Please provide at least 2 drop times for fallback sniping[/red]")
+        console.print("[yellow]Example: python Main.py snipe-fallback -u Username -t \"12/25/2024 • 3∶30∶00 PM\" -t \"12/25/2024 • 3∶31∶00 PM\"[/yellow]")
+        return
+    
+    # Load configuration
+    config_manager = ConfigManager(config)
+    try:
+        app_config = config_manager.load_config()
+    except Exception as e:
+        console.print(f"[red]❌ Failed to load config: {e}[/red]")
+        return
+    
+    # Override username in config
+    app_config.snipe.target_username = username
+    
+    # Parse drop times using NameMC format
+    drop_times = []
+    for time_str in times:
+        try:
+            # Parse NameMC format: "9/30/2025 • 11∶46∶32 PM"
+            if '•' not in time_str or '∶' not in time_str:
+                console.print(f"[red]❌ Invalid NameMC format: '{time_str}'[/red]")
+                console.print("[yellow]Use format: M/D/YYYY • H∶MM∶SS AM/PM[/yellow]")
+                return
+            
+            # Clean the format: replace NameMC special characters
+            import time as time_module
+            from datetime import timedelta
+            
+            clean_window = time_str.replace('•', '').replace('∶', ':').strip()
+            parsed_time = datetime.strptime(clean_window, '%m/%d/%Y %I:%M:%S %p')
+            
+            # NameMC displays times in the user's local timezone, convert to UTC
+            # Get the user's local timezone offset
+            local_offset_seconds = -time_module.timezone if time_module.daylight == 0 else -time_module.altzone
+            local_offset = timedelta(seconds=local_offset_seconds)
+            local_tz = timezone(local_offset)
+            
+            # Set as local time, then convert to UTC
+            parsed_time = parsed_time.replace(tzinfo=local_tz)
+            parsed_time = parsed_time.astimezone(timezone.utc)
+            
+            # Allow 60 second grace period for clock drift
+            now = datetime.now(timezone.utc)
+            grace_period = timedelta(seconds=60)
+            if parsed_time <= (now - grace_period):
+                console.print(f"[red]❌ Drop time '{time_str}' is in the past![/red]")
+                console.print(f"[yellow]Tip: Your system clock may be slow. Try a time 1+ minutes in the future.[/yellow]")
+                return
+            
+            drop_times.append(parsed_time)
+        except ValueError:
+            console.print(f"[red]❌ Invalid NameMC format: '{time_str}'[/red]")
+            console.print("[yellow]Use format: M/D/YYYY • H∶MM∶SS AM/PM[/yellow]")
+            console.print("[yellow]Example: 12/25/2024 • 3∶30∶00 PM[/yellow]")
+            return
+    
+    # Sort drop times
+    drop_times.sort()
+    
+    # Display summary
+    console.print(f"[cyan]Fallback Snipe Configuration:[/cyan]")
+    console.print(f"Username: [bold]{username}[/bold]")
+    console.print(f"Drop Windows: [bold]{len(drop_times)}[/bold]")
+    for i, dt in enumerate(drop_times, 1):
+        console.print(f"  {i}. {dt.strftime('%Y-%m-%d %H:%M:%S UTC')}")
+    
+    async def run_fallback_snipe():
+        console.print(f"[cyan]Starting fallback sniper for username: {username}[/cyan]")
+        
+        # Create and run sniper
+        sniper = UsernameSniper(app_config)
+        result = await sniper.snipe_with_fallback(drop_times, username)
+        
+        # Display results
+        if result.success:
+            console.print(Panel.fit(
+                f"SUCCESS! Claimed username '{username}' using fallback system!",
+                style="bold green"
+            ))
+        else:
+            console.print(Panel.fit(
+                f"FAILED to claim '{username}' after {len(drop_times)} drop windows.\nError: {result.error_message or 'All windows failed'}",
+                style="bold red"
+            ))
+    
+    asyncio.run(run_fallback_snipe())
+
 @cli.command()
 @click.option('--config', '-c', default='config.yaml', help='Configuration file path')
 def test_token(config):

README.md

@@ -2,15 +2,15 @@
 
 <div align="center">
 
-![NameMC Sniper Logo](https://img.shields.io/badge/NameMC-Sniper-blue?style=for-the-badge&logo=minecraft)
+<img width="1536" height="324" alt="assets_task_01k6cfgfnce75rr55xznbme123_1759208092_img_1" src="https://github.com/user-attachments/assets/cf0a9ba6-a318-424b-a163-82f34b9915b0" />
 
 **A professional-grade Minecraft username sniper with advanced features**
 
 [![Python Version](https://img.shields.io/badge/python-3.8%2B-blue.svg)](https://python.org)
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
 [![Code Style](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
 
-[📚 Documentation](https://your-docs-website.com) • [🚀 Quick Start](#quick-start) • [⚙️ Configuration](#configuration) • [🤝 Support](#support)
+[📚 Documentation](https://zwroee.github.io/NameMCSniper-Docs/) • [🚀 Quick Start](https://zwroee.github.io/NameMCSniper-Docs/#quick-start) • [⚙️ Configuration](https://zwroee.github.io/NameMCSniper-Docs/getting-started/configuration/) • [🤝 Support](https://zwroee.github.io/NameMCSniper-Docs/legal/support/)
 
 </div>
 
@@ -21,20 +21,20 @@
 <td width="50%">
 
 ### 🎯 **Core Features**
-- **High-Speed Sniping** - 10 concurrent workers with 25ms precision
-- **Bearer Token Auth** - Secure Minecraft authentication
-- **Exact Timing** - Starts 0.1s before drop, runs 10.1s after
-- **Smart Proxy Rotation** - Health-checked proxy management
+- **Ultra-Fast Sniping** - 40 concurrent workers with 8ms precision
+- **Multi-Token Support** - Mass sniping with multiple accounts
+- **Intelligent Rate Limiting** - Per-token backoff strategies
+- **Smart Proxy Rotation** - Residential proxy support (user-provided)
 - **Rich CLI Interface** - Beautiful terminal with colors & tables
 
 </td>
 <td width="50%">
 
 ### 🔧 **Advanced Features**
-- **Discord Integration** - Real-time notifications & embeds
-- **Countdown Notifications** - Multi-interval drop alerts
-- **Configuration Validation** - Built-in config error checking
-- **Comprehensive Logging** - Detailed file & console logs
+- **Time Synchronization** - NTP-based accurate timing
+- **Adaptive Delays** - Dynamic request timing optimization
+- **Network Optimization** - Oracle VPS performance tuning
+- **Error Recovery** - Graceful failure handling & retries
 - **Token Validation** - Test bearer tokens before sniping
 
 </td>
@@ -86,10 +86,10 @@ python Main.py snipe-at -u "Username" -w "12/25/2024 • 3∶30∶00 PM"  # Snip
 snipe:
   target_username: "YourDesiredUsername"
   bearer_token: "your_minecraft_bearer_token_here"
-  start_sniping_at_seconds: 30
-  max_snipe_attempts: 100
-  request_delay_ms: 25
-  concurrent_requests: 10
+  start_sniping_at_seconds: 0
+  max_snipe_attempts: 3000
+  request_delay_ms: 8
+  concurrent_requests: 40
 
 # Discord Notifications
 discord:
@@ -175,6 +175,7 @@ The interactive menu features a professional Matrix-style interface with:
 - **Real-time Information** - Current time display and status updates
 - **User-friendly Navigation** - Simple number-based option selection
 - **Professional Styling** - Consistent green theme throughout
+<img width="1918" height="983" alt="Screenshot 2025-09-30 063615" src="https://github.com/user-attachments/assets/387111dd-6039-46c1-b04c-73687cbb761a" />
 
 ### Command Line Interface
 
@@ -356,45 +357,45 @@ grep -i error logs/namemc_sniper_*.log
 grep -i "claim attempt" logs/namemc_sniper_*.log
 ```
 
-## 📚 Documentation
-
-For comprehensive documentation, examples, and advanced configuration:
+## 🚀 Performance
 
-**[📖 Visit our Documentation Website](https://your-docs-website.com)**
+### Optimized for Competitive Sniping
 
-- 🎯 **Sniping Strategies** - Optimal settings for different scenarios
-- 🔧 **API Reference** - Complete function and class documentation  
-- 📊 **Performance Tuning** - Advanced optimization techniques
-- 🤖 **Bot Integration** - Discord bot setup and commands
-- 📈 **Analytics** - Success rate tracking and statistics
+| Metric | Value | Description |
+|--------|-------|-------------|
+| **Concurrent Workers** | 40 | Simultaneous sniping threads |
+| **Request Delay** | 8ms | Ultra-fast request timing |
+| **Max Attempts** | 3000 | High-volume attempt capability |
+| **Proxy Support** | Unlimited | Residential proxy rotation (user-provided) |
+| **Rate Limiting** | Per-token | Intelligent backoff strategies |
+| **Time Sync** | NTP-based | Sub-second timing accuracy |
 
-## 👥 Contributors
+### Infrastructure Compatibility
 
-Special thanks to everyone who contributed to this project:
+- ✅ **Oracle VPS** - Optimized for 2+ OCPUs
+- ✅ **Residential Proxies** - Compatible with premium proxy providers  
+- ✅ **Multi-Token** - Scale with multiple Microsoft accounts
+- ✅ **Global Timezones** - Automatic timezone detection
+- ✅ **Rate Limit Handling** - Smart 429 response management
 
-### Core Contributors
-- **[Your Name]** - *Project Lead & Main Developer* - [@your-github](https://github.com/your-username)
-- **[Collaborator Name]** - *Architecture & Performance Optimization* - Contributed via pair programming sessions
+## 📚 Documentation
 
-### How to Contribute
+For comprehensive documentation, examples, and advanced configuration:
 
-We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.
+**[📖 Visit our Documentation Website](https://zwroee.github.io/NameMCSniper-Docs/)**
 
-#### Development Setup
-```bash
-# Clone and setup development environment
-git clone https://github.com/your-username/NameMcSniper.git
-cd NameMcSniper
+- 🎯 **Sniping Strategies** - Multi-token and proxy optimization
+- 🔧 **API Reference** - Complete function and class documentation  
+- 📊 **Performance Tuning** - Oracle VPS and rate limiting optimization
+- 🤖 **Discord Integration** - Webhook notifications and status updates
+- 📈 **Competitive Analysis** - Success rates against different sniper types
 
-# Install development dependencies
-pip install -r requirements-dev.txt
+## 🫂 Authors
 
-# Run tests
-python -m pytest tests/
+### Authors
+- **[zwroe]** -  [@zwroee](https://github.com/zwroee)
+- **[light]** - [@zerolight18](https://github.com/zerolight18)
 
-# Format code
-black .
-```
 
 ## 📄 License
 
@@ -414,7 +415,7 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 
 ### Getting Help
 
-1. **📚 Check Documentation** - [docs website](https://your-docs-website.com)
+1. **📚 Check Documentation** - [docs website](https://zwroee.github.io/NameMCSniper-Docs/)
 2. **🔍 Search Issues** - Look for similar problems
 3. **📝 Create Issue** - Provide detailed information
 4. **💬 Discord Community** - Join our support server
@@ -432,6 +433,6 @@ When reporting bugs, please include:
 
 **Made with ❤️ for the Minecraft community**
 
-[⭐ Star this repo](https://github.com/your-username/NameMcSniper) • [🐛 Report Bug](https://github.com/your-username/NameMcSniper/issues) • [💡 Request Feature](https://github.com/your-username/NameMcSniper/issues)
+[⭐ Star this repo](https://github.com/zwroee/NameMcSniper) • [🐛 Report Bug](https://github.com/zwroee/NameMcSniper/issues) • [💡 Request Feature](https://github.com/zwroee/NameMcSniper/issues)
 
 </div>