A professional-grade Minecraft username sniper with advanced features
📚 Documentation • 🚀 Quick Start • ⚙️ Configuration • 🤝 Support
|
|
- Python 3.8 or higher
- Valid Minecraft account with bearer token
- (Optional) Discord webhook for notifications
# Clone the repository
git clone https://github.com/your-username/NameMcSniper.git
cd NameMcSniper
# Create virtual environment
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
# Install dependencies
pip install -r requirements.txt
# Create configuration file
python Main.py config-create# Launch the interactive CLI menu (recommended for beginners)
python menu.py
# Or use command line directly
python Main.py test-token # Test your bearer token
python Main.py snipe-at -u "Username" -w "12/25/2024 • 3∶30∶00 PM" # Snipe username# Sniping Configuration
snipe:
target_username: "YourDesiredUsername"
bearer_token: "your_minecraft_bearer_token_here"
start_sniping_at_seconds: 0
max_snipe_attempts: 3000
request_delay_ms: 8
concurrent_requests: 40
# Discord Notifications
discord:
enabled: true
webhook_url: "https://discord.com/api/webhooks/YOUR_WEBHOOK_URL"
mention_role_id: "123456789012345678" # Optional
embed_color: 65280 # Green
# Proxy Configuration (Optional)
proxy:
enabled: false
proxies:
- "http://username:[email protected]:8080"
- "http://proxy2.example.com:3128"
rotation_enabled: true
timeout: 10
max_retries: 3
# Logging
debug_mode: false
log_level: "INFO"Method 1: Browser Developer Tools (Recommended)
- Open minecraft.net and log in
- Press
F12to open Developer Tools - Go to the Network tab
- Navigate to any Minecraft service page
- Look for requests with
Authorization: Bearer <token> - Copy the token (long string after "Bearer ")
Method 2: Using Authentication Script
# Use minecraft-launcher-lib or similar
import minecraft_launcher_lib
# Authenticate and get token
# (Implementation depends on chosen library)Launch the beautiful interactive menu interface:
# Start the interactive CLI menu
python menu.pyFeatures:
- 🎨 Beautiful ASCII Art - Matrix-style green interface
- 📋 Organized Categories - Easy navigation with numbered options
- ⚡ Real-time Testing - Test tokens, proxies, and Discord integration
- 🔧 Configuration Management - Create, validate, and manage configs
- 📊 System Information - View logs, system stats, and performance data
- 🎯 One-Click Sniping - Simple username sniping at specific times
Menu Categories:
- [1] Sniper Operations - Main sniping functionality
- [11-14] Configuration - Config creation, validation, and management
- [21-24] Tools & Info - Token testing, proxy testing, logs, system info
- [31-33] Discord & Notifications - Webhook setup and testing
- [41-43] Advanced Options - Performance tuning, debug mode
- [51-53] Help & Support - Documentation, about, GitHub links
The interactive menu features a professional Matrix-style interface with:
- Green ASCII Art Logo - Eye-catching NameMC Sniper branding
- Organized Menu Layout - Clean categorized options in bordered boxes
- Real-time Information - Current time display and status updates
- User-friendly Navigation - Simple number-based option selection
- Professional Styling - Consistent green theme throughout
For advanced users and automation:
# Basic sniping
python Main.py snipe -u "Username" -t "your_bearer_token"
# Snipe at specific time (NameMC format)
python Main.py snipe-at -u "Username" -w "12/25/2024 • 3∶30∶00 PM"
# Configuration management
python Main.py config-create # Create default config
python Main.py config-validate # Validate current config
python Main.py test-proxies # Test proxy connections
python Main.py test-token # Validate bearer token
# Help and information
python Main.py --help # Show all commands
python Main.py version # Show version infoThe sniper uses NameMC's exact time format:
MM/DD/YYYY • H∶MM∶SS AM/PM
Examples:
12/25/2024 • 3∶30∶00 PM1/1/2025 • 11∶45∶30 AM
Note: Use the special bullet (•) and colon (∶) characters as shown
proxies:
- "http://ip:port" # No authentication
- "http://username:password@ip:port" # With authentication
- "https://ip:port" # HTTPS proxy
- "socks5://ip:port" # SOCKS5 proxy# Test all configured proxies
python Main.py test-proxies
# View proxy statistics in real-time
python Main.py snipe --verbose- Go to your Discord server settings
- Navigate to Integrations → Webhooks
- Click New Webhook
- Copy the webhook URL
- Add it to your
config.yaml
- Countdown Alerts - 1h, 30m, 5m, 1m, 30s before drop
- Sniping Started - When sniping begins
- Success/Failure - Final result with statistics
- Error Alerts - Configuration or runtime errors
| Use Case | Concurrent Requests | Request Delay | Proxy Count |
|---|---|---|---|
| Conservative | 5 | 50ms | 2-3 |
| Balanced | 10 | 25ms | 5-10 |
| Aggressive | 15 | 10ms | 10+ |
- Use a VPS close to Minecraft servers (US East Coast recommended)
- Test proxy latency:
python Main.py test-proxies - Monitor logs for rate limiting warnings
import asyncio
from datetime import datetime, timezone
from config import ConfigManager
from sniper import UsernameSniper
async def snipe_username():
# Load configuration
config_manager = ConfigManager("config.yaml")
config = config_manager.load_config()
# Create sniper instance
sniper = UsernameSniper(config)
# Snipe at specific time
drop_time = datetime(2024, 12, 25, 15, 30, 0, tzinfo=timezone.utc)
result = await sniper.snipe_at_time(drop_time, "Username")
print(f"Success: {result.success}")
print(f"Attempts: {result.attempts}")
# Run the sniper
asyncio.run(snipe_username())from discord_notifier import DiscordNotifier
async def custom_notification():
notifier = DiscordNotifier(webhook_url="your_webhook_url")
async with notifier:
await notifier.notify_status_update("Custom message here!")Common Issues & Solutions
# Error: "Bearer token is required"
python Main.py test-token # Validate your token
# Error: "Unauthorized (401)"
# → Token expired, get a new one from minecraft.net# Error: "No working proxies available"
python Main.py test-proxies # Check proxy health
# Error: "Proxy connection failed"
# → Verify proxy credentials and format# Error: "Webhook failed with status 404"
# → Check webhook URL is correct and not expired
# Error: "No Discord notifications"
# → Verify webhook URL and internet connection# Error: "Rate limited (429)"
# → Increase request_delay_ms in config
# → Reduce concurrent_requests
# → Add more working proxies# View recent logs
tail -f logs/namemc_sniper_*.log
# Search for errors
grep -i error logs/namemc_sniper_*.log
# Monitor sniping attempts
grep -i "claim attempt" logs/namemc_sniper_*.log| 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 |
- ✅ 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
For comprehensive documentation, examples, and advanced configuration:
📖 Visit our Documentation Website
- 🎯 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
Thanks to these awesome people who've contributed to the project:
- @zwroee - Project creator & maintainer
- @zerolight18 - Co-author
- @robertsmrek - Python 3.13 compatibility fix
This project is licensed under the MIT License - see the LICENSE file for details.
Important: This tool is for educational purposes only.
- ✅ Comply with Minecraft's Terms of Service
- ✅ Respect API rate limits and usage policies
- ✅ Use responsibly and ethically
- ❌ Don't use for commercial username trading
- ❌ Don't abuse or spam Minecraft services
- 📚 Check Documentation - docs website
- 🔍 Search Issues - Look for similar problems
- 📝 Create Issue - Provide detailed information
- 💬 Discord Community - Join our support server
When reporting bugs, please include:
- Python version and OS
- Full error message and stack trace
- Configuration file (remove sensitive data)
- Steps to reproduce the issue
Made with ❤️ for the Minecraft community