LCE QT Launcher

French Version (Not updated yet)

Warning

This launcher is work in progress and its feature could be changes or remove at any time. PR are more than welcome to fix or add features. Just be compliant with the GPLv3 license and the Code of Respect

About

This is a custom Minecraft LCE Launcher written in Python and Qt with Freedom and with GNU/Linux support in mind.

Why LCE Qt Launcher ?

• Made in Python with Qt 6 : bloat free and integrate with GNU/Linux Plasma 6/Qt 6 Theme
• Customisation with Themes and laters modules/plugins
• Integration with Community Tools
• GNU/Linux first class support
• Licensed via copyleft licensing (GPLv3), so big tech free
• Free as Freedom Launcher
• Minecraft Themed by default

Features

• Command Line interface (CLI)
• Multiple Instances support (Work in progress)
• localisations support (Work in progress)
  • Pre-Configured ones :
    • MCLCE/MinecraftConsoles (previously smartcmd/MinecraftConsoles)
    • LegacyEvolved (will be removed soon as was replaced with NeoLegacy)
    • NeoLegacy
• Marketplaces :
  • LCE Hub Emeralds Launcher Workshop
  • LegacyMods (coming soon)
• in-app news

Long Term Goal / Roadmap

• Accessibility
• Modding Support
• Launcher Plugins
• Skin support
• GNU/Linux compatibility
• Windows support
• Experimental FreeBSD support
• Focus on being the main hub for Minecraft LCE on GNU/Linux

How to run

VSCode

Note

In Windows where you need to replace / with \

Warning

This method is not recommed nore tested for NixOS, go to the NixOS Section, for the step for this particular OS.

1. Create a Python Virtual Env via a tool like UV (if not already done)
2. Set VSCode to that Python Virtual Env
3. Run "Pyside : Sync Virtual Env and Launch"
4. Run the app via Vscode debug mode or directly the src/lce_qt_launcher/main.py file.

NixOS

1. load the nix shell with nix-shell command
2. compiled the ui and ressource file with scripts/build.sh
3. load the app with python src/lce_qt_launcher/main.py

Others

coming soon

How to build

Portable Nuitka Build

0. Create a Python Virtual Env via a tool like UV (if not already done)
1. Run hatch run packages

Arch Linux

1. Go the packages/linux directory
2. Choose a channel dev, nigthly or stable (go to the directory)
3. Run makepkg -si or makepkg -s (for no install) in one of these directory

Nix Package

Nix Flake (Not tested yet/Work in progress)

Run nix build

Nixpkg

Run nix-build default.nix

Flatpak and Windows Installers

• Guide Coming Later

Nigthly Build

Note

This automatic nighly build is currently not-stable and is very experimental and in active developpement This branch is not stable and changes are made almost daily so this branch can sometimes break. Also, MacOS is not avaiable in the Nigthly Build due to Apple restriction and that I do now own a mac.

In this GitHub Release page you will found Nighly Build which are made automatically via GitHub Action when change are made in the nighly branch

Software Requirement

• Python 3.11 (For FreeBSD) to Python 3.12 (GNU/Linux, Windows and MacOS)
  • with a virtual env with the required library install (specified in the readme and pyproject.toml)
• PySide6
• Monocraft Font installed
• For UNIX like system
  • A display server or compositor (Except on MacOS where it use its own proprietary one)
  • Bash (normally pre-installed on Linux but often demand installation in *BSD and MacOS)

Python Library and Tools Used

• PySide 6
• requests
• platformdirs
• rich
• hatch
• uv

Compatible Operating System

Golden Support

• Windows 10 and later
• GNU/Linux

Experimental Support

• NixOS

Future Supported Platform

• FreeBSD (While it may worked, it is not tested for it yet and might not worked at all)
• Flatpak (While it may worked, it is not tested for it yet and might not worked at all)

Unsupported OS

• Other *BSD system, as Minecraft LCE is not supported on those and Wine is not available.
• Minecraft LCE on Android is currently quite laggy and buggy
• macOS: LCE Qt Launcher does not officially support MacOS and is not tested during PRs, but POISX compatibility should allow its use.

Special Thank to

• Prism Launcher for certain UI elements and ui files
• MCLCE/MinecraftConsoles for the port of the game for PC
• pieeebot/neoLegacy for backporting updates for the PC port
• LCE Hub for the Marketplace/Workshop

Code of Respect

• English
• French

License

GPLV3