Files
LCE-Qt-Launcher/readme.md
2026-03-26 00:57:31 -04:00

2.8 KiB

LCE QT Launcher

LCE-QT-Launcher

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 Code of Respect

About

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

Features

  • Command Line interface
  • Qt 6 GUI (Native like Interface)
  • Written in Python (No Electron or Rust)
  • Customisable
  • Free Software (GPLv3)
  • Multiple Instance (Work in progress)
  • GNU/Linux compatibility first (with secondary Windows and FreeBSD support)
  • Focus on being the main hub for Minecraft LCE on GNU/Linux
  • Minecraft Theme pre-configured

How to run

VSCode

  1. Create a Python Virtual Env via a tool like UV
  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/main.py file.

Others

Guide coming laters

How to build

Coming in version 0.0.1 when the program will be more stable

Nigthly Build

Note

This automatic nighly build is currently not-stable and very experimental and is in constant change

In this GitHub Relese page you will found Nighly Build which are made automatically via GitHub Action when change are made in the nighly branch This branch is not stable and changes are made almost daily and this branch can sometime break MacOS is not avaiable in the Nigthly Build for now since I lack a way to test it since I do not own a Mac

Software Requirement

  • Python 3.12.x
    • with a virtual env with the required library install (specified in the readme and pyproject.toml)
  • PySide6
  • Monocraft Font installed
  • A display server or compositor (for Unix like system, MacOS and Windows use their own proprietary one)

Python Library Used

  • pyside6,
  • requests,
  • rich,
  • term-image,
  • pillow,
  • hatch,
  • uv,
  • pip

Compatible Operating System

  • Windows 10 and later (not tested yet)
  • GNU/Linux

Unsupported OS

  • FreeBSD for now , until i found a solution to port it to FreeBSD it is currently Unsupported.
  • Android since Minecraft LCE is currently quite laggy and buggy on Android
  • MacOS since I cannot test it legally, but should work with POISX compatibility but it is not officially supported.

Code of Respect

License

GPLV3