Toggle search
Toggle menu
12.1K
15.1K
1.2K
216.7K
GameBrew
Toggle preferences menu
Toggle personal menu
Not logged in
Your IP address will be publicly visible if you make any edits.
The main server is currently down. We are running on a backup server, so editing and search functionality are temporarily disabled. Please check back in a few hours.

Xenoblade Chronicles X: Definitive Edition Mod Loader Switch: Difference between revisions

From GameBrew
More actions
← Older edit
No edit summary
No edit summary
 
(2 intermediate revisions by one other user not shown)
Line 2: Line 2:
|title=Xenoblade Chronicles X: Definitive Edition Mod Loader
|title=Xenoblade Chronicles X: Definitive Edition Mod Loader
|image=Switch-logo.png
|image=Switch-logo.png
|description=Exlaunch plugin for loading files outside of sts.ard in Xenoblade Chronicles X: Definitive Edition.
|description=Exlaunch plugin for loading files outside of sts.ard in Xenoblade Chronicles X - Definitive Edition.
|author=
|author=masagrator
|lastupdated=2025/05/11
|lastupdated=2025/05/11
|type=Hack Utilities
|type=Hack Utilities
Line 11: Line 11:
|website=https://github.com/masagrator/XCXDE-ModLoader
|website=https://github.com/masagrator/XCXDE-ModLoader
|source=https://github.com/masagrator/XCXDE-ModLoader
|source=https://github.com/masagrator/XCXDE-ModLoader
|donation=
|donation=https://ko-fi.com/masagrator
}}
}}
{{#seo:
{{#seo:
Line 19: Line 19:
|image_alt=Xenoblade Chronicles X: Definitive Edition Mod Loader
|image_alt=Xenoblade Chronicles X: Definitive Edition Mod Loader
}}
}}
Xenoblade Chronicles X: Definitive Edition Mod Loader is a special add-on (called a plugin) that lets the game load extra files from outside the normal game data.
An exlaunch plugin for Xenoblade Chronicles X: Definitive that allows loading files outside of sts.ard/sts.arh.


It can also play music files from outside the main music file, without needing to change the settings that control how music loops.
It can also play music files from outside of Music.pck, without needing to edit bgm.bnk.


'''Note:''' This only works with the Western version of the game (not the Japanese one), and only with version 1.0.1 or 1.0.2 (Game ID: 0100453019AA8000).
Only works with the Western version of the game (v1.0.1 or v1.0.2).


== How to install ==
== Installation ==
# Download latest release [https://github.com/masagrator/XCXDE-ModLoader/releases here].
Download latest release [https://github.com/masagrator/XCXDE-ModLoader/releases here].
# Copy <code>atmosphere</code> folder to root of your sdcard


For emulators read guide specific to your emulator about how to install mods.
Copy the <code>atmosphere</code> folder to root of your SD card.


== How to use ==
Add your files to <code>atmosphere/contents/0100453019AA8000/romfs/mod/</code>. If any folder doesn't exist, create it manually.
Copy your files in the same folder tree to


<pre>atmosphere/contents/0100453019AA8000/romfs/mod/</pre>
For example if you modified &quot;lib_nx.ini&quot; that is in &quot;monolib/shader&quot;, whole path should look like this:
If any folder doesn't exist, create it manually.


So for example if you modified &quot;lib_nx.ini&quot; that is in &quot;monolib/shader&quot;, whole path should look like this:
<code>atmosphere/contents/0100453019AA8000/romfs/mod/monolib/shader/lib_nx.ini</code>
 
<pre>atmosphere/contents/0100453019AA8000/romfs/mod/monolib/shader/lib_nx.ini</pre>
 
== How to modify sound files ==
First we need to unpack Music.pck. You can use this Python 3 script [https://github.com/masagrator/NXGameScripts/blob/main/XenobladeChroniclesX/pck_unpack_digits.py HERE]<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:
 
<pre>python pck_unpack_digits.py Music.pck</pre>
This will create new folder &quot;Music&quot; 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: [https://github.com/masagrator/NXGameScripts/tree/main/XenobladeChroniclesX/ConvertWavToRIFFOpus REPOSITORY] [https://downgit.github.io/#/home?url=https://github.com/masagrator/NXGameScripts/tree/main/XenobladeChroniclesX/ConvertWavToRIFFOpus DOWNLOAD]
 
Drop standard .wav file (format s16le) on &quot;DROP_HERE.cmd&quot; if you want it to be played in loop from start to finish, or &quot;DROP_HERE_CUSTOM_LOOP.cmd&quot; 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:
 
<pre>atmosphere/contents/0100453019AA8000/romfs/sound/</pre>
 
== 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 &quot;mod&quot; 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 &quot;Music Track&quot; 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.


==Changelog==  
==Changelog==  
Line 79: Line 53:


== External links ==
== External links ==
* Github - https://github.com/masagrator/XCXDE-ModLoader
* GitHub - https://github.com/masagrator/XCXDE-ModLoader

Latest revision as of 11:17, 24 May 2025

Xenoblade Chronicles X: Definitive Edition Mod Loader
General
Authormasagrator
TypeHack Utilities
Version1.2.1
LicenseGPL-32.0
Last Updated2025/05/11
Links
Download
Website
Source
Support Author

An exlaunch plugin for Xenoblade Chronicles X: Definitive that allows loading files outside of sts.ard/sts.arh.

It can also play music files from outside of Music.pck, without needing to edit bgm.bnk.

Only works with the Western version of the game (v1.0.1 or v1.0.2).

Installation

Download latest release here.

Copy the atmosphere folder to root of your SD card.

Add your files to atmosphere/contents/0100453019AA8000/romfs/mod/. If any folder doesn't exist, create it manually.

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

Changelog

v1.2.1

  • Fix an issue with bgm.bnk not being properly patched in RAM.

v1.2.0

  • Add support for loading .wem files outside of Music.pck, this includes automated patching of bgm.bnk to properly adjust loop. More in README.

v1.1.7

  • Add support for update 1.0.2.

v1.1.6

  • Implement bucket solution that makes searching cache 2x faster in comparison to 1.1.4 release.

v1.1.4

  • Fixed an issue with cache related to count of files.

v1.1.3

  • Added cache for better performance.

v1.0.2

  • First Release.

External links

Retrieved from "https://www.gamebrew.org/index.php?title=Xenoblade_Chronicles_X:_Definitive_Edition_Mod_Loader_Switch&oldid=200281"

Advertising: