Skip to content

Releases

TOTK_ROMFS_EDITOR_V7.0_MULTILANGUES

Choose a tag to compare

@Renaf2 Renaf2 released this 26 Oct 21:03

🗡️ TOTK ROMFS EDITOR – Multi‑Language Edition

Version: 6.0.2 – Multilingual
Author: Renaf2
License: GPLv2
Repository: github.com/Renaf2/TOTK-ROMFS-EDITOR


🌍 About

TOTK ROMFS Editor is a powerful and intuitive graphical tool for modifying internal files of Zelda games on Nintendo Switch:

  • The Legend of Zelda: Tears of the Kingdom (TotK)
  • The Legend of Zelda: Breath of the Wild (BotW)
  • The Legend of Zelda: Link's Awakening (LA_NS)

It is designed to be accessible to beginners as well as advanced modders, with a clean interface and comprehensive features.


🌐 Available Languages

Language | Code | Flag -- | -- | -- English | en | 🇬🇧 Français | fr | 🇫🇷 Español | es | 🇪🇸 Deutsch | de | 🇩🇪 Italiano | it | 🇮🇹 Português (BR) | pt_BR | 🇧🇷 Русский | ru | 🇷🇺 日本語 | ja | 🇯🇵 简体中文 | zh_CN | 🇨🇳 繁體中文 | zh_TW | 🇹🇼 한국어 | ko | 🇰🇷

The language selector is located in the main toolbar.

Read more

TOTK_ROMFS_EDITOR_V6.0.3_MULTILINGUAL

Choose a tag to compare

@Renaf2 Renaf2 released this 05 Jul 16:31

🗡️ TOTK ROMFS EDITOR – Multi‑Language Edition

Version: 6.0.2 – Multilingual
Author: Renaf2
License: GPLv2
Repository: github.com/Renaf2/TOTK-ROMFS-EDITOR


🌍 About

TOTK ROMFS Editor is a powerful and intuitive graphical tool for modifying internal files of Zelda games on Nintendo Switch:

  • The Legend of Zelda: Tears of the Kingdom (TotK)
  • The Legend of Zelda: Breath of the Wild (BotW)
  • The Legend of Zelda: Link's Awakening (LA_NS)

It is designed to be accessible to beginners as well as advanced modders, with a clean interface and comprehensive features.


🌐 Available Languages

Language | Code | Flag -- | -- | -- English | en | 🇬🇧 Français | fr | 🇫🇷 Español | es | 🇪🇸 Deutsch | de | 🇩🇪 Italiano | it | 🇮🇹 Português (BR) | pt_BR | 🇧🇷 Русский | ru | 🇷🇺 日本語 | ja | 🇯🇵 简体中文 | zh_CN | 🇨🇳 繁體中文 | zh_TW | 🇹🇼 한국어 | ko | 🇰🇷

The language selector is located in the main toolbar.

Read more

TOTK_ROMFS_EDITOR_V6.0.2 MULTILINGUAL

Choose a tag to compare

@Renaf2 Renaf2 released this 30 Jun 16:02

🗡️ TOTK ROMFS EDITOR – Multi‑Language Edition

Version: 6.0.2 – Multilingual
Author: Renaf2
License: GPLv2
Repository: github.com/Renaf2/TOTK-ROMFS-EDITOR


🌍 About

TOTK ROMFS Editor is a powerful and intuitive graphical tool for modifying internal files of Zelda games on Nintendo Switch:

  • The Legend of Zelda: Tears of the Kingdom (TotK)
  • The Legend of Zelda: Breath of the Wild (BotW)
  • The Legend of Zelda: Link's Awakening (LA_NS)

It is designed to be accessible to beginners as well as advanced modders, with a clean interface and comprehensive features.


🌐 Available Languages

Language Code Flag
English en 🇬🇧
Français fr 🇫🇷
Español es 🇪🇸
Deutsch de 🇩🇪
Italiano it 🇮🇹
Português (BR) pt_BR 🇧🇷
Русский ru 🇷🇺
日本語 ja 🇯🇵
简体中文 zh_CN 🇨🇳
繁體中文 zh_TW 🇹🇼
한국어 ko 🇰🇷

The language selector is located in the main toolbar.


⚙️ Features

  • 📂 ROMFS File Explorer – full navigation through folders and archives
  • 📦 Archive Support: .sarc, .zs, .pack, .zip, .7z, .tar, .gz, .bz2, .xz
  • 📝 MSBT Editor – edit dialogues, names, and in‑game descriptions
  • 🔢 Visual BYML Editor – modify weapon, armor, and item stats without writing code
  • 🧩 Mod Manager – enable/disable mods with one click, automatic conflict detection
  • ⚡ Batch Patching – mass‑edit values (e.g., attack = 50 across all files)
  • 🔍 Find & Replace – inside open files
  • 📤 Batch MSBT Export/Import – translate or edit all texts in one operation
  • 🌍 Multilingual Interface – 11 languages built in, switchable on the fly
  • 💾 Language Persistence – your preference is saved between sessions

🛠️ Installation

📦 Prerequisites

  • Python 3.11.9 (64‑bit) – Download
  • Visual C++ Redistributable 2015‑2022 (x64) – Download

🖥️ Steps

  1. Download the full application folder from GitHub.

  2. Open a terminal in the application folder.

  3. Create a virtual environment:

    python -m venv venv

TOTK_ROMFS_EDITOR_V6.0.2_ENGLISH

Choose a tag to compare

@Renaf2 Renaf2 released this 22 Jun 17:56

====================================================================
🗡️ TOTK ROMFS EDITOR – Final Version
Tool for modifying Zelda games (TotK, BotW, LA)

Windows x64 French Download the .Zip file ; English Version Coming soon

📌 WHAT IS THIS TOOL FOR?

This tool allows you to modify the internal files of Zelda
games on Switch (Tears of the Kingdom, Breath of the Wild,
Link's Awakening). It is designed to be simple and intuitive,
even for beginners.

With it, you can:
• Modify weapon, armor and item statistics
(damage, durability, price, etc.)
• Change in-game names, descriptions and dialogues
• Activate or deactivate mods with one click
• Apply modifications in batch across multiple files
• Navigate through .sarc, .zs and .pack archives
• Visually edit BYML files (without writing code)

🎮 COMPATIBLE GAMES

• Tears of the Kingdom (TotK) – default
• Breath of the Wild (BotW) – selectable in the interface
• Link's Awakening (LA_NS) – selectable in the interface

⚙️ HOW TO USE THE APPLICATION?

  1. Launch TOTK_Romfs_Editor.exe
  2. Choose your game from the toolbar (at the top)
  3. Click on "📂 Browse" to open your ROMFS folder
  4. In the file tree, double-click on:
    • An archive (.sarc, .zs) → to view its content
    • A file (.byml, .msbt) → to edit it
  5. Modify the values, then click "💾 Save"
  6. Changes are immediately applied to the ROMFS

⚠️ BEFORE DUMPING YOUR ROMFS

❗ WARNING: For your modifications to work,
you MUST enable Updates and DLC
in your emulator's mod manager (Citron, Ryujinx)
BEFORE dumping the ROMFS.

Without this, modified files may be incompatible
with your game version.

📁 OBTAINING A ROMFS

• From Citron / Ryujinx:
Right-click on the game → "Dump ROMFS"
(Make sure Updates and DLC are checked)

• From a modded Switch:
Use a tool like NX-DumpTool or hactool

🔧 DETAILED FEATURES

🏠 Home
→ Visual guide to get started

📦 Mod Manager
→ Activate/deactivate your mods with one click
→ Automatic conflict detection between mods

⚡ Batch Patch
→ Modify values in bulk (e.g.: increase defense
of all armors by 10)
→ Simple syntax: attack = 50, defense += 10, etc.

📝 MSBT Editor
→ Edit game texts (dialogues, names, descriptions)
→ Syntax highlighting for better readability

🔢 Visual BYML Editor
→ Modify statistics without writing code
→ Checkboxes, spinboxes, text fields

📂 Archive Explorer
→ Browse through .sarc, .zs, .pack files
→ Extract and replace files in a few clicks

🔎 Find & Replace
→ Find text in open files
→ Replace one or multiple times

📤 Batch MSBT Export/Import
→ Export all game texts to .txt
→ Translate or modify files in a text editor
→ Re-import with one click

🛠️ COMPILATION (for developers)

If you wish to compile the tool from source code:

  1. Install Python 3.12
  2. Create a virtual environment:
    python -m venv venv
    venv\Scripts\activate
  3. Install dependencies:
    pip install -r requirements.txt
  4. Compile with PyInstaller:
    pyinstaller --windowed --name "TOTK_Romfs_Editor" TOTK_ROMFS_EDITOR_FINAL.py
  5. Copy the .pyd file next to the exe:
    copy venv\Lib\site-packages\oead.cp312-win_amd64.pyd dist\TOTK_Romfs_Editor\oead.pyd

📦 FOLDER CONTENTS

TOTK_Romfs_Editor.exe → The main application
oead.pyd → Essential library (must be kept next to the exe)
README.txt → This instructions file

❓ KNOWN ISSUES AND SOLUTIONS

• The application does not open or shows an oead error?
→ Make sure the oead.pyd file is in the same folder as the exe.

• ROMFS does not open or .zs files are unreadable?
→ Ensure that the ZsDic.pack.zs file is present in the Pack/
folder of your ROMFS. Without this file, .zs archives cannot be read.

• Changes do not apply in the game?
→ Make sure you dumped the ROMFS with Updates and DLC enabled.
→ Ensure the game is using the modified ROMFS (not a hidden copy).

• The application is slow or laggy?
→ Archives of several GB (like Bootup.pack.zs) can take time
to open. Be patient during the first load (caching will speed up
subsequent openings).

📌 TIPS FOR BEGINNERS

• To modify armor, look for Armor_*.byml files
in the file tree (e.g.: Armor_001.bgyml).

• To modify weapons, look for Weapon_*.byml files.

• To modify texts, look for .msbt files.

• Use the Mod Manager to activate/deactivate your modifications
without having to manually copy/paste files.

• The Batch Patch is very useful for balancing the entire game at once
(e.g.: increase damage of all swords by 20%).

📜 LICENSE

This tool is distributed under an open-source license (GPLv2).
It is provided "as is", without any warranty.
It is intended for personal and educational use.

The user is responsible for their use of this tool
and any modifications they make to the games.

🆘 SUPPORT AND CONTRIBUTIONS

• Report a bug: https://github.com/yourusername/totk-romfs-editor/issues
• Suggest an improvement: https://github.com/yourusername/totk-romfs-editor/pulls
• Documentation: https://github.com/yourusername/totk-romfs-editor/wiki

🙏 ACKNOWLEDGMENTS

• oead – for the parsing library
• PyQt5 – for the graphical interface
• The Zelda Modding community – for feedback and inspiration
• Claude AI, DeepSeek, Gemini Free Version
• You – for using this tool and helping improve it!

====================================================================
Happy modding, and have fun! 🗡️

TOTK_ROMFS_EDITOR_V6.0.2

Choose a tag to compare

@Renaf2 Renaf2 released this 22 Jun 17:46

====================================================================
🗡️ 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 ?

  1. Lancez TOTK_Romfs_Editor.exe
  2. Choisissez votre jeu dans la barre d'outils (en haut)
  3. Cliquez sur "📂 Parcourir" pour ouvrir votre dossier ROMFS
  4. Dans l'arbre de fichiers, double-cliquez sur :
    • Une archive (.sarc, .zs) → pour voir son contenu
    • Un fichier (.byml, .msbt) → pour le modifier
  5. Modifiez les valeurs, puis cliquez sur "💾 Sauvegarder"
  6. 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 :

  1. Installez Python 3.12
  2. Créez un environnement virtuel :
    python -m venv venv
    venv\Scripts\activate
  3. Installez les dépendances :
    pip install -r requirements.txt
  4. Compilez avec PyInstaller :
    pyinstaller --windowed --name "TOTK_Romfs_Editor" TOTK_ROMFS_EDITOR_FINAL.py
  5. 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 !

====================================================================
Bon modding, et amusez-vous bien ! 🗡️

TOTK_ROMFS_EDITOR_V6.0.0_OEAD_ENGLISH_VERSION

Choose a tag to compare

====================================================================
🗡️ TOTK ROMFS EDITOR – Final Version
Tool for modifying Zelda games (TotK, BotW, LA)

Windows x64 French Download the .Zip file ; English Version Coming soon

📌 WHAT IS THIS TOOL FOR?

This tool allows you to modify the internal files of Zelda
games on Switch (Tears of the Kingdom, Breath of the Wild,
Link's Awakening). It is designed to be simple and intuitive,
even for beginners.

With it, you can:
• Modify weapon, armor and item statistics
(damage, durability, price, etc.)
• Change in-game names, descriptions and dialogues
• Activate or deactivate mods with one click
• Apply modifications in batch across multiple files
• Navigate through .sarc, .zs and .pack archives
• Visually edit BYML files (without writing code)

🎮 COMPATIBLE GAMES

• Tears of the Kingdom (TotK) – default
• Breath of the Wild (BotW) – selectable in the interface
• Link's Awakening (LA_NS) – selectable in the interface

⚙️ HOW TO USE THE APPLICATION?

  1. Launch TOTK_Romfs_Editor.exe
  2. Choose your game from the toolbar (at the top)
  3. Click on "📂 Browse" to open your ROMFS folder
  4. In the file tree, double-click on:
    • An archive (.sarc, .zs) → to view its content
    • A file (.byml, .msbt) → to edit it
  5. Modify the values, then click "💾 Save"
  6. Changes are immediately applied to the ROMFS

⚠️ BEFORE DUMPING YOUR ROMFS

❗ WARNING: For your modifications to work,
you MUST enable Updates and DLC
in your emulator's mod manager (Citron, Ryujinx)
BEFORE dumping the ROMFS.

Without this, modified files may be incompatible
with your game version.

📁 OBTAINING A ROMFS

• From Citron / Ryujinx:
Right-click on the game → "Dump ROMFS"
(Make sure Updates and DLC are checked)

• From a modded Switch:
Use a tool like NX-DumpTool or hactool

🔧 DETAILED FEATURES

🏠 Home
→ Visual guide to get started

📦 Mod Manager
→ Activate/deactivate your mods with one click
→ Automatic conflict detection between mods

⚡ Batch Patch
→ Modify values in bulk (e.g.: increase defense
of all armors by 10)
→ Simple syntax: attack = 50, defense += 10, etc.

📝 MSBT Editor
→ Edit game texts (dialogues, names, descriptions)
→ Syntax highlighting for better readability

🔢 Visual BYML Editor
→ Modify statistics without writing code
→ Checkboxes, spinboxes, text fields

📂 Archive Explorer
→ Browse through .sarc, .zs, .pack files
→ Extract and replace files in a few clicks

🔎 Find & Replace
→ Find text in open files
→ Replace one or multiple times

📤 Batch MSBT Export/Import
→ Export all game texts to .txt
→ Translate or modify files in a text editor
→ Re-import with one click

🛠️ COMPILATION (for developers)

If you wish to compile the tool from source code:

  1. Install Python 3.12
  2. Create a virtual environment:
    python -m venv venv
    venv\Scripts\activate
  3. Install dependencies:
    pip install -r requirements.txt
  4. Compile with PyInstaller:
    pyinstaller --windowed --name "TOTK_Romfs_Editor" TOTK_ROMFS_EDITOR_FINAL.py
  5. Copy the .pyd file next to the exe:
    copy venv\Lib\site-packages\oead.cp312-win_amd64.pyd dist\TOTK_Romfs_Editor\oead.pyd

📦 FOLDER CONTENTS

TOTK_Romfs_Editor.exe → The main application
oead.pyd → Essential library (must be kept next to the exe)
README.txt → This instructions file

❓ KNOWN ISSUES AND SOLUTIONS

• The application does not open or shows an oead error?
→ Make sure the oead.pyd file is in the same folder as the exe.

• ROMFS does not open or .zs files are unreadable?
→ Ensure that the ZsDic.pack.zs file is present in the Pack/
folder of your ROMFS. Without this file, .zs archives cannot be read.

• Changes do not apply in the game?
→ Make sure you dumped the ROMFS with Updates and DLC enabled.
→ Ensure the game is using the modified ROMFS (not a hidden copy).

• The application is slow or laggy?
→ Archives of several GB (like Bootup.pack.zs) can take time
to open. Be patient during the first load (caching will speed up
subsequent openings).

📌 TIPS FOR BEGINNERS

• To modify armor, look for Armor_*.byml files
in the file tree (e.g.: Armor_001.bgyml).

• To modify weapons, look for Weapon_*.byml files.

• To modify texts, look for .msbt files.

• Use the Mod Manager to activate/deactivate your modifications
without having to manually copy/paste files.

• The Batch Patch is very useful for balancing the entire game at once
(e.g.: increase damage of all swords by 20%).

📜 LICENSE

This tool is distributed under an open-source license (GPLv2).
It is provided "as is", without any warranty.
It is intended for personal and educational use.

The user is responsible for their use of this tool
and any modifications they make to the games.

🆘 SUPPORT AND CONTRIBUTIONS

• Report a bug: https://github.com/yourusername/totk-romfs-editor/issues
• Suggest an improvement: https://github.com/yourusername/totk-romfs-editor/pulls
• Documentation: https://github.com/yourusername/totk-romfs-editor/wiki

🙏 ACKNOWLEDGMENTS

• oead – for the parsing library
• PyQt5 – for the graphical interface
• The Zelda Modding community – for feedback and inspiration
• Claude AI, DeepSeek, Gemini Free Version
• You – for using this tool and helping improve it!

====================================================================
Happy modding, and have fun! 🗡️

TOTK_ROMFS_EDITOR_V6.0.0_OEAD

Choose a tag to compare

@Renaf2 Renaf2 released this 17 Jun 21:53

====================================================================
🗡️ 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 ?

  1. Lancez TOTK_Romfs_Editor.exe
  2. Choisissez votre jeu dans la barre d'outils (en haut)
  3. Cliquez sur "📂 Parcourir" pour ouvrir votre dossier ROMFS
  4. Dans l'arbre de fichiers, double-cliquez sur :
    • Une archive (.sarc, .zs) → pour voir son contenu
    • Un fichier (.byml, .msbt) → pour le modifier
  5. Modifiez les valeurs, puis cliquez sur "💾 Sauvegarder"
  6. 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 :

  1. Installez Python 3.12
  2. Créez un environnement virtuel :
    python -m venv venv
    venv\Scripts\activate
  3. Installez les dépendances :
    pip install -r requirements.txt
  4. Compilez avec PyInstaller :
    pyinstaller --windowed --name "TOTK_Romfs_Editor" TOTK_ROMFS_EDITOR_FINAL.py
  5. 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 !

====================================================================
Bon modding, et amusez-vous bien ! 🗡️

TOTK_ROMFS_EDITOR_V5.0.0

Choose a tag to compare

@Renaf2 Renaf2 released this 16 Jun 04:34

Concrètement, cette application est un couteau suisse pour modifier les fichiers internes des jeux Zelda sur Switch (Tears of the Kingdom, Breath of the Wild, Link's Awakening).

Elle est conçue pour les débutants comme pour les moddeurs avertis. Voici ce que tu peux vraiment faire avec une fois que tu as ouvert ton dossier ROMFS :

  1. Modifier les stats des équipements (le plus cool !)

Grâce à l'éditeur visuel BYML (la grosse nouveauté qu'on a ajoutée) :

· Double-clique sur un fichier d'armure (ex: Armor_001.bgyml).
· Au lieu d'un charabia en JSON ou en Hexadécimal, l'application t'affiche un tableau propre avec des cases à cocher et des chiffres.
· Tu peux changer en 2 clics les prix, les dégâts, la défense, la durabilité d'une arme, ou décider si un objet est équipable ou non. Sans écrire une ligne de code.

  1. Traduire le jeu (ou modifier les dialogues)

· Tu ouvres un fichier .msbt (ce sont les textes du jeu : dialogues, noms d'objets, descriptions).
· L'outil le transforme en un simple fichier .txt.
· Tu modifies le texte dans le bloc-notes, tu réimportes le fichier, et le jeu affiche ta traduction ou tes blagues perso.
· Il y a même un mode Export/Import par lot pour modifier des milliers de fichiers de texte d'un coup.

  1. Explorer les archives "cachées"

· Les jeux Nintendo compressent tout dans des fichiers .sarc ou .zs (avec des dictionnaires Zstd).
· Ton application navigue dedans comme dans l'Explorateur Windows : tu double-cliques sur une archive, tu vois le contenu, tu extrais un fichier ou tu le modifies directement.

  1. Comparer des fichiers

· Tu as un doute sur ce qui a changé entre deux versions d'un même fichier .msbt ? L'application affiche une vue côte-à-côte pour que tu voies les différences.

  1. Le mode "Bricolage" (Hexadécimal et JSON)

· Si l'éditeur visuel ne reconnaît pas un fichier, tu peux quand même l'ouvrir en mode Hexadécimal (pour les bidouilleurs) ou en JSON (pour les puristes) pour modifier des valeurs brutes.

TOTK_ROMFS_EDITOR_ENGLISH_V4.0.0_ALPHA

Choose a tag to compare

@Renaf2 Renaf2 released this 15 Jun 17:37
Merge branch 'main' of https://github.com/Renaf2/TOTK-ROMFS-EDITOR

TOTK_ROMFS_EDITOR_V4.0.0_ALPHA

Choose a tag to compare

@Renaf2 Renaf2 released this 15 Jun 17:47
Merge branch 'main' of https://github.com/Renaf2/TOTK-ROMFS-EDITOR