Repository navigation
TOTK_ROMFS_EDITOR_V6.0.2
====================================================================
🗡️ TOTK ROMFS EDITOR – Version finale
Outil pour modifier les jeux Zelda (TotK, BotW, LA)
Windows x64 French Téléchargez le fichier .Zip ; Version Anglaise Coming soon
📌 À QUOI SERT CET OUTIL ?
Cet outil permet de modifier les fichiers internes des jeux
Zelda sur Switch (Tears of the Kingdom, Breath of the Wild,
Link's Awakening). Il est conçu pour être simple et intuitif,
même pour les débutants.
Avec lui, vous pouvez :
• Modifier les statistiques des armes, armures et objets
(dégâts, durabilité, prix, etc.)
• Changer les noms, descriptions et dialogues du jeu
• Activer ou désactiver des mods en un clic
• Appliquer des modifications en lot sur plusieurs fichiers
• Naviguer dans les archives .sarc, .zs et .pack
• Éditer visuellement les fichiers BYML (sans écrire de code)
🎮 JEUX COMPATIBLES
• Tears of the Kingdom (TotK) – par défaut
• Breath of the Wild (BotW) – sélectionnable dans l'interface
• Link's Awakening (LA_NS) – sélectionnable dans l'interface
⚙️ COMMENT UTILISER L'APPLICATION ?
- Lancez TOTK_Romfs_Editor.exe
- Choisissez votre jeu dans la barre d'outils (en haut)
- Cliquez sur "📂 Parcourir" pour ouvrir votre dossier ROMFS
- Dans l'arbre de fichiers, double-cliquez sur :
• Une archive (.sarc, .zs) → pour voir son contenu
• Un fichier (.byml, .msbt) → pour le modifier - Modifiez les valeurs, puis cliquez sur "💾 Sauvegarder"
- Les modifications sont immédiatement appliquées dans la ROMFS
⚠️ AVANT DE DUMPER VOTRE ROMFS
❗ ATTENTION : Pour que vos modifications fonctionnent,
vous DEVEZ activer les mises à jour (Updates) et les DLC
dans le gestionnaire de mods de votre émulateur (Citron, Ryujinx)
AVANT de dumper la ROMFS.
Sans cela, les fichiers modifiés risquent d'être incompatibles
avec votre version du jeu.
📁 OBTENIR UNE ROMFS
• Depuis Citron / Ryujinx :
Faites un clic droit sur le jeu → "Dump ROMFS"
(Assurez-vous que les Updates et DLC sont cochés)
• Depuis un Switch modifié :
Utilisez un outil comme NX-DumpTool ou hactool
🔧 FONCTIONNALITÉS DÉTAILLÉES
🏠 Accueil
→ Guide visuel pour bien commencer
📦 Gestionnaire de mods
→ Activez/désactivez vos mods en un clic
→ Détection automatique des conflits entre mods
⚡ Patch en lot
→ Modifiez des valeurs en masse (ex: augmenter la défense
de toutes les armures de 10)
→ Syntaxe simple : attack = 50, defense += 10, etc.
📝 Éditeur MSBT
→ Modifiez les textes du jeu (dialogues, noms, descriptions)
→ Coloration syntaxique pour une meilleure lisibilité
🔢 Éditeur visuel BYML
→ Modifiez les statistiques sans écrire de code
→ Cases à cocher, spinboxes, champs de texte
📂 Explorateur d'archives
→ Naviguez dans les fichiers .sarc, .zs, .pack
→ Extrayez et remplacez des fichiers en quelques clics
🔎 Recherche & remplacement
→ Trouvez du texte dans les fichiers ouverts
→ Remplacer en une ou plusieurs fois
📤 Export/Import MSBT par lot
→ Exportez tous les textes du jeu en .txt
→ Traduisez ou modifiez les fichiers dans un éditeur de texte
→ Réimportez en un clic
🛠️ COMPILATION (pour les développeurs)
Si vous souhaitez compiler l'outil depuis le code source :
- Installez Python 3.12
- Créez un environnement virtuel :
python -m venv venv
venv\Scripts\activate - Installez les dépendances :
pip install -r requirements.txt - Compilez avec PyInstaller :
pyinstaller --windowed --name "TOTK_Romfs_Editor" TOTK_ROMFS_EDITOR_FINAL.py - Copiez le fichier .pyd à côté de l'exe :
copy venv\Lib\site-packages\oead.cp312-win_amd64.pyd dist\TOTK_Romfs_Editor\oead.pyd
📦 CONTENU DU DOSSIER
TOTK_Romfs_Editor.exe → L'application principale
oead.pyd → Bibliothèque indispensable (à garder à côté de l'exe)
LISEZ_MOI.txt → Ce fichier d'instructions
❓ PROBLÈMES CONNUS ET SOLUTIONS
• L'application ne s'ouvre pas ou affiche une erreur oead ?
→ Vérifiez que le fichier oead.pyd est bien dans le même dossier que l'exe.
• La ROMFS ne s'ouvre pas ou les .zs sont illisibles ?
→ Assurez-vous que le fichier ZsDic.pack.zs est présent dans le dossier Pack/
de votre ROMFS. Sans ce fichier, les archives .zs ne peuvent pas être lues.
• Les modifications ne s'appliquent pas dans le jeu ?
→ Vérifiez que vous avez bien dumpé la ROMFS avec les Updates et DLC activés.
→ Assurez-vous que le jeu utilise bien la ROMFS modifiée (pas une copie cachée).
• L'application est lente ou rame ?
→ Les archives de plusieurs Go (comme Bootup.pack.zs) peuvent prendre du temps
à s'ouvrir. Soyez patient lors du premier chargement (le cache accélérera
les ouvertures suivantes).
📌 ASTUCES POUR LES DÉBUTANTS
• Pour modifier une armure, cherchez les fichiers Armor_*.byml
dans l'arborescence (ex: Armor_001.bgyml).
• Pour modifier une arme, cherchez les fichiers Weapon_*.byml.
• Pour modifier les textes, cherchez les fichiers .msbt.
• Utilisez le gestionnaire de mods pour activer/désactiver vos modifications
sans avoir à copier/coller des fichiers à la main.
• Le patch en lot est très pratique pour équilibrer tout le jeu d'un coup
(ex: augmenter les dégâts de toutes les épées de 20 %).
📜 LICENCE
Cet outil est distribué sous licence libre (GPLv2).
Il est fourni "tel quel", sans garantie.
Il est destiné à un usage personnel et éducatif.
L'utilisateur est responsable de l'utilisation qu'il fait de cet outil
et des modifications qu'il apporte aux jeux.
🆘 SUPPORT ET CONTRIBUTIONS
• Signaler un bug : https://github.com/toncompte/totk-romfs-editor/issues
• Proposer une amélioration : https://github.com/toncompte/totk-romfs-editor/pulls
• Documentation : https://github.com/toncompte/totk-romfs-editor/wiki
🙏 REMERCIEMENTS
• oead – pour la bibliothèque de parsing
• PyQt5 – pour l'interface graphique
• La communauté Zelda Modding – pour les retours et l'inspiration
• Claude IA , DeepSeek , Gemini Free Version
• Toi – pour avoir utilisé cet outil et contribué à son amélioration !