Présentation du projet
Leonida est un projet de recompilation statique qui permet d’exécuter la version Xbox Series de Grand Theft Auto VI sur un ordinateur Windows ou Linux. Le processeur de la Xbox Series utilise une architecture x86‑64 identique à celle d’un PC, ce qui autorise le chargement et l’exécution native du code du jeu. Le logiciel système de la console est ré‑implémenté, tandis que les programmes GPU pré‑compilés en RDNA2 sont traduits en SPIR‑V pour l’API Vulkan.
Architecture de recompilation
Le pipeline repose sur plusieurs étapes distinctes. D’abord, le répertoire du jeu – contenant MicrosoftGame.Config et les archives .rpf – est détecté automatiquement dans les dossiers usuels (Desktop, Documents, etc.) ou fourni manuellement. Ensuite, les shaders RDNA2 sont désassemblés puis convertis en SPIR‑V grâce à llvm‑mc (LLVM 21+ avec la cible AMDGPU) et aux outils du Vulkan SDK. La traduction gère notamment l’émulation wave64 : les GPU NVIDIA et Intel, qui n’offrent que des sous‑groupes de 32 threads, reçoivent une version adaptée, tandis que les cartes AMD natives conservent le format 64‑wide. Cette décision s’appuie sur la sortie de vulkaninfo et est mémorisée à côté des shaders traduits.
Les actifs (modèles, textures, audio) sont extraits directement depuis le package Xbox et copiés dans le répertoire de travail (Documents\Leonida). Le décodage audio utilise ffmpeg pour transformer les flux XMA2 en Ogg Opus, ou, avec l’option --wav, en PCM WAV, ce qui augmente la taille des fichiers de plusieurs fois.
Processus de construction et contraintes
Le build s’effectue via le script Build.bat ou en ligne de commande Python. Exemple d’initialisation :
git clone --recursive https://github.com/ItsNotRexed/Leonida
python -I make_game.py --find
python -I make_game.py --game "D:\path\to\package" --out "D:\Games\Leonida" --work "E:\leonida-work"Les prérequis comprennent Windows 10/11 x64 avec au moins 350 GB d’espace libre, Python 3.12+, .NET 8 SDK, Vulkan SDK, LLVM 21+, Visual Studio 2022 (Desktop C++), et éventuellement ffmpeg. Sur Linux, seules les chaînes LLVM et Vulkan sont nécessaires, mais le stade d’exécution reste limité à Windows.
Les étapes du pipeline sont exécutées dans l’ordre : vérification, traduction des shaders, extraction des actifs, génération du runtime, puis création des pipelines Vulkan. La traduction des shaders représente le maillon le plus long, utilisant par défaut la moitié des threads CPU disponibles. Le cache de pipelines créé lors de la première exécution évite une recompilation complète au démarrage suivant.
Limites et perspectives
Le projet est encore en phase précoce : le jeu ne démarre pas tant qu’un exécutable Xbox n’est pas disponible. Toutes les opérations réalisées ne modifient pas les fichiers originaux du jeu ; elles restent confinées au répertoire de travail. Aucun mécanisme de contournement de protection n’est fourni, ce qui implique que l’utilisateur doit posséder légalement le package Xbox version 1.0.2.1.
Les parties ouvertes comprennent la traduction du vertex shader et l’optimisation du runtime pour les GPU non‑AMD. Le design du traducteur, détaillé dans docs/design.md, spécifie les conventions d’utilisation des registres SGPR, des constantes push et du modèle mémoire, ce qui pourra guider de futures améliorations. En l’état, Leonida offre une base fonctionnelle pour tester la portabilité du code Xbox vers Vulkan, tout en exposant les défis liés à la conversion de shaders RDNA2 et à la gestion des sous‑groupes de calcul.