Hru Hru Launcher

Hru Hru Launcher is a custom Minecraft launcher built with Python and PySide6, providing a sleek interface for launching various Minecraft versions, including Vanilla, Forge, and Fabric. It features customizable settings, console output, and dynamic version loading.

---

Features

• Multi-Version Support: Easily launch Vanilla, Forge, and Fabric versions of Minecraft.
• User-Friendly Interface: A clean and intuitive graphical user interface (GUI) built with PySide6.
• Customizable Settings: Adjust language (English/Russian/Ukrainian), theme (Dark, Light, Neon), allocated memory, fullscreen mode, and launcher behavior after game launch.
• Advanced JVM Arguments: Option to enable G1GC for improved performance.
• Dynamic Version Loading: Automatically fetches available Minecraft versions (Vanilla, Forge, Fabric).
• Integrated Console: View real-time game output and launcher logs within the application.
• Custom Data Directories: Game runtime data (logs, saves, resource packs) are stored in a dedicated user-friendly folder, while core Minecraft installations remain in the standard .minecraft directory.
• Modular Codebase: The code has been split into organized modules for better maintainability and scalability.
• Mod Installation (Beta): Basic mod installation support with improved mod search, pagination, and a page listing installed mods.
• Version Manager: View, delete, or manage installed Minecraft versions directly from the launcher.
• AutoFix Function: Automatically fixes common issues during launch or installation.
• Automatic RAM Detection: Launcher can detect and recommend optimal RAM allocation.
• Cancel Installations: Option to cancel ongoing Minecraft installations.
• Installer Available: A downloadable setup file is now provided for easier installation.

---

👋 Contact me:

Preview

Installation (for Developers)

To set up and run this project locally, follow these steps:

Prerequisites

• Python 3.11, 3.12, or 3.13: It's recommended to use these Python versions for optimal compatibility with PyInstaller. You can download them from python.org/downloads. Ensure you add Python to your system's PATH during installation.
• Java Runtime Environment (JRE) or Java Development Kit (JDK): Minecraft requires Java to run. Ensure you have a compatible Java version installed on your system.

Setup

1. Clone the repository (or download the source code):

   git clone https://github.com/krutoychel24/hru-hru-launcher
   cd hru-hru-launcher

2. Create a Virtual Environment (highly recommended):

   python -m venv venv

3. Activate the Virtual Environment:

   • On Windows (Command Prompt):

     .\venv\Scripts\activate

   • On Windows (PowerShell):

     .\venv\Scripts\Activate.ps1

4. Install the required Python packages:

   pip install -r requirements.txt

---

Running the Launcher (Development Mode)

After setting up the environment, you can run the launcher directly from the Python script:

python -m hru_hru_launcher.main

---

Also featured on:

• Dev.to article — Introducing HruHruLauncher: A Custom Minecraft Launcher in Python
• Libhunt listing — HruHruLauncher on Python LibHunt

Feel free to ⭐️ the project or share your thoughts — all feedback is welcome!

---

Disclaimer

This is an unofficial Minecraft launcher. It is not affiliated with Mojang, Microsoft, or Minecraft.

The launcher supports offline mode for testing or singleplayer use only.

You must own a legal copy of Minecraft to use this launcher.

All Minecraft libraries are downloaded from official Mojang servers.