Repository navigation
TOTK_ROMFS_EDITOR_V6.0.2_ENGLISH
====================================================================
๐ก๏ธ 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?
- Launch TOTK_Romfs_Editor.exe
- Choose your game from the toolbar (at the top)
- Click on "๐ Browse" to open your ROMFS folder
- In the file tree, double-click on:
โข An archive (.sarc, .zs) โ to view its content
โข A file (.byml, .msbt) โ to edit it - Modify the values, then click "๐พ Save"
- 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:
- Install Python 3.12
- Create a virtual environment:
python -m venv venv
venv\Scripts\activate - Install dependencies:
pip install -r requirements.txt - Compile with PyInstaller:
pyinstaller --windowed --name "TOTK_Romfs_Editor" TOTK_ROMFS_EDITOR_FINAL.py - 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!