LCE-Qt-Launcher/lisezmoi.md

LCE Qt Launcher

Version anglaise

Warning

Ce lanceur est en cours de développement et ses fonctionnalités peuvent être modifiées ou supprimées à tout moment. Les contributions (PR) sont les bienvenues pour corriger ou ajouter des fonctionnalités. Veuillez respecter la licence GPLv3 et le Code de conduite.

À propos

Il s'agit d'un lanceur LCE personnalisé pour Minecraft, écrit en Python et Qt avec Freedom et conçu pour GNU/Linux.

Pourquoi le lanceur LCE Qt ?

• Développé en Python avec Qt 6 : léger et compatible avec le thème Plasma 6/Qt 6 de GNU/Linux
• Personnalisation avec les thèmes et les modules/plugins (prochainement)
• Intégration avec les outils communautaires
• Compatibilité GNU/Linux optimale
• Licence copyleft (GPLv3), donc sans big tech
• Gratuit comme Freedom Launcher
• Thème Minecraft par défaut

Fonctionnalités

• Interface en ligne de commande (CLI)
• Prise en charge de plusieurs instances (en cours de développement)
• Instances préconfigurées :
  • MCLCE/MinecraftConsoles (anciennement smartcmd/MinecraftConsoles)
  • LegacyEvolved (sera bientôt supprimé car remplacé par NeoLegacy)
  • NeoLegacy
• Places de marché / Workshop :
  • Atelier du lanceur Emeralds de LCE Hub
  • LegacyMods (bientôt disponible)
• Actualités intégrées

Objectif à long terme / Feuille de route

• Accessibilité
• Prise en charge des mods
• Plugins pour le lanceur
• Prise en charge des thèmes
• Compatibilité GNU/Linux
• Prise en charge de Windows
• Prise en charge des localisations
• Prise en charge expérimentale de FreeBSD et Nix/NixOS
• Devenir la plateforme principale pour Minecraft LCE sur GNU/Linux

Comment exécuter

VSCode

Note

Sous Windows, remplacez / par \. [!WARNING] Cette méthode n'est ni recommandée ni testée pour NixOS. Consultez la section NixOS pour la procédure spécifique à ce système d'exploitation.

1. Créez un environnement virtuel Python à l'aide d'un outil comme UV (si ce n'est pas déjà fait).
2. Configurez VS Code pour utiliser cet environnement virtuel Python.
3. Exécutez « PySide : Sync Virtual Env and Launch ».
4. Exécutez l'application via le mode débogage de VS Code ou directement le fichier src/lce_qt_launcher/main.py.

NixOS

1. Lancez le shell Nix avec la commande nix-shell.
2. Compilez l'interface utilisateur et le fichier de ressources avec scripts/build.sh.
3. Executé l'application avec python src/lce_qt_launcher/main.py.

Utilisation de la ligne de commande

1. Créez l'environnement virtuel avec uv (uv sync).
2. Chargez l'environnement virtuel avec source .venv/bin/activate.sh (remplacez .sh par votre interpréteur de commandes ; sous Windows, il s'agit de .venv\Scripts\activate.ps1 pour PowerShell ou de .venv\Scripts\activate.bat pour l'invite de commandes).
3. Exécutez scripts/build.sh (pour Linux) ou scripts\build.cmd (pour Windows).
4. Exécutez le script Python principal src/lce_qt_launche.py (sous Windows, vous devrez peut-être appeler python3 directement et remplacer / par \).

Comment compiler

Compilation portable avec Nuitka

0. Créez un environnement virtuel Python avec un outil comme UV (si ce n'est pas déjà fait).
1. Exécutez hatch run packages.

Arch Linux

1. Accédez au répertoire packages/linux.
2. Choisissez un canal : dev, nightly ou stable (accédez au répertoire correspondant).
3. Exécutez makepkg -si ou makepkg -s (pour une installation sans paquets) dans l'un de ces répertoires.

Paquet Nix

Nixpkg

Exécutez nix-build default.nix

Windows Installer

Prérequis :

Inno Setup 6.6+

1. Accédez au répertoire des paquets Windows : cd packages/windows
2. Exécutez le script avec Inno Setup pour le canal souhaité (setup-nightly.iss ou setup.iss)

FreeBSD

1. Accédez au répertoire des ports FreeBSD : cd freebsd-ports
2. Exécutez le script d'installation : install

Flatpak

Note

Pour flatpak, le build manual n'est recommender uniquement pour des raisons de développements ou pour les forks qui n'ont pas de repo flatpak. Pour le moment, c'est la seule méthode puisque le repo flatpak officiel n'est pad encore activé. Une fois actvé cette partie de notice serait enlever, et il serait donc recommender d'utiliser le répo flatpak et il serait afficher ici

1. Accédez au répertoire du manifeste Flatpak : cd packages/flatpak
2. Compilez Flatpak : flatpak-builder --user --install build-dir io.github.xgui4.lce_qt_launcher.yml --install-deps-from=flathub

Versions Quotidiennes (Nightly Release)

Note

Cette branche/Version n'est pas stable et des modifications y sont apportées presque quotidiennement ; elle peut donc parfois dysfonctionner. De plus, macOS n'est pas disponible dans la compilation nocturne en raison des restrictions d'Apple et du fait que je ne possède pas de Mac.

Sur cette page GitHub Release, vous trouverez les versions nightly, générées automatiquement via GitHub Actions lors de modifications apportées à la branche nighly.

Configuration logicielle requise

• Python 3.11 (pour FreeBSD) à Python 3.12 (GNU/Linux, Windows et macOS)
• Un environnement virtuel avec les bibliothèques requises installées (spécifiées dans le fichier README et le fichier pyproject.toml)
• PySide6
• Police Monocraft installée
• Pour les systèmes de type UNIX
  • Un serveur d'affichage ou un compositeur (sauf sur macOS où un serveur propriétaire est utilisé).
  • Bash (normalement préinstallé sous Linux, mais souvent requis sous *BSD et macOS)

Bibliothèques et outils Python utilisés

• PySide 6
• platformdirs
• rich
• hatch
• uv

Systèmes d'exploitation compatibles

Compatibilité officielle

Plateformes testées régulièrement et avec implémentation/correctif finalisé

• Windows 10 et versions ultérieures
• GNU/Linux

Compatibilité expérimentale

Plateforme testée avec implémentation en cours de developement

• NixOS
• FreeBSD

Plateformes prises en charge partiellement

Plateformes non testées, mais avec implémentation

• Flatpak

Systèmes d'exploitation non pris en charge

Ces plateformes n'ont pas été testées et leur fonctionnement n'est pas garantis :

• Autres systèmes *BSD, car Minecraft LCE n'est pas pris en charge sur ces systèmes et Wine n'est pas disponible.
• Minecraft LCE sur Android est actuellement assez lent et bogué.
• macOS : LCE Qt Launcher ne prend pas officiellement en charge macOS et n'est pas testé lors des contributions, mais la compatibilité POISX devrait permettre son utilisation.

Remerciements particuliers à

• Prism Launcher pour certains éléments et fichiers d'interface utilisateur
• MCLCE/MinecraftConsoles aftConsoles) pour le portage du jeu sur PC
• pieeebot/neoLegacy pour la rétrocompatibilité des mises à jour pour le portage PC
• LCE Hub pour la Marketplace/Workshop
• HellishEnds - maintenant DCMA, il est donc supprimé/indisponible pour le moment
• 360Revived - maintenant DCMA, donc supprimé/inutilisable pour le moment

Code de conduite

• Anglais
• Français

Licence

GPLv3