SmashRecomp

Recompilation statique de Super Smash Bros. for Wii U en programme natif pour macOS, Windows et Linux (Steam Deck compris), avec un mode en ligne sur serveur privé.

Ce dépôt ne contient aucun fichier du jeu. Ni l'exécutable, ni les données (modèles, textures, sons, musiques, vidéos), ni le code recompilé à partir de l'exécutable du jeu, ni les mises à jour ou contenus téléchargeables de Nintendo. Chaque joueur doit fournir le dump de sa propre copie du jeu, réalisé depuis sa propre console Wii U. SmashRecomp n'est ni un crack, ni une copie du jeu, et ne permet pas de jouer sans posséder le jeu.

This repository contains no game files. Every player must provide a dump of their own copy of the game, made from their own Wii U console.

Ce que contient le dépôt

Dossier	Contenu
recomp/recompiler	Recompilateur PowerPC → C++ (Python)
recomp/runtime	Macros du code généré
recomp/mods	Mods du jeu (menu principal, SR Settings, combattants de base débloqués)
recomp/tools	Outils d'analyse (RPX, désassemblage, textes MSBT)
thirdparty/cemu	Runtime basé sur Cemu (MPL-2.0), modifié pour SmashRecomp
online	Serveur en ligne auto-hébergeable (service de comptes + serveur de jeu Pretendo, Docker)
packaging	Construction des versions macOS (DMG), Linux (AppImage) et Windows (zip)

Les dossiers ROMS/, recomp/dump/ et recomp/generated/ sont exclus du dépôt (.gitignore) : ils contiennent des données du jeu et ne doivent jamais être publiés.

Ce qu'il faut pour jouer

• Le dump européen du jeu avec la mise à jour 1.1.7 (v304) : dossier du jeu (0005000010145000) et de la mise à jour (0005000E10145000). Le code recompilé correspond exactement à cet exécutable ; l'installateur le vérifie.
• Une manette ou le clavier.

Au premier lancement, l'installateur demande les dossiers du dump. Les réglages (compte en ligne, amis, affichage, son, manettes, mises à jour) sont dans le jeu : bouton SR Settings du menu principal.

Compiler

Cloner avec les dépendances du runtime : git clone --recursive git@github.com:ShadowHedgehog76/SmashRecomp.git

Le code recompilé est produit sur la machine du développeur à partir de son propre dump :

1. Extraire l'image chargée du jeu : lancer le runtime avec SMASHRECOMP_DUMP=recomp/dump.
2. python3 recomp/recompiler/recompile.py recomp/dump cross_f <cross_f.rpx de la mise à jour> recomp/generated
3. Compiler thirdparty/cemu avec -DSMASHRECOMP_GENERATED_DIR=<chemin>/recomp/generated.

Détails : recomp/NOTES.md, packaging/ (Docker pour Linux et Windows).

Compilation sur GitHub

Le workflow .github/workflows/build.yml compile les trois versions sur les machines de GitHub ; une étiquette vX.Y.Z publie la release. Le code recompilé y est régénéré à partir d'un dump chiffré déposé dans un dépôt privé (jamais dans celui-ci) :

1. packaging/ci/pack-dump.sh "<dossier de la mise à jour 0005000E10145000>" crée packaging/out/smashrecomp-dump.tar.xz.enc et la clé ~/.smashrecomp-ci-key.
2. Déposer ce fichier à la racine du dépôt privé (DUMP_REPO).
3. Secrets du dépôt : SMASHRECOMP_DUMP_KEY (la clé) et DUMP_TOKEN (jeton en lecture sur le dépôt privé).

Mises à jour

Au démarrage, SmashRecomp compare sa version aux releases de ce dépôt et signale une nouvelle version (SR Settings > Mise à jour). Seul SmashRecomp est concerné : le jeu n'est jamais téléchargé.

Licences

• Runtime (thirdparty/cemu) : MPL-2.0, comme Cemu.
• Serveur de jeu en ligne : Pretendo Network (AGPL-3.0), avec le correctif de online/server/patches.
• Super Smash Bros. for Wii U est une marque et une œuvre de Nintendo. Ce projet n'est ni affilié à Nintendo ni approuvé par Nintendo.