🎮 PyMCL

A Python Minecraft Launcher - easily manage and launch Minecraft instances with a simple, intuitive interface and multiple distribution methods.

For quick reference's sake, download the latest release here.

🏅 Badges

Biggest miracle in the world:

✨ Features

• 🧱 Real instance management — create as many named instances as you want, each with its own version, mod loader, mods folder, and optional memory/JVM overrides
• 👥 Multiple accounts — save several Microsoft accounts and offline profiles side by side and switch the active one from the sidebar
• 🎯 One-click launcher with per-instance progress, right from its card
• 🌐 Live server list with real status, MOTD, player counts, and ping — plus one-click "Join" that launches straight into a server
• 📦 Automatic dependency handling
• 🔧 Customizable per-instance and global game settings

📋 Requirements

• Python 3.8 or higher
• pip (Python package manager)
• Java Runtime Environment (Optional, but for a speedy startup, please install it)

🚀 Quick Start

1️⃣ Installation - All Platforms

# Clone the repository
git clone https://github.com/Earth1283/PyMCL.git
cd PyMCL

# Install dependencies
pip install -r requirements.txt

2️⃣ Launch Minecraft

# Start the launcher
python main.py

⚡️ Quick EXE - Windows Only

Download the exe from the latest release here

Double click the exe, and you're done!

Clearing the Cache

To clear the icon cache, you can either:

• Go to the Tools menu and select Clear Icon Cache.
• Go to the Mods page and click the Clear Icon Cache button.

Instances

Everything starts from the Home page, which shows your instances as cards instead of one global version/loader picker. Each instance has its own name, icon, Minecraft version, mod loader, and mods folder, so a vanilla 1.21 world and a heavily modded Fabric pack can happily live side by side. Hit "+ New Instance" to create one, and use a card's "⋮" menu to edit, duplicate, open its folder, manage its mods, or delete it.

Accounts

Add as many Microsoft accounts and offline profiles as you like from the account chip at the bottom of the sidebar. Whichever one is marked "Active" is used the next time you press Play.

Mod Explorer

The mod explorer uses a 3-column grid layout. Each mod is displayed as a card with its icon, name, and a download badge. The search bar is now a floating bar at the top of the page.

Clicking on a mod card (but not the download button) will open a new window with the mod's full description, rendered from Markdown. To download a mod, first pick an instance on the "Mods" page — its version and loader are used to filter compatible downloads on the "Browse Mods" page.

🎮 Usage

GUI Mode

Simply run:

python launcher.py

EXE Mode

Simply double click that exe file. Period.

🤝 Contributing

We welcome contributions! Feel free to open issues and pull requests.

📄 License

MIT License - see LICENSE file for details

❓ Need Help?

• 🐛 Report issues on GitHub
• 🔧 Start a PR to improve the project！

---

Happy Crafting! ⛏️