XCXDE-ModLoader

KO | EN

gitlite — search

#python #java #python3 #arduino #golang #machine-learning #rust #html #flask #javascript #seismology #nodejs

XCXDE-ModLoader

★ 17 Open GitHub ↗

exlaunch plugin for loading files outside of sts.ard in Xenoblade Chronicles X: Definitive Edition

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Xenoblade Chronicles X: Definitive Edition Mod Loader
Exlaunch plugin that allows loading files outside of sts.ard/sts.arh.<br>
Additionally allows loading BGM wem files outside of Music.pck without need to edit bgm.bnk to update loops.

Only for Western release, version 1.0.1, 1.0.2 and 2.0.0 (TID: `0100453019AA8000`)

# How to install:
1. Download latest release
2. Copy `atmosphere` folder to root of your sdcard

For emulators read guide specific to your emulator about how to install mods.

# How to use:
Copy your files in the same folder tree to
```
atmosphere/contents/0100453019AA8000/romfs/mod/
```
If any folder doesn't exist, create it manually.

So for example if you modified "lib_nx.ini" that is in "monolib/shader", whole path should look like this:
```
atmosphere/contents/0100453019AA8000/romfs/mod/monolib/shader/lib_nx.ini
```

# How to modify sound files:
First we need to unpack Music.pck. You can use this Python 3 script [HERE](https://github.com/masagrator/NXGameScripts/blob/main/XenobladeChroniclesX/pck_unpack_digits.py)<br>
Download it to the same folder where you copied Music.pck (you can find it in romfs/sound folder)<br>
Example of use in Command Prompt:
```
python pck_unpack_digits.py Music.pck
```
This will create new folder "Music" with BANKS and STREAMS folders. Look only for files in STREAMS folder.
As we don't know what names are hidden under hashes used for .wem files, there is no easy way to determine which song is which. For discussion about this go here:<br>
https://gbatemp.net/threads/xenoblade-x-replace-music.668397/

To create new audio file use this package made up for Windows: [REPOSITORY](https://github.com/masagrator/NXGameScripts/tree/main/XenobladeChroniclesX/ConvertWavToRIFFOpus) [DOWNLOAD](https://downgit.github.io/#/home?url=https://github.com/masagrator/NXGameScripts/tree/main/XenobladeChroniclesX/ConvertWavToRIFFOpus)

Drop standard .wav file (format s16le) on "DROP_HERE.cmd" if you want it to be played in loop from start to finish, or "DROP_HERE_CUSTOM_LOOP.cmd" if you want to modify where new loop should start. Afaik there is no way to change loop end time that would stop playing previous loop immediately. You need to modify your audio file to end in the way that allows proper looping (the same way was done for game).
Rename converted file to what file you want to replace, and put it to folder:
```
atmosphere/contents/0100453019AA8000/romfs/sound/
```

# Technical details:
For files from sts.ard/sts.arh: Plugin is hooking only one function that is responsible for preparing struct with info about file.
When first time this function is called, code is iterating recursively through whole "mod" folder to hash its paths and store it in cache. Then that cache is used instead of checking if file exists every single time for better performance. In tests each fopen() call was taking around 500 ticks, cache in worst case situation (which is storing info about 100000+ files) takes averagely 13 ticks.

For Music.pck: Plugin is hooking two functions. One is reponsible for loading .wem files, we are setting flag to load it from romfs if such file exists in romfs/sound folder. Second hooked function is responsible for parsing HIRC "Music Track" type of data. Pointer we use to patch seems to be some virtual memory mapping into filtered bgm.bnk which stores only first 0x8000 bytes. That's why iterating through whole bank is not possible.

XCXDE-ModLoader

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README