Gon Minecraft Checker

Features

Core Functionality

• Multi-threaded Checking: Configurable threads (1-20) for fast username verification
• Custom Name Generation: Generate random usernames with customizable length (3-6 characters)
• Variation Generator: Create variations of base usernames with different patterns
• Real-time Statistics: Live tracking of checked, found, and error counts
• Speed Monitoring: Real-time checks per second display

Customization Options

• Username Length: Choose from 3, 4, 5, or ranges (3-4, 3-5, 4-6)
• Character Options:
  • Toggle numbers (0-9)
  • Toggle underscores (_)
• Display Modes: Show all results or only available usernames
• Sound Notifications: Audio alerts when available usernames are found

Advanced Features

• Discord Webhook Integration: Automatic notifications with embed formatting
• Export Functionality: Save results to timestamped files
• Auto-save: Available usernames automatically saved to available_usernames.txt
• Multi-language Support: English and Portuguese interfaces
• Configuration Persistence: Settings saved between sessions

Installation

Requirements

• Python 3.7 or higher
• Windows OS (for sound notifications)

Dependencies

pip install customtkinter requests

Or install from requirements file:

pip install -r requirements.txt

Usage

Basic Operation

1. Configure Settings:

   • Select username length from the dropdown
   • Set number of threads (1-20)
   • Toggle character options (numbers, underscores)

2. Start Checking:

   • Click the "START" button
   • Monitor real-time statistics
   • Available usernames will be displayed and saved

3. Stop/Reset:

   • Click "STOP" to pause checking
   • Click "RESET" to clear counters and results

Discord Webhook Setup

1. Click the "WEBHOOK" button
2. Enter your Discord webhook URL
3. Enable webhook notifications
4. Test the webhook connection
5. Save configuration

Exporting Results

• Click "EXPORT" to save all available usernames
• Files are saved to exports/ directory with timestamps
• Format: usernames_YYYYMMDD_HHMMSS.txt

Configuration Files

config.json

Stores application settings:

{
  "length": "3-4",
  "threads": 10,
  "sound": true,
  "verbose": false,
  "clear_on_start": true,
  "webhook_enabled": false,
  "allow_numbers": true,
  "include_underscore": true,
  "language": "en"
}

webhook_config.json

Stores Discord webhook configuration:

{
  "webhook_url": "https://discord.com/api/webhooks/...",
  "enabled": false,
  "last_updated": "2026-01-27T10:30:00"
}

Directory Structure

gon-minecraft-checker/
├── main.py                      # Main application file
├── README.md                    # This file
├── requirements.txt             # Python dependencies
├── config.json                  # App configuration
├── webhook_config.json          # Webhook settings
├── available_usernames.txt      # Auto-saved results
├── assets/
│   └── icon.ico                # Application icon
├── logs/
│   └── username_checker.log    # Application logs
└── exports/
    └── usernames_*.txt         # Exported results

API Details

The application uses the Mojang API to check username availability:

Endpoint: https://api.mojang.com/users/profiles/minecraft/{username}

Response Codes:

• 404: Username available
• 200: Username taken
• 429: Rate limited

Features:

• Automatic retry mechanism (up to 3 attempts)
• Rate limit handling with exponential backoff
• Request timeout protection (15 seconds)

Performance Tips

1. Thread Count:

   • Start with 10 threads
   • Increase for faster checking (may trigger rate limits)
   • Decrease if experiencing errors

2. Rate Limiting:

   • Built-in delays prevent API abuse
   • Automatic backoff on rate limit detection

3. Resource Usage:

   • Each thread makes sequential requests
   • Minimal CPU and memory footprint
   • Network speed is primary bottleneck

Troubleshooting

Common Issues

No usernames being found:

• This is normal - 3-4 character usernames are very rare
• Try longer lengths (5-6 characters) for better results

High error count:

• Reduce thread count
• Check internet connection
• Verify Mojang API is accessible

Webhook not working:

• Verify webhook URL is correct
• Test webhook using built-in test function
• Check Discord server permissions

Application crashes:

• Check logs/username_checker.log for details
• Verify all dependencies are installed
• Ensure Python version is 3.7+

Development

Project Structure

• UsernameCheckerApp: Main application class
• VariationGenerator: Username variation logic
• WebhookManager: Discord webhook handling
• ConfigManager: Configuration persistence

Key Functions

• generate_name(): Random username generation
• is_available(): API checking logic
• check_worker(): Thread worker function

License

This project is open source and available under the MIT License.

Disclaimer

This tool is for educational purposes only. Please respect Mojang's API usage policies and terms of service. Use responsibly and avoid excessive requests that could be considered abuse.

Changelog

Version 1.0.0

• Initial release
• Multi-threaded checking
• Discord webhook integration
• Custom name variations
• Multi-language support
• Export functionality
• Configuration persistence

---

Note: Minecraft username availability changes constantly. Results are based on the Mojang API status at the time of checking.