🎮 Minecraft Username Checker

A command-line tool to check if a Minecraft username is available, with automatic refresh at customizable intervals.

📋 Requirements

1. Make sure you have Python installed on your system
2. Install uv if you want the fastest setup and launch path

Everything is now defined in pyproject.toml. There is no requirements.txt anymore.

🚀 Usage

💻 Using execute.bat (Recommended)

You can run the script in two ways:

1. With a username:

execute.bat desired_username
# Example: execute.bat Notch

2. Without arguments (uses last saved username):

execute.bat

The script will:

1. Use uv automatically when it is installed
2. Fall back to a local Python virtual environment if uv is not available
3. Install the project from pyproject.toml
4. Save the username for next use (if provided)
5. Start monitoring the username

⌨️ Manual Usage

Run the script with the following arguments:

uv sync
uv run mcus --username "desired_username" --interval 10

Arguments:

• --username: The Minecraft username to check (required)
• --interval: Check interval in seconds (optional, default: 10)

If you do not have uv, you can still run the module directly with Python:

python check_minecraft_username.py --username "desired_username" --interval 10

✨ Features

• 🔄 Real-time username availability monitoring
• 🔔 Windows notifications via winotify when username becomes available
• 📝 Automatic notepad file creation with:
  • 👤 Available username
  • 🔗 Link to change Minecraft username
  • 🕒 Timestamp
• 🤖 Discord webhook integration (optional)
• ⚠️ Error handling with explicit messages
• 📊 Clean console output with timestamps
• 💾 Username persistence in execute.bat
• 🎨 ASCII art banner

🚨 Notifications System

When a username becomes available, the tool will trigger multiple notifications:

1. Windows Notification 🔔

• Instant toast notification in Windows via winotify
• Shows the available username
• Stays visible for 10 seconds

2. Notepad File 📝

• Automatically creates a text file on your Desktop
• Filename: minecraft_username_[USERNAME].txt
• Contains:
  • The available username
  • Direct link to Minecraft's profile page for changing username
  • Exact date and time when it became available
• Opens automatically in Notepad

3. Discord Webhook (Optional) 🤖

• Sends a rich embed message to your Discord channel
• Includes:
  • Username that became available
  • Timestamp of availability
  • Green color coding for visibility
• To enable, see Discord Integration section below

🔌 Discord Integration

To enable Discord notifications:

1. Create a .env file in the same directory
2. Add your Discord webhook URL:

DISCORD_WEBHOOK_URL=your_webhook_url_here