NameMC Sniper

<div align="center"> <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

🪶 Recommended Proxies

BirdProxies.com Get 10% off + 15% extra data using the link above!

📚 Documentation • 🚀 Quick Start • ⚙️ Configuration • 🤝 Support

</div>

✨ Features

<table> <tr> <td width="50%">

🎯 Core Features

• Ultra-Fast Sniping - 40 concurrent workers with 3μs precision
• Connection Pooling - 20-30ms latency reduction per request
• Smart Retry Logic - Exponential backoff with error classification
• Multi-Token Support - Mass sniping with multiple accounts
• Rich CLI Interface - Beautiful interactive menu with 27 options

</td> <td width="50%">

🔧 Advanced Features

• Multi-Source Time Sync - Fallback chain with outlier detection
• Proxy Health Monitoring - Auto-disable failing proxies
• Dynamic Concurrency - Adaptive worker adjustment
• Professional Benchmarking - Test system timing precision
• Account Validation - Bulk token testing with health stats

</td> </tr> </table>

🚀 Quick Start

Prerequisites

• Python 3.8 or higher
• Valid Minecraft account with bearer token
• (Optional) Discord webhook for notifications

Installation

# 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

First Run

# 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

⚙️ Configuration

Basic Configuration (config.yaml)

# 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:password@proxy1.example.com:8080"
    - "http://proxy2.example.com:3128"
  rotation_enabled: true
  timeout: 10
  max_retries: 3

# Logging
debug_mode: false
log_level: "INFO"

🔑 Getting Your Bearer Token

<details> <summary><strong>Method 1: Browser Developer Tools (Recommended)</strong></summary>

1. Open minecraft.net and log in
2. Press F12 to open Developer Tools
3. Go to the Network tab
4. Navigate to any Minecraft service page
5. Look for requests with Authorization: Bearer <token>
6. Copy the token (long string after "Bearer ")

</details> <details> <summary><strong>Method 2: Using Authentication Script</strong></summary>

# Use minecraft-launcher-lib or similar
import minecraft_launcher_lib

# Authenticate and get token
# (Implementation depends on chosen library)

</details>

🎮 Usage

Interactive CLI Menu (Recommended)

Launch the beautiful interactive menu interface:

# Start the interactive CLI menu
python menu.py

Features:

• 🎨 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-2] Sniper Operations - Snipe at time, fallback snipe
• [11-14] Configuration - Create, edit, validate, reset config
• [21-27] Tools & Info - Token test, proxy test, logs, system info, benchmark, check proxies, check accounts
• [31-33] Discord & Notifications - Webhook setup and testing
• [41-43] Advanced Options - Performance tuning, proxy manager, debug mode
• [51-53] Help & Support - Documentation, about, GitHub repository

CLI Interface Preview

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 <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

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

# Testing & Validation (NEW in v2.0.0)
python Main.py benchmark              # Test system timing precision
python Main.py check-proxies          # Validate all proxies with health stats
python Main.py check-accounts         # Validate all bearer tokens
python Main.py test-token             # Test single bearer token

# Help and information
python Main.py --help                 # Show all commands
python Main.py version                # Show version info

Time Format

The sniper uses NameMC's exact time format:

MM/DD/YYYY • H∶MM∶SS AM/PM

Examples:

• 12/25/2024 • 3∶30∶00 PM
• 1/1/2025 • 11∶45∶30 AM

Note: Use the special bullet (•) and colon (∶) characters as shown

🌐 Proxy Setup

Supported Formats

proxies:
  - "http://ip:port"                          # No authentication
  - "http://username:password@ip:port"        # With authentication
  - "https://ip:port"                         # HTTPS proxy
  - "socks5://ip:port"                        # SOCKS5 proxy

Proxy Testing

# Test all configured proxies
python Main.py test-proxies

# View proxy statistics in real-time
python Main.py snipe --verbose

📢 Discord Integration

Webhook Setup (Recommended)

1. Go to your Discord server settings
2. Navigate to Integrations → Webhooks
3. Click New Webhook
4. Copy the webhook URL
5. Add it to your config.yaml

Notification Types

• 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

📊 Performance Optimization

Recommended Settings

| Use Case | Concurrent Requests | Request Delay | Proxy Count | |----------|-------------------|---------------|-------------| | Conservative | 5 | 50ms | 2-3 | | Balanced | 10 | 25ms | 5-10 | | Aggressive | 15 | 10ms | 10+ |

Network Optimization

• 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

🔧 Advanced Usage

Programmatic Usage

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())

Custom Notifications

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!")

🐛 Troubleshooting

<details> <summary><strong>Common Issues & Solutions</strong></summary>

Bearer Token Issues

# 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

Proxy Issues

# Error: "No working proxies available"
python Main.py test-proxies  # Check proxy health

# Error: "Proxy connection failed"
# → Verify proxy credentials and format

Discord Issues

# Error: "Webhook failed with status 404"
# → Check webhook URL is correct and not expired

# Error: "No Discord notifications"
# → Verify webhook URL and internet connection

Rate Limiting

# Err