File replacement mod for Xenoblade 3

This mod allows you to load custom files, replacing the game's defaults.
This works with any and no DLC packs installed/loaded.

Important: While this mod does not deal with persistent data, you are still using it at your own risk. I am not responsible for anything that could happen to your saves, game, console, account, etc.

Usage

Switch

1. Download the latest version of the mod from the Releases page.
2. Extract the archive to root of your SD card.

Note for macOS users

When performing file operations on files stored on the SD card, macOS may set an attribute bit known as the "archive" bit. This attribute is not supported by Atmosphere's LayeredFS, so if your files are not being replaced, this might be something worth looking into. To unset the archive bit, you can use Hekate as described in this guide. I recommend changing only the affected directories, as to not interfere with files created by the console.
Alternatively you can transfer files via FTP using ftpd.

Ryujinx

1. Download the latest version of the mod from the Releases page.
2. Open Ryujinx, then right-click on the game and select "Open Atmosphere Mods Directory".
3. From the archive, extract the exefs and romfs directories into the folder you opened.

Yuzu

1. Download the latest version of the mod from the Releases page.
   Note: the version-edit mod file is not supported on Yuzu.
2. Open Yuzu, then right-click on the game and select "Open Mod Data Location".
3. In the directory you just opened, create a folder called file-loader (or any name of your choice).
4. From the archive, extract the exefs and romfs directories into this new folder. (If using xenomods, copy only romfs.)
5. Go back to the mod data location, then create folders for each file replacement mod you want to install, for example you can have a my-bdat-swap-1 folder.
6. Inside this new folder, create a romfs folder, and copy your new files there. (see the next section)

Note: You can also place everything in a single mod directory, but Yuzu has a nice way to disable mods on demand. Note that Yuzu caches RomFS contents, so you should restart the emulator after you make changes (not just the game).

Replacing files

After installing the mod, you can place your custom files in the /atmosphere/contents/010074f013262000/romfs/ folder (this is different on Yuzu, see above).
This mod enables loading files that would normally be overwritten by the game's archives.

Build instructions

To build the project, install Rust and run

./build.sh

License

This mod is distributed under the terms of the GPLv3. See COPYING for details.