SDH Switch Extractor: конвертация NSZ в NSP и распаковка в ExeFS/RomFS на Steam Deck

SDH Switch Extractor — ути­ли­та для Steam Deck и Linux для ра­бо­ты с ва­ши­ми соб­ствен­ны­ми дам­па­ми игр Nintendo Switch. У неё две за­да­чи:

1. Кон­вер­та­ция NSZ → NSP. Сжа­тые об­ра­зы .nsz пре­вра­ща­ют­ся в обыч­ные .nsp, ко­то­рые по­ни­ма­ет боль­шин­ство про­грамм.

2. Рас­па­ков­ка в ExeFS/​RomFS.​ Из NSP или NSZ по­лу­ча­ют­ся папки exefs/ и romfs/: для модов, пе­ре­во­да, изу­че­ния ре­сур­сов игры и про­ек­тов ре­ком­пи­ля­ции. Если на входе NSZ, ути­ли­та сна­ча­ла сама пе­ре­ве­дёт его в NSP и толь­ко потом рас­па­ку­ет.

Ути­ли­та рас­счи­та­на толь­ко на ле­галь­но по­лу­чен­ные дампы с вашей соб­ствен­ной кон­со­ли. Steam Deck Base не рас­про­стра­ня­ет игры.

Что умеет ути­ли­та

• Кон­вер­ти­ру­ет NSZ → NSP и про­ве­ря­ет, что из каж­до­го NSZ по­лу­чил­ся ровно один кор­рект­ный NSP.

• Ра­бо­та­ет с одним фай­лом или с целой пап­кой об­ра­зов, по же­ла­нию вме­сте с вло­жен­ны­ми пап­ка­ми.

• Рас­па­ко­вы­ва­ет в ExeFS/​RomFS и при этом сама со­би­ра­ет ком­плект игры: на­хо­дит ба­зо­вую игру, самое новое об­нов­ле­ние и все DLC по Title ID в име­нах фай­лов, на­при­мер [01007EF00011E000].

• При­ме­ня­ет об­нов­ле­ние пра­виль­но: вос­ста­нав­ли­ва­ет ак­ту­аль­ную фай­ло­вую си­сте­му це­ли­ком, а не ко­пи­ру­ет патч по­верх ста­рой RomFS.

• Каж­дое DLC кла­дёт в от­дель­ную папку со своим Title ID.

• Не тро­га­ет ис­ход­ни­ки и не пор­тит про­шлый ре­зуль­тат. Ис­ход­ные NSZ/​NSP не уда­ля­ют­ся, а если рас­па­ков­ка не уда­лась, преды­ду­щий го­то­вый ком­плект оста­ёт­ся на месте.

Уста­нов­ка через Steam Deck Helper

1. Пе­рей­ди­те в режим ра­бо­че­го стола.

2. За­пу­сти­те Steam Deck Helper и от­крой­те раз­дел «Ин­стру­мен­ты».

3. Най­ди­те стро­ку SDH Switch Extractor и на­жми­те «Уста­но­вить».

4. Когда уста­нов­ка за­кон­чит­ся, в столб­це «Уста­нов­ле­но» по­явит­ся ✅.

Ути­ли­та ста­вит­ся в папку ~/.local/share/SDH-Switch-Extractor/, ярлык по­яв­ля­ет­ся на ра­бо­чем столе и в меню при­ло­же­ний. Права ад­ми­ни­стра­то­ра не нужны.

Если при пер­вом за­пус­ке с ра­бо­че­го стола KDE спро­сит, до­ве­рять ли яр­лы­ку, на­жми­те «По­ме­тить как ис­пол­ня­е­мый».

Кон­вер­та­ция NSZ → NSP

1. За­пу­сти­те SDH Switch Extractor с ра­бо­че­го стола или из меню.

2. Вы­бе­ри­те ис­точ­ник:

   • «Файл…» — один .nsz;

   • «Папка…» — все .nsz в папке. Вклю­чи­те поиск во вло­жен­ных пап­ках, если игры раз­ло­же­ны по под­пап­кам.

3. В поле «Ка­та­лог вы­во­да» ука­жи­те, куда со­хра­нить ре­зуль­тат. Можно вы­брать ту же папку, где лежат об­ра­зы.

4. На­жми­те «NSZ → NSP».

Го­то­вые .nsp по­явят­ся в папке NSP/ внут­ри ка­та­ло­га вы­во­да. Ис­ход­ные .nsz оста­нут­ся на месте.

Рас­па­ков­ка в ExeFS / RomFS

1. Вы­бе­ри­те файл или папку так же, как для кон­вер­та­ции. Под­хо­дят и .nsp, и .nsz.

2. Ука­жи­те «Ка­та­лог вы­во­да».

3. На­жми­те «Из­влечь ExeFS / RomFS».

4. Ход ра­бо­ты виден в окне. По­дроб­но­сти от­кры­ва­ют­ся кноп­кой «Жур­нал…», а оста­но­вить ра­бо­ту можно кноп­кой «Стоп».

Чтобы игра со­бра­лась вме­сте с об­нов­ле­ни­ем и DLC, по­ло­жи­те ба­зо­вую игру, об­нов­ле­ние и DLC в одну папку и вы­бе­ри­те её через «Папка…». В име­нах фай­лов дол­жен быть Title ID в квад­рат­ных скоб­ках, а у об­нов­ле­ний ещё и вер­сия, на­при­мер [v393216].

Где ис­кать ре­зуль­тат

<каталог вывода>/
├── NSP/                       # результат конвертации NSZ → NSP
└── Combined/
    └── <Название игры> [Title ID][vВерсия]/
        ├── bundle.json        # откуда что взято
        ├── README.txt         # описание структуры
        └── Game Files/
            ├── exefs/         # исполняемая часть игры
            ├── romfs/         # ресурсы игры
            └── dlc/
                └── <Title ID DLC>/
                    └── romfs/

Файлы без рас­по­зна­ва­е­мо­го Title ID рас­па­ко­вы­ва­ют­ся по от­дель­но­сти в Extracted/<имя файла>/Game Files/.

Место на диске. При кон­вер­та­ции и рас­па­ков­ке боль­ших игр нужен запас сво­бод­но­го места: под NSP, вре­мен­ные файлы и сам ре­зуль­тат. Про­верь­те, что на вы­бран­ном диске или карте па­мя­ти его хва­та­ет.

Воз­мож­ные про­бле­мы

• «Для пре­об­ра­зо­ва­ния нужны файлы .nsz». Для кноп­ки «NSZ → NSP» вы­бра­ны толь­ко .nsp, а они уже в нуж­ном фор­ма­те.

• Об­нов­ле­ние или DLC не под­хва­ти­лись. Про­верь­те, что ба­зо­вая игра лежит в той же папке, а в име­нах фай­лов есть пра­виль­ный Title ID. Об­нов­ле­ния и DLC без ба­зо­вой игры не рас­па­ко­вы­ва­ют­ся.

• DLC пу­стое, внут­ри толь­ко STATUS.txt. Зна­чит, это DLC-ключ раз­бло­ки­ров­ки без соб­ствен­ных дан­ных, ошиб­кой это не яв­ля­ет­ся.

• Ошиб­ка кон­вер­та­ции или рас­шиф­ров­ки. По­дроб­но­сти смот­ри­те в «Жур­на­ле…». Чаще всего образ по­вре­ждён или не со­от­вет­ству­ет клю­чам вашей кон­со­ли.

Уда­ле­ние

От­крой­те Steam Deck Helper → «Ин­стру­мен­ты» и в стро­ке SDH Switch Extractor на­жми­те «Уда­лить». Уда­лят­ся папка ути­ли­ты и оба яр­лы­ка, а ваши NSP и рас­па­ко­ван­ные игры оста­нут­ся на месте.