Home Homebrew IZCIVSwitch v0.1.0: Accesso al file system su Nintendo Switch 2 tramite Civilization...

IZCIVSwitch v0.1.0: Accesso al file system su Nintendo Switch 2 tramite Civilization VII e nuova versione 0.27 per IZlauncher

286
0

La scena homebrew della console Nintendo Switch 2 continua a fare passi avanti e questa volta il risultato arriva da byizmysh, autore di IZCIVSwitch, un nuovo progetto che sfrutta l’entrypoint CivSwitch per raggiungere un obiettivo particolarmente interessante: ottenere l’accesso al file system della console.

Il progetto nasce dal lavoro di diversi sviluppatori della scena, tra cui Gezine, kurumuz, slapah, XITRIX e mza1010, ai quali l’autore ha riconosciuto il merito dei progressi raggiunti.

La novità non riguarda quindi soltanto l’esecuzione di codice JavaScript all’interno del gioco, ma l’integrazione di ulteriori componenti che permettono di spingersi oltre le possibilità offerte dal primo entrypoint.

CivSwitch sfrutta una vulnerabilità XSS presente nella chat multiplayer di Civilization VII, nella versione originale per Nintendo Switch.

Attraverso questa falla è possibile iniettare codice JavaScript e avviare un Remote JS Loader, che consente di inviare ulteriori payload da un computer collegato alla stessa rete.

La catena sviluppata per IZCIVSwitch sfrutta questo punto di ingresso per proseguire con le fasi successive dell’exploit ns2jb, arrivando all’acquisizione dell’accesso al file system della Switch 2.

Si tratta di un risultato importante per la scena, perché apre nuove possibilità di sperimentazione e sviluppo di strumenti homebrew.

La versione 0.1.0 di IZCIVSwitch mette a disposizione un pacchetto che integra il motore originale CivSwitch Kit, il collegamento RPC e un programma per PC incaricato di coordinare le varie fasi dell’operazione.

La distribuzione comprende anche IZlauncher in versione 0.27, un menu alternativo con loader incorporato, che permette di avviare il collegamento senza dover ripetere ogni volta l’intera procedura dalla lobby multiplayer.

Una delle caratteristiche più interessanti è proprio la possibilità di utilizzare un sistema di avvio persistente attraverso il salvataggio speciale XSTRIG.Civ7Save.

Dopo la configurazione iniziale e il riavvio della console, è sufficiente selezionare il salvataggio dal menu Load Game per riattivare il loader. In alternativa, è possibile utilizzare direttamente l’iniezione dalla lobby multiplayer, mantenendo aperta la sessione sul PC.

Il pacchetto include inoltre pc-install-trigger.py, che automatizza l’installazione del trigger, e strumenti per controllare lo stato dell’exploit, monitorare le fasi di acquisizione e consultare i registri delle operazioni.

Una volta stabilita la connessione, il sistema espone le funzioni di lettura, scrittura e interrogazione del file system attraverso l’interfaccia RPC del progetto originale.

Il risultato è stato verificato su una Nintendo Switch 2 reale. Il test ha completato tutte le 26 fasi della procedura, confermando l’esecuzione sul file system e il mantenimento dell’endpoint RPC. L’intera operazione ha richiesto circa 669 secondi ed è andata a buon fine al secondo tentativo.

Per quanto riguarda i requisiti, è necessario disporre di una Nintendo Switch 2 con firmware 23.0.1 e di una cartuccia fisica di Civilization VII per Nintendo Switch originale, rigorosamente nella versione 1.0.0.

Per la procedura di iniezione dalla lobby occorre inoltre un PC Linux x86_64, una connessione Ethernet con la console e un adattatore Wi-Fi. Sono richiesti anche Python 3.10 o superiore, Node.js 20 o superiore e le proprie chiavi prod.keys, estratte dalla console.

IZCIVSwitch offre anche una modalità alternativa che permette di utilizzare il motore e il collegamento RPC su Windows, macOS e Linux, a condizione che il loader sia già stato avviato.

IZlauncher rimane invece un componente opzionale, installabile attraverso un salvataggio dedicato e richiamabile con una doppia pressione dello stick analogico destro.

È importante sottolineare che non siamo ancora davanti a un jailbreak completo o a un file manager grafico tradizionale. Il progetto consente di ottenere una sessione di accesso al file system attraverso strumenti RPC, ma rimane una soluzione sperimentale.

Gli stessi sviluppatori avvertono che alcune operazioni possono provocare il blocco della console, rendendo necessario uno spegnimento forzato. È quindi consigliabile effettuare un backup dei dati importanti prima di procedere.

Il progetto rappresenta comunque un risultato significativo per la scena homebrew: l’accesso al file system attraverso Civilization VII aggiunge una nuova possibilità alla catena di exploit ns2jb e potrebbe favorire lo sviluppo di ulteriori strumenti per Nintendo Switch 2.

Importante: Utilizzare con cautela. Questo software di ricerca può modificare i dati dei salvataggi di gioco e provocare il blocco della console. Effettuare un backup dei propri salvataggi prima dell’utilizzo. Un blocco potrebbe richiedere uno spegnimento completo e un successivo riavvio della console. Utilizzare il software esclusivamente con hardware e contenuti a cui si è autorizzati ad accedere. Il software viene fornito senza alcuna garanzia.

Installazione

Checksum. Il file SHA256SUMS del repository registra i file presenti nel tag v0.1.0. Per gli archivi delle release, utilizzare il file separato con i checksum SHA-256 disponibile nella sezione Assets della pagina di rilascio.

Leggere prima questa sezione. L’archivio della release non contiene prod.keys. Per l’iniezione dalla Lobby tramite PC è necessario fornire un dump della propria console.

1. Scaricare ed estrarre

Pacchetto Utilizzo
IZCIVSwitch-0.1.0-linux-x86_64.tar.gz Pacchetto completo: kit, runtime Lobby per PC e launcher; Linux x86_64.
IZCIVSwitch-0.1.0-source.zip Script, kit e launcher, senza runtime Lobby; da utilizzare con un’installazione esistente di iz2s-panel oppure con il file NRO per Switch 1.

Estrarre l’intero archivio in una cartella con permessi di scrittura. Non eseguire il programma direttamente dall’interno dell’archivio.


IZCIVSwitch-0.1.0/
├── IZCIVSwitch.py
├── pc-install-trigger.py
├── kit/                         # civswitch-kit originale
├── panel/                       # CivSwitchLDN lato PC (solo archivio completo)
│   └── data/
│       ├── runtime/civswitchldn/
│       └── private/civswitchldn/   <-- inserire qui prod.keys
├── izlauncher/                  # menu opzionale
├── README.md
├── DISCLAIMER.md
└── RELEASE_NOTES.md

2. Fornire prod.keys

prod.keys è necessario soltanto per l’iniezione dalla Lobby tramite PC (IZCIVSwitch.py --lobby e pc-install-trigger.py). Non è necessario per IZCIVSwitch.py --no-lobby / XSTRIG e non è incluso nella release.

Inserire il proprio file prod.keys nel seguente percorso: panel/data/private/civswitchldn/prod.keys

Permessi consigliati:


chmod 700 panel/data/private/civswitchldn
chmod 600 panel/data/private/civswitchldn/prod.keys

Il file deve essere un normale dump testuale di prod.keys estratto dalla propria console. Deve contenere almeno le seguenti voci di 32 caratteri esadecimali, che vengono controllate dal pannello LDN:


aes_kek_generation_source
aes_key_generation_source
master_key_00
master_key_12

title.keys non è necessario per l’injector Lobby. Non scaricare chiavi da fonti non attendibili e non inserirle mai in un repository.

Se non si dispone di prod.keys, saltare la procedura Lobby e utilizzare il file NRO per Switch 1 incluso nel kit originale per installare XSTRIG.Civ7Save. Successivamente, IZCIVSwitch.py --no-lobby non richiederà alcuna chiave.

3. Ripristinare le funzionalità raw-socket

Il runtime Lobby incluso nel pacchetto necessita delle capacità cap_net_admin e cap_net_raw sul seguente file: panel/data/runtime/civswitchldn/bin/python-ldn

Dopo aver estratto l’archivio, eseguire:

bash

sudo setcap cap_net_admin,cap_net_raw=ep \
  panel/data/runtime/civswitchldn/bin/python-ldn

getcap panel/data/runtime/civswitchldn/bin/python-ldn

Risultato previsto: cap_net_admin,cap_net_raw=ep

L’archivio completo è destinato a Linux x86_64 e il runtime Python incluso è compilato per Python 3.14. Su un’altra architettura o versione di Python, installare il runtime Lobby upstream di iz2s-panel e indicarlo allo script tramite --panel, oppure utilizzare il file NRO per Switch 1.

4. Verificare l’installazione


python3 -m py_compile IZCIVSwitch.py pc-install-trigger.py izlauncher/install.py
python3 pc-install-trigger.py --check

Risultato previsto:


panel : .../IZCIVSwitch-0.1.0/panel
kit   : .../IZCIVSwitch-0.1.0/kit
radio : phyN
[ok] LDN environment is ready

Se --check segnala prod.keys not ready, rileggere il passaggio 2. Se vengono segnalati problemi con le capacità, ripetere il passaggio 3. Se l’adattatore radio non viene rilevato, ricollegare l’adattatore Wi-Fi USB.

5. Avvio

Su Switch 2: Civ7 → MULTIPLAYER → WIRELESS → CREATE GAME → HOST LOBBY. Mantenere aperta la Lobby.

Sul PC:

cd IZCIVSwitch-0.1.0
python3 IZCIVSwitch.py --lobby --yes

Risultato positivo:

4/4 verified
FS ENDPOINT IS LIVE

Premendo Ctrl-C viene rilasciato l’endpoint FS e viene consentita la pulizia del motore.

Compatibilità

Solo Linux. La modalità PC Lobby funziona esclusivamente su Linux. Il runtime incluso è destinato all’architettura x86_64.

Requisiti della console:

Elemento Requisito
Switch 2 Firmware 23.0.1 (non aggiornare).
Civ7 Cartuccia fisica per Switch 1, versione 1.0.0.
PC Connessione Ethernet cablata alla console; adattatore Wi-Fi per l’iniezione dalla Lobby.

L’iniezione PC Lobby utilizza l’implementazione esistente di CivSwitchLDN: rilascia temporaneamente la scheda Wi-Fi, si connette alla Lobby di Civ7, invia il file compresso core.js attraverso 19 messaggi della chat e ripristina la connessione Wi-Fi. La connessione Ethernet rimane attiva.

Prima connessione

Se cambia l’indirizzo IP della console

La console potrebbe ricevere un nuovo indirizzo DHCP (ad esempio da .20 a .190). IZCIVSwitch.py controlla lo stato del pannello e la tabella ARP. La schermata del loader mostra sempre l’indirizzo effettivo: Awaiting payload at <IP>:9026

Se necessario, è possibile forzarlo: python3 IZCIVSwitch.py --lobby --yes --console-ip 10.42.0.190

Se cambia l’interfaccia Wi-Fi

Gli adattatori USB vengono enumerati nuovamente come phyN. Se l’interfaccia memorizzata non è più disponibile e ne viene rilevata esattamente una, lo script la seleziona automaticamente. Se sono presenti più interfacce: python3 IZCIVSwitch.py --lobby --yes --phy phy27

Modalità persistente: XSTRIG + Load Game

Questo è il ciclo di funzionamento convalidato del kit originale. Richiede una sola installazione e un riavvio, ma successivamente non necessita più della Lobby.

Installazione iniziale

Con il runtime PC Lobby e prod.keys disponibili:

# S2 deve trovarsi nella Host Lobby
python3 pc-install-trigger.py --yes

Lo script inietta core.js, attende il loader e successivamente esegue lo strumento originale kit/save-tools/restore_save.py kit/save-tools/trigger-recreate <IP>, creando il seguente file:


save:/saves/Single/XSTRIG.Civ7Save
1 195 911 bytes
sha256 c53a04e4ce432727c0e24348be240051b846595103ed06865b34c16bba810e7c

Gli altri salvataggi non vengono eliminati. Il comando ZR del file NRO per Switch 1 è quello che cancella i salvataggi della modalità giocatore singolo; questo programma di installazione per PC non lo fa.

Riavvio e avvio

  1. Eseguire uno spegnimento completo della Switch 2: tenere premuto il pulsante di accensione per 12 secondi, attendere 5 secondi e riaccendere la console.
  2. Avviare Civ7 → Load Game → XSTRIG.Civ7Save.
  3. Attendere il messaggio Awaiting payload at <IP>:9026.
  4. Sul PC eseguire: python3 IZCIVSwitch.py --no-lobby

In caso di errore, eseguire uno spegnimento completo, selezionare nuovamente Load Game → XSTRIG e ripetere la procedura. Il kit indica una percentuale di successo di circa il 30% per ogni avvio; sono normali 3-4 tentativi.

Opzionale: menu IZlauncher

La cartella izlauncher/ installa una voce di menu nel salvataggio save:/saves/Single/IZ2S.Civ7Save. La sessione FS principale funziona anche senza questo menu opzionale.

python3 izlauncher/install.py --ip <S2-IP>

Dopo il messaggio INSTALL DONE:

  1. Riavviare la Switch 2.
  2. Avviare Civ7 → Load Game → IZ2S.Civ7Save → menu.
  3. Premere due volte  (stick analogico destro) per avviare il loader integrato.
  4. Sul PC eseguire python3 IZCIVSwitch.py --no-lobby.

Ripristino:

python3 izlauncher/install.py --ip <S2-IP> \
--restore izlauncher/receipts/<uuid>/receipt.json

Monitoraggio e arresto

Mentre IZCIVSwitch.py è in esecuzione: node kit/port/engine/rpc.cjs <run-folder> status

Il bridge è attivo durante la fase 2/4, quindi il comando status può rispondere prima che l’accesso FS sia stato acquisito completamente. Per esaminare un’esecuzione senza avviare un nuovo motore: python3 IZCIVSwitch.py --inspect kit/port/engine/runs/<run-folder>

Prefissi di monitoraggio:

Prefisso Significato
[engine] Righe selezionate di run.cjs.
[run] run.log: fasi della pipeline.
[fs] profile / [fs] retry Scansione fs-race.
[fs] heartbeat Fase, tentativo, tempo trascorso, chiamate RPC e inattività.
[fs] WARNING Nessun progresso nell’acquisizione per 180 secondi.
RUN SUMMARY Esito verificato o errore, fasi e ultimi tentativi.

Premendo Ctrl-C viene rilasciato l’endpoint. Se il processo non termina, utilizzare kill <pid>; la console potrebbe rimanere bloccata.

Cosa è possibile fare

  • Mantenere attivo un endpoint FS RPC Stage 2 sulla console.
  • Utilizzare gli strumenti RPC del kit (rpc.cjs, operazioni di basso livello call, read, write e query).
  • Eseguire il dump del CodeFS di sistema con --dump-firmware (sono necessari almeno 512 MiB di spazio libero).
  • Installare il menu opzionale IZlauncher.
  • Utilizzare XSTRIG + Load Game per ottenere un punto di accesso persistente senza Lobby o Switch 1.

Non si tratta di un file manager grafico. Le operazioni sul file system vengono esposte attraverso la pipeline RPC/RO del kit originale.

Risoluzione dei problemi

Problema Verifica
prod.keys not ready Inserire il proprio dump in panel/data/private/civswitchldn/prod.keys; verificare le voci richieste nel passaggio 2.
capabilitiesReady: false Ripetere il comando setcap del passaggio 3.
radio phyN is absent Ricollegare l’adattatore Wi-Fi USB; con una sola interfaccia viene selezionata automaticamente, con più interfacce utilizzare --phy.
loader did not answer La Switch 2 non si trova nella Host Lobby oppure l’indirizzo IP è cambiato; specificarlo tramite --console-ip.
Got unstable rw primitive + 604:48 / 657:28 L’exploit JavaScript iniziale di Civ7 non è riuscito a ottenere una primitiva stabile; nessun endpoint :9026 è disponibile. Eseguire un riavvio forzato e riprovare.
FS acquisition did not complete Errore probabilistico nella fs-race; eseguire un riavvio forzato e ripetere la procedura.
Blocco su 2/4, con valore idle in aumento Blocco del processo; eseguire uno spegnimento completo tenendo premuto il pulsante di accensione per 12 secondi.
rpc.cjs status → ECONNREFUSED Il motore è fermo oppure il bridge è occupato; utilizzare --inspect.
RUN SUMMARY verified: False Consultare il riepilogo e il file switch2/acquisition.log.
Piattaforma PC e Python incluso La modalità PC Lobby richiede Linux. Il runtime incluso è destinato a Linux x86_64 e utilizza Python 3.14.

--max-runtime è impostato su 900 secondi per impostazione predefinita; --max-runtime 0 consente di utilizzare il budget di tentativi del kit pari a 3 × 10 minuti.

Privacy e sicurezza

  • Gli script vengono eseguiti localmente e non contattano alcun servizio cloud.
  • Mantenere private le chiavi specifiche della console. Non inserirle mai in un repository e non condividerle. Gli archivi delle release escludono le chiavi della console e il file NRO per Switch 1.
  • Il toolkit può scrivere nei salvataggi di gioco e creare dati temporanei in save:/. Consultare l’avviso di sicurezza per conoscere i rischi legati all’utilizzo.
  • La release non include marchi Nintendo né risorse grafiche dei giochi.

Download IZCIVSwitch v0.1.0

Alcune parti di questo articolo sono state generate con l’aiuto dell’intelligenza artificiale.

🔥 Prodotti in promozione e articoli più venduti: Xbox Series

Vedi altri prodotti Xbox Series

Questo articolo contiene link affiliati a Amazon. Se acquisti tramite questi link, potrei guadagnare una commissione senza costi aggiuntivi per te.

Ultimo aggiornamento 2026-11-20 / Link di affiliazione / Immagini da Amazon Product Advertising API

LASCIA UN COMMENTO

Per favore inserisci il tuo commento!
Per favore inserisci il tuo nome qui
Captcha verification failed!
Punteggio utente captcha non riuscito. Ci contatti per favore!

Questo sito utilizza Akismet per ridurre lo spam. Scopri come vengono elaborati i dati derivati dai commenti.