Skip to content

Play your own Switch games on iPhone/iPad — one-click macOS app, no terminal. | 把 Switch 游戏装进 iPhone:图形界面一键构建,不用命令行。Bring your own game.

Merge branch 'v0lumehi/switch2-qt' into v0lumehi/switch2-docs

v0lumehicfd7b2cbb2b6
diff --cc GAMES.it.md
index af391564,1dec320d..b45605be
--- a/GAMES.it.md
+++ b/GAMES.it.md
@@@ -216,37 -221,9 +221,23 @@@ Screenshot accompagnati da una nota qua
</tr>
</table>
+## Giochi Switch 2
+
+Il motore esegue i giochi Switch 2 come profili normali, senza un'opzione Switch 2. Un gioco Switch 2 si compila da una cartella dei suoi file o da un contenitore NUP (un file `.nup`), mai da NSP o XCI, e non serve `prod.keys`. Si compila solo se il motore ha un profilo per il gioco. Il launcher accetta entrambe le forme nella pagina Build e segna il gioco come **Switch 2** nella libreria.
+
+| Gioco | ID titolo | Secondo upstream | In questo fork |
+|---|---|---|---|
+| Donkey Kong Bananza | `040074A01BF12000` | Gira sul Mac (aggiornamento v458752), provato fino all'inizio del primo livello | Giocato una volta su un iPhone 17 Pro Max con iOS 27.0.1, compilato da riga di comando (#445). Non ancora compilato con il launcher |
+| Splatoon Raiders | `0400380020056000` | Gira sul Mac (aggiornamento v65536). Nessuna IPA: la sua memoria supera per ora il limite di iOS | Non provato |
+| Fire Emblem Fortune's Weave | `04007EF01F8AE000` | Gira sul Mac (v131072), 60 fps. Nessuna IPA | Non provato |
+| Pokémon Pokopia | `0400A3A01EE4C000` | Gira sul Mac (aggiornamento v655360). Nessuna IPA | Non provato |
+| Hyrule Warriors: Age of Imprisonment | `04003F40232DE000` | Arriva al primo campo sul Mac (aggiornamento v196608), da un NUP. Nessuna IPA | Non provato |
+
+La struttura della cartella e i dettagli sono nella [pagina inglese](GAMES.md#switch-2-games). Questa pagina e il launcher non dicono come ottenere i file: vengono dalla tua console.
+
- ## Giochi verificati
-
- **3 verificati dall'inizio alla fine su questo fork** (compilazione → installazione → partita su un iPhone reale), **45 segnalati
- come giocabili upstream**, **94 profili** in totale. La tabella completa con l'esatta versione di aggiornamento richiesta da ciascun
- gioco si trova [qui sotto](#profili).
-
- | Gioco | Verificato qui | Note |
- |---|---|---|
- | **Tears of the Kingdom** | ✅ | 304.243 file → 127 frammenti di archivio, verificati byte per byte |
- | **Hades II** | ✅ | Archivio da 33 file |
- | **Animal Crossing: New Horizons** | ✅ | 103.645 file → 72 frammenti, gira in modo fluido |
-
- ---
-
## Profili
- Questo repository include 94 profili di gioco. Un profilo è ciò che rende possibile la compilazione —
+ Questo repository include 130 profili di gioco. Un profilo è ciò che rende possibile la compilazione —
i Build ID del gioco, il layout di memoria, le tabelle degli shader e le impostazioni specifiche del titolo — e questo fork vi aggiunge sopra il
livello di archiviazione RomFS, consentendo di installare anche i giochi di grandi dimensioni.
diff --cc GAMES.md
index a3f25b51,cd69c283..ae35412e
--- a/GAMES.md
+++ b/GAMES.md
@@@ -221,47 -221,9 +221,33 @@@ Screenshots, with a note where a game h
</table>
<!-- end of gallery -->
+## Switch 2 games
+
+The engine runs Switch 2 games as ordinary profiles. There is no Switch 2 switch or setting. A Switch 2 game is built from a folder of its files or from one NUP container (a `.nup` file), never from NSP or XCI, and needs no `prod.keys`. It builds only when the engine has a profile for it. The launcher takes both forms on the Builds page (pick the folder, the `.nup` file, or a folder that holds the `.nup`) and marks the game **Switch 2** in the library.
+
+| Game | Title ID | Upstream says | On this fork |
+|---|---|---|---|
+| Donkey Kong Bananza | `040074A01BF12000` | Plays on the Mac (update v458752), tested through the first level's opening areas | Played once on an iPhone 17 Pro Max with iOS 27.0.1, built from the command line (#445). Not built through the launcher yet |
+| Splatoon Raiders | `0400380020056000` | Plays on the Mac (update v65536). No IPA built: its memory layout is over iOS's limit for now | Not tried |
+| Fire Emblem Fortune's Weave | `04007EF01F8AE000` | Plays on the Mac (v131072), 60 fps. No IPA built | Not tried |
+| Pokémon Pokopia | `0400A3A01EE4C000` | Plays on the Mac (update v655360). No IPA built | Not tried |
+| Hyrule Warriors: Age of Imprisonment | `04003F40232DE000` | Reaches the first field on the Mac (update v196608), from a NUP. No IPA built | Not tried |
+
+The folder layout the engine reads (`updates` and `dlc` are optional):
+
+```
+<game folder>/
+ base/exefs/ main, main.npdm, sdk, rtld
+ base/romfs/
+ updates/458752/exefs/, romfs/ the update's version as a decimal number, the patched RomFS
+ dlc/040074a01bf13001/0/romfs/ the DLC's title ID
+```
+
+A folder of files has no control data, so the app gets no icon and takes its name from the profile. A NUP may carry both. The first build of a Switch 2 game takes long (Donkey Kong Bananza builds about 23,000 shaders) and needs free space for the RomFS images plus about 6 GB. This page and the launcher do not say how to get the files: they come from your own console.
+
- ## Verified games
-
- **3 verified end to end on this fork** (build → install → play on a real iPhone), **45 reported
- playable upstream**, **94 profiles** in total. The full table with the exact update version each
- game needs is [below](#profiles).
-
- | Game | Verified here | Notes |
- |---|---|---|
- | **Tears of the Kingdom** | ✅ | 304,243 files → 127 archive shards, byte-verified |
- | **Hades II** | ✅ | 33-file archive |
- | **Animal Crossing: New Horizons** | ✅ | 103,645 files → 72 shards, runs smoothly |
-
- ---
-
## Profiles
- 94 game profiles ship with this repository. A profile is what makes a build possible —
+ 130 game profiles ship with this repository. A profile is what makes a build possible —
the game's build IDs, memory layout, shader tables and per-game switches — and this fork adds the
RomFS archive layer on top, so a large game can be installed at all.
diff --cc GAMES.zh-CN.md
index ed5a90b3,4dcf2189..9578f7c8
--- a/GAMES.zh-CN.md
+++ b/GAMES.zh-CN.md
@@@ -2,44 -2,9 +2,33 @@@
本 fork 有 profile 的全部游戏,以及每款需要的更新包。玩家主页是 [README.zh-CN.md](README.zh-CN.md)。[dm/games/README.md](https://github.com/seedds/nxnative/blob/641d1480021a57840b7acc15f92cbd86ecfae611/dm/games/README.md)(英文)是引擎对每款游戏的笔记。截图和 IPA 大小在英文页的[图库](GAMES.md#gallery)里。
+## Switch 2 游戏
+
+引擎把 Switch 2 游戏当作普通的 profile 来运行,没有单独的 Switch 2 开关或设置。Switch 2 游戏只能从游戏文件夹或一个 NUP 容器(`.nup` 文件)构建,不能用 NSP 或 XCI,也不需要 `prod.keys`。只有引擎里有它的 profile 才能构建。启动器在构建页面接受这两种形式(选择游戏文件夹、`.nup` 文件,或放着 `.nup` 的文件夹),并在游戏库里标出 **Switch 2**。
+
+| 游戏 | 标题 ID | 上游的说法 | 本 fork |
+|---|---|---|---|
+| Donkey Kong Bananza | `040074A01BF12000` | 在 Mac 上可玩(更新 v458752),测试到第一关开头 | 用命令行构建后,在 iPhone 17 Pro Max(iOS 27.0.1)上玩过一次(#445)。还没有通过启动器构建过 |
+| Splatoon Raiders | `0400380020056000` | 在 Mac 上可玩(更新 v65536)。没有构建过 IPA:它的内存布局目前超出 iOS 的限制 | 没有试过 |
+| Fire Emblem Fortune's Weave | `04007EF01F8AE000` | 在 Mac 上可玩(v131072),60 fps。没有构建过 IPA | 没有试过 |
+| Pokémon Pokopia | `0400A3A01EE4C000` | 在 Mac 上可玩(更新 v655360)。没有构建过 IPA | 没有试过 |
+| Hyrule Warriors: Age of Imprisonment | `04003F40232DE000` | 在 Mac 上能玩到第一片原野(更新 v196608),从 NUP 构建。没有构建过 IPA | 没有试过 |
+
+引擎读取的文件夹结构(`updates` 和 `dlc` 可选):
+
+```
+<游戏文件夹>/
+ base/exefs/ main、main.npdm、sdk、rtld
+ base/romfs/
+ updates/458752/exefs/、romfs/ 十进制的更新版本号,已打补丁的 RomFS
+ dlc/040074a01bf13001/0/romfs/ DLC 的标题 ID
+```
+
+游戏文件夹没有控制数据,所以生成的 App 没有图标,名字取自 profile。NUP 可能带有这两样。Switch 2 游戏的第一次构建很久(Donkey Kong Bananza 要构建约 23,000 个着色器),需要的空间是 RomFS 镜像加约 6 GB。本页和启动器都不说明如何获得这些文件:它们来自你自己的主机。
+
- ## 实测游戏
-
- **3 款在本 fork 完整验证**(构建 → 安装 → 真机可玩)、**45 款上游报告可玩**、**共 94 个 profile**。
- 每款游戏需要的精确更新版本见[完整表格](#profile-列表)。
-
- | 游戏 | 本 fork 验证 | 备注 |
- |---|---|---|
- | **塞尔达传说:王国之泪** | ✅ | 304,243 个文件 → 127 片,逐字节校验 |
- | **Hades II** | ✅ | 33 个文件的归档 |
- | **集合啦!动物森友会** | ✅ | 103,645 个文件 → 72 片,流畅运行 |
-
## Profile 列表
- 本仓库自带 94 个游戏 profile。profile 决定了一个游戏能不能构建——build ID、内存布局、
+ 本仓库自带 130 个游戏 profile。profile 决定了一个游戏能不能构建——build ID、内存布局、
shader 表、每个游戏各自的开关。本 fork 在此基础上加了 RomFS 归档层,让大体积游戏能装得下。
「需要的更新包」就是构建时严格校验的版本:更新包 NSP 的显示版本必须与 profile 注册的 build 一致