ROM Hack RELEASE NSC_Builder. Nintendo Switch Cleaner and Builder. (Game+updates+dlc in a single xci)

[lordelan]

If you want to wait a little I'll release a faster version on Friday as beta.

Umm I entered multi-pack mode, dragged the base xci in, proceeded with ENTER, dragged the upd nsp in, proceeded with ENTER and dragged the DLC nsp in and proceeded with ENTER. Then I chose to built a XCI file only.
Now I ended up (output folder) with a XCI file and two zip files:

• Sonic Mania Plus v131072[multi][xcib].xci
• 01009AA000FAA800[V131072][UPD] .zip
  
• 01009AA000FAB001[V0][DLC] .zip

Beside the fact that the space before .zip isn't wanted by you (or is it?) I wonder if that was the right way to build an all-in-one-XCI and if yes if I can delete those zip files.
(I'm not at home right now so I can't test it on my Switch)

Edit: Wait, there's even more odd things to that. My source material was the following:

• Base game XCI - 1.85 GB
• Update NSP - 394 MB
• DLC NSP - 119 KB

But the single output XCI has a size of only 381 MB (so even smaller than the udpate alone).

Edit 2: Or did it trim things and 1.85 is just the default size of 2 GB cartridges? Still it's odd that the result is even smaller than the update file, isn't it?

Edit 3: Seems like I was a little stupid. To build those all-in-one-XCIs that I want I would have to use update mode. Are DLCs also treated as updates by your tool and to be applied on a base game that way?
Still If I use the base game and the update that way the output is less than 400 MB in size. Hmm ...

 

[JRoad]

Umm I entered multi-pack mode, dragged the base xci in, proceeded with ENTER, dragged the upd nsp in, proceeded with ENTER and dragged the DLC nsp in and proceeded with ENTER. Then I chose to built a XCI file only.
Now I ended up (output folder) with a XCI file and two zip files:

• Sonic Mania Plus v131072[multi][xcib].xci
• 01009AA000FAA800[V131072][UPD] .zip
  
• 01009AA000FAB001[V0][DLC] .zip

Beside the fact that the space before .zip isn't wanted by you (or is it?) I wonder if that was the right way to build an all-in-one-XCI and if yes if I can delete those zip files.
(I'm not at home right now so I can't test it on my Switch)

Edit: Wait, there's even more odd things to that. My source material was the following:

• Base game XCI - 1.85 GB
• Update NSP - 394 MB
• DLC NSP - 119 KB

But the single output XCI has a size of only 381 MB (so even smaller than the udpate alone).

Edit 2: Or did it trim things and 1.85 is just the default size of 2 GB cartridges? Still it's odd that the result is even smaller than the update file, isn't it?

Edit 3: Seems like I was a little stupid. To build those all-in-one-XCIs that I want I would have to use update mode. Are DLCs also treated as updates by your tool and to be applied on a base game that way?
Still If I use the base game and the update that way the output is less than 400 MB in size. Hmm ...

Ah you went with the worst game possible XD Sonic Mania already has an update + 1 dlc inside in xci version.
Use the info function number one you'll see the 3 contents inside the xci.
If you need to replace the update and or docs you need to use update mode with this one.
Update mode is only meant to use with a base that already has multiple content BTW.

Dlcs are irrelevant you can add them in multi mode even if the xci was updated and added dlcs before. The issues happen only with updates since they interfere one with the other.

The 400 MB of difference is the system update. The program erases it since there is no point to it specially when you can update choidujourNX and you only do the update once.

 

[simbin]

I've seen a lot of confusion from people trying to figure out how some of the game updates were being pre-patched to work on 5.10. Adding a blurb saying that you can use your utility to repack and patch the RSV to allow usage on older FWs might help alleviate that confusion.

I'm definitely confused as well. Does this only work for updates, or can base games also be pre-patched to work on 5.1.0? I can't find much info on how this process is done or its limitations.

 

[JRoad]

I'm definitely confused as well. Does this only work for updates, or can base games also be pre-patched to work on 5.1.0? I can't find much info on how this process is done or its limitations.

It works with updates, games or dlcs. It changes the master key that is needed to decryption the nca files and the Requiredsystemversion.
It's not failproof since the game can have dependencies from the required firmware.
For example some games since to need features introduced in 6.0. In those cases they crash at boot.
And yeah I know I need to at least update the readme.

 

[dabu-sapper]

Did anyone try converting Travis Strikes Back? I get a black screen after the Nintendo logo in the bottom right corner. Every other game works. I'm using the latest version of nsc builder.

 

[JRoad]

Did anyone try converting Travis Strikes Back? I get a black screen after the Nintendo logo in the bottom right corner. Every other game works. I'm using the latest version of nsc builder.

Just wait. That one is a slow starter from what i've been told. Basically if the home button works the game is working.

 

[huma_dawii]

NVM it was my fault, the update wasn't the same as the base and couldn't update it xDDD now all works fine!

 

[dabu-sapper]

Just wait. That one is a slow starter from what i've been told. Basically if the home button works the game is working.

Thank you. I tried it again and it took 77 seconds to see the first Nintendo warning message (about the joy cons straps) and approx. about 30 seconds to see the developer logos. That's hilarious! What were the developers thinking?

 

[lordelan]

Ah you went with the worst game possible XD Sonic Mania already has an update + 1 dlc inside in xci version.
Use the info function number one you'll see the 3 contents inside the xci.
If you need to replace the update and or docs you need to use update mode with this one.
Update mode is only meant to use with a base that already has multiple content BTW.

Dlcs are irrelevant you can add them in multi mode even if the xci was updated and added dlcs before. The issues happen only with updates since they interfere one with the other.

The 400 MB of difference is the system update. The program erases it since there is no point to it specially when you can update choidujourNX and you only do the update once.

Oh man good thing I started with the worst. Makes me a fast learner I hope.
So to sum up what you said (as far as I understood), these are the steps needed:

1. Use info function to see if there's already an update and/or DLC inside the XCI
2. Since you wrote "Update mode is only meant to use with a base that already has multiple content BTW." if I want to include an update it depends if there's already an update included in the XCI (like with Sonic Mania Plus or because that XCI was built by myself earlier with an older update)
   1. If an update is already included:
      Use update mode
   2. If there's no update inside the XCI:
      Use multi mode with the base XCI and the update NSP
3. If I want to include DLCs it doesn't matter whether I'm using multi mode or update mode

Also I guess the zip files can be deleted, correct?

Sorry for asking so extensively but I really need to understand how your tool works and what's possible with it because I think it's a fantastic tool.

Edit: I guess this tool can be used to easily just convert between NSP and XCI and vice versa btw? (speaking of only one file, no multiple things)

 

[JRoad]

Oh man good thing I started with the worst. Makes me a fast learner I hope.
So to sum up what you said (as far as I understood), these are the steps needed:

1. Use info function to see if there's already an update and/or DLC inside the XCI
2. Since you wrote "Update mode is only meant to use with a base that already has multiple content BTW." if I want to include an update it depends if there's already an update included in the XCI (like with Sonic Mania Plus or because that XCI was built by myself earlier with an older update)
   1. If an update is already included:
      Use update mode
   2. If there's no update inside the XCI:
      Use multi mode with the base XCI and the update NSP
3. If I want to include DLCs it doesn't matter whether I'm using multi mode or update mode

Also I guess the zip files can be deleted, correct?

Sorry for asking so extensively but I really need to understand how your tool works and what's possible with it because I think it's a fantastic tool.

Edit: I guess this tool can be used to easily just convert between NSP and XCI and vice versa btw? (speaking of only one file, no multiple things)

Yep didn't had time for the version I'm going to release but the zips are meant for a restore Titleist mode. But since then I figured how to implement it without the zips if the files weren't patched. I will still need the ticket and cnmt.nca in the case the files were patched. I'll also need the ticket if you want to restore the signature in updates since updates have a legal signature.
If you don't care about that you can delete the zip. The rest of content I didn't mention will be deleted from the zip in future versions

Ah yeah, it also support multiple content. Split mode is meant to separate back the content though it still doesn't restore back titlerights wich will be an option.

 

[18Phoenix]

@JRoad
Perhaps you should overthink the menu-building, it's very confusing for beginners.
Could you please deactivate the auto-exit for auto-mode? So I can't see if there were any mistakes.
Thanks ^^

 

[lordelan]

Yep didn't had time for the version I'm going to release but the zips are meant for a restore Titleist mode. But since then I figured how to implement it without the zips if the files weren't patched. I will still need the ticket and cnmt.nca in the case the files were patched. I'll also need the ticket if you want to restore the signature in updates since updates have a legal signature.
If you don't care about that you can delete the zip. The rest of content I didn't mention will be deleted from the zip in future versions

Ah yeah, it also support multiple content. Split mode is meant to separate back the content though it still doesn't restore back titlerights wich will be an option.

The update that is already inside the Sonic Mania Plus.XCI looks like this:

Spoiler

-----------------------------
CONTENT ID: 01009aa000faa800
-----------------------------
Titleinfo:
- Name: Sonic Mania
- Editor: Sega
- Build number: 1.04
- Supported Languages: US (eng)
- Content type: Update
- Version: 131072 -> Patch (2)
Required Firmware:
- RequiredSystemVersion: 335609856 -> (5.0.0)
- Encryption (keygeneration): 4 -> (4.0.0 - 4.1.0)
- Patchable to: 268435656 -> (4.0.0)
......................
NCA FILES (NON DELTAS)
......................
- Program:     e20678a0c8f171cdb2244ed88be48637.nca        Size: 196.52MB
- Control:     9723e1d3322b71984a468b7c75edfcd3.nca        Size: 189.5KB
- LegalInf:     2d43196a416fb9e0866dbf4e3ea8e0be.nca        Size: 139.0KB
- HtmlDoc:     693dc0c76c121c7be3687d6921809540.nca        Size: 162.0KB
- Meta:     37b8eefd54f161cf5146caa1a07bd50c.cnmt.nca    Size: 5.0KB
                              --------------------
                              TOTAL SIZE: 197.0MB
......................
OTHER TYPES OF FILES
......................
- Ticket:     01009aa000faa8000000000000000004.tik        Size: 704B
- Cert:     01009aa000faa8000000000000000004.cert        Size: 1.75KB
                              --------------------
                              TOTAL SIZE: 2.44KB
/////////////////////////////////////
   FULL CONTENT TOTAL SIZE: 197.0MB 
/////////////////////////////////////

The separate update NSP (which seems to be the exact same update version) looks like this:

Spoiler

-----------------------------
CONTENT ID: 01009aa000faa800
-----------------------------
Titleinfo:
- Name: Sonic Mania
- Editor: Sega
- Build number: 1.04
- Supported Languages: US (eng)
- Content type: Update
- Version: 131072 -> Patch (2)
Required Firmware:
- RequiredSystemVersion: 335609856 -> (5.0.0)
- Encryption (keygeneration): 4 -> (4.0.0 - 4.1.0)
- Patchable to: 268435656 -> (4.0.0)
......................
NCA FILES (NON DELTAS)
......................
- Program:     e20678a0c8f171cdb2244ed88be48637.nca        Size: 196.52MB
- Control:     9723e1d3322b71984a468b7c75edfcd3.nca        Size: 189.5KB
- LegalInf:     2d43196a416fb9e0866dbf4e3ea8e0be.nca        Size: 139.0KB
- HtmlDoc:     693dc0c76c121c7be3687d6921809540.nca        Size: 162.0KB
- Meta:     06a09194d55d7972adab5f4841d4e49a.cnmt.nca    Size: 5.0KB
                              --------------------
                              TOTAL SIZE: 197.0MB
......................
NCA FILES (DELTAS)
......................
- Delta:     f1b4d0ec00824485fa2fb83871339595.nca        Size: 120.09MB
- Delta:     8817becaef3ff8ba125806ce9d15b5eb.nca        Size: 76.58MB
- Delta:     41f60b7a46ef16772aac54244afc3b3e.nca        Size: 224.0KB
- Delta:     31021a8bca67b712198b1577890fb06e.nca        Size: 176.0KB
- Delta:     25b0a009768038693f8da421a90e4b55.nca        Size: 208.0KB
- Delta:     5a778058e5211102c01611e8cf822a2a.nca        Size: 48.0KB
                              --------------------
                              TOTAL SIZE: 197.31MB
......................
OTHER TYPES OF FILES
......................
- XML:         06a09194d55d7972adab5f4841d4e49a.cnmt.xml    Size: 3.05KB
- Ticket:     01009aa000faa8000000000000000004.tik        Size: 704B
- Cert:     01009aa000faa8000000000000000004.cert        Size: 1.75KB
                              --------------------
                              TOTAL SIZE: 5.49KB
/////////////////////////////////////
   FULL CONTENT TOTAL SIZE: 394.32MB 
/////////////////////////////////////

What does DELTAS and NON DELTAS mean? That seems to be the only difference (and it doubles the size of the separate update NSP in comparison to the included one).

@JRoad
Perhaps you should overthink the menu-building, it's very confusing for beginners.
Could you please deactivate the auto-exit for auto-mode? So I can't see if there were any mistakes.
Thanks ^^

At least one note/sentence of explanation under each menu entry would be helpful for beginners.

 

[Reploid]

Just wanted to raincheck: this tool is still the best.

 

[gizmomelb]

an ignorant question.

if I ripped my own cartridge (a single player offline only game) and then substituted that game ID / key / whatever is needed into each of the custom XCI file I packed, would that then possibly decrease the chances of a ban -as every game would show up as me playing my own legit cartridge etc. etc.? Not taking the game onlines ever.. just in general principle of keeping the console as ban free as possible.

thank you.

 

[lordelan]

an ignorant question.

if I ripped my own cartridge (a single player offline only game) and then substituted that game ID / key / whatever is needed into each of the custom XCI file I packed, would that then possibly decrease the chances of a ban -as every game would show up as me playing my own legit cartridge etc. etc.? Not taking the game onlines ever.. just in general principle of keeping the console as ban free as possible.

thank you.

We don't know if Ninty only looks for the ID/key stuff or some more info (game size) so I don't think you'll get an absolute answer to this.

 

[JRoad]

an ignorant question.

if I ripped my own cartridge (a single player offline only game) and then substituted that game ID / key / whatever is needed into each of the custom XCI file I packed, would that then possibly decrease the chances of a ban -as every game would show up as me playing my own legit cartridge etc. etc.? Not taking the game onlines ever.. just in general principle of keeping the console as ban free as possible.

thank you.

Safest Bet is to have a clean NAND and to use emunand In MY OPINION. Theoretically standard crypto and ticketless nsp have the same effect as xci but you still need to block or deactivate tellemetry if you are european and to have a clean error log to be on the safe side. So it's better to separate things and to use emunand IMO If you can play xci, you can do an emunand so it's a easy choice.

Just wanted to raincheck: this tool is still the best.

Thx for the nice words

...

Deltas are files that patch old updates to transform then to the new update. So if you have a nca installed from update 1 the system only installs\downloads the delta, wich has a smaller size, and patches the update. It's meant for efficiency.
The nsp that were obtained from the CDN includes deltas, in part because the scene is centered about game preservation and in part because if you don't include them you need to erase the old update manually.
Apart from the deltas the other files are the full update. XCI always includes the full update so they don't need deltas. The reduced size you normally get with NSCB from a full xci is, "update partition (400mb)", deltas from updates (it'll depend on the update), padding at the end of the xci to fill the cartridge (same as normal trimming), a few kb of padding between partitions.

@JRoad
Perhaps you should overthink the menu-building, it's very confusing for beginners.
Could you please deactivate the auto-exit for auto-mode? So I can't see if there were any mistakes.
Thanks ^^

Noted, i'll see about adding the pause in auto as option. For the explanation I was thinking about making a instructions section in the bat, but won't be up today at least, it's more like a intention I have for future updates.

 

[bytar]

Hello there. I am on 5.1.0 right now. When I tried to convert a masterkey7 [6.2.0] game or update (like Wargroove and Tales of Vesperia update file) to masterkey5 one [5.1.0] and install it, the NSP file is always corrupted. Does anybody know why?

 

[rafaelia]

Is the 8 game limitation for multi-game mode still a thing?

For example I have 7 fighter pass dlcs for SSBU, so would there be a way to pack the base game + update + all 7 dlcs (and possibly future dlcs too) into 1 xci or not possible just yet?

 

[JRoad]

Hello there. I am on 5.1.0 right now. When I tried to convert a masterkey7 [6.2.0] game or update (like Wargroove and Tales of Vesperia update file) to masterkey5 one [5.1.0] and install it, the NSP file is always corrupted. Does anybody know why?

What CFW are you using?. If it's kosmos and you heave the masterkey for 6.2 added to your keys.txt try with Shadowhand's preconfigured atmosphere pack since kosmos doesn't includes all the patches NSCB needs. It's a pure atmosphere+patches+some starter apps preconfigured to auto-launch via Hekate, it's drag and drop.
https://github.com/RShadowhand/singularite/releases/tag/1.1.3

Is the 8 game limitation for multi-game mode still a thing?

For example I have 7 fighter pass dlcs for SSBU, so would there be a way to pack the base game + update + all 7 dlcs (and possibly future dlcs too) into 1 xci or not possible just yet?

Yes but dlcs and updates are not considered new games. The limit is due to the number of icons\placeholders horizon is able to load at the same time, apparently. Never tested with modded qlaunchers, though.
But yeah one of my first multi xci was YS VIII that it's like Game+Update+22DLCs or something like that. If the combination is smaller than 32GB you're good to go.

 

[rafaelia]

Yes but dlcs and updates are not considered new games. The limit is due to the number of icons\placeholders horizon is able to load at the same time, apparently. Never tested with modded qlaunchers, though.
But yeah one of my first multi xci was YS VIII that it's like Game+Update+22DLCs or something like that. If the combination is smaller than 32GB you're good to go.

Awesome, thanks for the quick reply. Out of interest in what case would there be more than 8 games in one?