Il celebre sviluppatore Bernardo Giordano ha pubblicato un nuovo aggiornamento di Checkpoint, definito come il più importante dalla nascita del progetto avvenuta circa nove anni fa.

Con la versione 5.0.0, l’applicazione cambia completamente filosofia: non è più soltanto un semplice strumento per il backup e la gestione dei salvataggi, ma diventa un vero e proprio framework di gestione dei save, capace di essere esteso dagli utenti attraverso script personalizzati.

La grande novità di questa versione è infatti l’introduzione di un sistema di scripting integrato. Checkpoint ora può eseguire direttamente sulla console degli script scritti in linguaggio C, senza bisogno di compilazione, ricompilazione o modifiche al sistema.

Gli script possono essere copiati sulla scheda SD e utilizzati per aggiungere nuove funzioni all’applicazione, permettendo alla community di creare strumenti personalizzati che in passato sarebbero stati impossibili da integrare direttamente nel programma.

Gli script vengono caricati dalla cartella dedicata nella scheda SD e possono essere associati a tutti i giochi oppure soltanto a determinati titoli.

Attraverso la nuova API inclusa con Checkpoint, gli sviluppatori possono accedere alle stesse funzioni interne utilizzate dall’applicazione, comprese la gestione dei salvataggi, la lettura e scrittura dei file, la gestione degli archivi, le richieste HTTP, l’upload di file, il parsing JSON e la creazione di interfacce grafiche direttamente all’interno di Checkpoint.

Aggiunto anche un nuovo menu Scripts, raggiungibile tramite il pulsante su Nintendo 3DS e tramite il tasto su Nintendo Switch.

Durante l’esecuzione di uno script, l’applicazione mette a disposizione una console interattiva con log scorrevoli, finestre di conferma, tastiere virtuali, selettori e barre di avanzamento.

Gli utenti possono inoltre interrompere qualsiasi script tenendo premuto il tasto , anche nel caso in cui il programma rimanga bloccato in un ciclo infinito, senza dover riavviare la console.

Un’altra importante aggiunta riguarda il sistema di sicurezza per la memorizzazione delle credenziali. Grazie alla nuova API di crittografia, gli script possono salvare token e password sulla scheda SD in modo protetto tramite una chiave legata alla console, con la possibilità di aggiungere anche una password personale.

La nuova architettura basata sugli script ha permesso il ritorno di alcune funzioni storiche di Checkpoint. Il cheat manager è nuovamente disponibile grazie allo script Sharkive, che scarica automaticamente il database aggiornato dei trucchi e permette di selezionare quelli desiderati per ogni gioco, generando i file compatibili con Luma3DS su Nintendo 3DS e Atmosphère su Nintendo Switch.

Tra le nuove funzioni arriva anche il supporto al backup cloud. Lo script googledrive permette di sincronizzare i salvataggi direttamente con il proprio account Google Drive tramite il sistema di autenticazione ufficiale tramite codice.

È possibile sincronizzare tutti i giochi, un singolo titolo o anche un singolo backup, mentre i file già presenti vengono automaticamente ignorati per evitare copie inutili. Le credenziali vengono protette utilizzando il nuovo sistema di crittografia.

Introdotto inoltre lo script webdav, che consente di sincronizzare i salvataggi con qualsiasi server compatibile WebDAV, inclusi soluzioni come Nextcloud, ownCloud, Synology e altri sistemi di cloud personale.

Oltre al caricamento dei backup, è possibile anche scaricarli nuovamente sulla console e ripristinarli attraverso il normale sistema di Checkpoint.

Per Nintendo 3DS l’aggiornamento porta diverse correzioni e miglioramenti. Aggiunto un nuovo menu rapido per accedere alle impostazioni e agli script, mentre è stato risolto un problema con i salvataggi della Virtual Console GBA, che ora possono essere trasferiti correttamente tra console diverse.

In precedenza questi backup erano legati al sistema che li aveva creati e potevano fallire durante il ripristino; ora Checkpoint salva direttamente il file del salvataggio e lo rigenera correttamente per la console destinataria.

Sono stati inoltre migliorati il supporto agli emulatori, eliminando il blocco causato dal controllo Rosalina quando viene rilevato un ambiente emulato, e sistemati diversi problemi grafici legati alle finestre di dialogo e alla gestione della memoria.

Anche la versione Nintendo Switch riceve numerose migliorie, tra cui il nuovo accesso agli script dalla barra laterale, la risoluzione del blocco durante la selezione dell’account mentre venivano calcolate le dimensioni dei backup, la correzione dei nomi troncati dei salvataggi e una gestione più dettagliata degli errori per facilitare la diagnosi dei crash.

L’aggiornamento coinvolge anche chlink, lo strumento per il trasferimento dei backup, che ora mantiene correttamente le estensioni dei file durante gli spostamenti e registra informazioni più dettagliate sui trasferimenti, indicando dimensioni, destinazioni e progressi in caso di errore.

Infine, questa versione amplia il supporto linguistico con l’aggiunta della traduzione in cinese semplificato, portando il programma a supportare inglese, italiano, francese, tedesco, portoghese, spagnolo, olandese, giapponese e cinese semplificato.

Caratteristiche

Checkpoint permette di eseguire il backup e il ripristino dei dati di salvataggio per:

• Nintendo 3DS: Cartucce 3DS e titoli digitali (incluse le demo), dati extra (extdata), cartucce DS, giochi DSiWare e titoli GBA Virtual Console.
• Nintendo Switch: Salvataggi dei titoli utilizzati, con informazioni sui giochi caricate automaticamente.

Entrambe le versioni condividono lo stesso insieme di funzionalità principali:

• Interfaccia utente completamente ridisegnata, con supporto ai temi chiaro e scuro.
• Una nuova sezione Impostazioni che permette di configurare tutto direttamente dalla console: preferiti, filtri, cartelle aggiuntive per i salvataggi e molto altro, senza dover modificare manualmente i file.
• Supporto internazionale con traduzioni disponibili in inglese, italiano, francese, tedesco, portoghese, spagnolo, olandese, giapponese e cinese.
• Operazioni sui file rapide e reattive: backup e ripristini vengono eseguiti tramite un processo separato e i backup possono essere annullati mentre sono in corso.
• Supporto a cartelle aggiuntive per i salvataggi, configurabili per ogni titolo tramite un browser integrato.
• Server FTP in background per accedere direttamente ai backup dei salvataggi dal PC.
• Trasferimento wireless dei salvataggi tra console.
• Server HTTP per i log, che permette di visualizzare in tempo reale i registri di Checkpoint tramite qualsiasi browser collegato alla stessa rete.

Funzionalità aggiuntive della versione Switch

Su Nintendo Switch, Checkpoint offre inoltre:

• Un backend grafico basato su deko3d, che rende l’applicazione circa il 70% più piccola rispetto alla versione precedente.
• Supporto alla modalità dock con risoluzione 1080p, oltre alla modalità portatile a 720p.
• Verifica file per file dopo il ripristino dei salvataggi e una gestione più sicura dei ripristini di grandi dimensioni.

chlink

Checkpoint include chlink, un’applicazione da riga di comando per PC che comunica con la funzione di trasferimento wireless dei salvataggi di Checkpoint.

Grazie a chlink è possibile inviare i backup dei salvataggi dal PC alla console e ricevere i salvataggi dalla console al computer tramite la rete locale, senza utilizzare cavi o dover rimuovere e reinserire la scheda SD.

I trasferimenti sono protetti da un PIN a quattro cifre mostrato direttamente sulla console. Inoltre, chlink riconosce automaticamente i backup provenienti dalla struttura delle cartelle utilizzata dalla scheda SD di Checkpoint, compilando in automatico le informazioni relative al titolo e al backup.

chlink è disponibile come singolo eseguibile senza dipendenze per Windows, macOS e Linux.

Utilizzo

Checkpoint per Nintendo 3DS può essere utilizzato sia con Custom Firmware (CFW) sia con Homebrew Launcher basati su Rosalina. Gli Homebrew Launcher basati su hax non sono supportati da Checkpoint.

Checkpoint per Nintendo Switch funziona tramite Homebrew Launcher. Assicurarsi di utilizzare payload aggiornati.

Il primo avvio richiederà più tempo del normale perché verranno create le cartelle di lavoro necessarie. Dopo questa prima configurazione, Checkpoint sarà molto più veloce durante gli avvii successivi.

Percorso di lavoro

Checkpoint utilizza le seguenti cartelle per archiviare i file generati dall’applicazione. Tutte le directory necessarie vengono create automaticamente al primo avvio oppure quando viene rilevato un nuovo titolo privo di cartella dedicata.

Nintendo 3DS

• sdmc:/3ds/Checkpoint — percorso principale dell’applicazione.
• sdmc:/3ds/Checkpoint/config.json — file di configurazione.
• sdmc:/3ds/Checkpoint/logs — cartella contenente i file di log.
• sdmc:/3ds/Checkpoint/saves/<unique id> <game title> — percorso principale dove vengono salvati tutti i backup dei salvataggi di un determinato gioco.
• sdmc:/3ds/Checkpoint/extdata/<unique id> <game title> — percorso principale dove vengono salvati tutti i backup degli extdata di un determinato gioco.

Nintendo Switch

• sdmc:/switch/Checkpoint — percorso principale dell’applicazione.
• sdmc:/switch/Checkpoint/config.json — file di configurazione.
• sdmc:/switch/Checkpoint/logs — cartella contenente i file di log.
• sdmc:/switch/Checkpoint/saves/<title id> <game title> — percorso principale dove vengono salvati tutti i backup dei salvataggi di un determinato gioco.

Configurazione

Tutte le opzioni che in passato richiedevano la modifica manuale del file di configurazione ora possono essere gestite direttamente dalla sezione Impostazioni presente sulla console.

Il file config.json continua comunque a essere salvato nella cartella di lavoro di Checkpoint, ma non è più necessario modificarlo manualmente.

Risoluzione dei problemi

Checkpoint mostra codici di errore quando si verificano problemi o quando alcune operazioni non vengono completate correttamente.

In caso di difficoltà, è consigliato verificare che il problema non sia già stato segnalato e, quando si apre una nuova segnalazione, fornire il codice di errore insieme a una descrizione delle operazioni eseguite per permettere di riprodurre il problema.

È inoltre possibile ricevere assistenza in tempo reale entrando nel server Discord di FlagBrew.

Changelog

Checkpoint 4.0.0 è stato il più grande aggiornamento mai realizzato per l’applicazione. La versione 5.0.0 ridefinisce completamente ciò che Checkpoint è in grado di fare.

Checkpoint ora è un vero e proprio framework per la gestione dei salvataggi: tutte le operazioni che l’applicazione può eseguire sui file di salvataggio sono disponibili anche tramite gli script creati dagli utenti e copiati direttamente sulla scheda SD.

Questo permette alla console di ottenere funzionalità che nessuna versione precedente di Checkpoint aveva mai incluso.

Il gestore dei trucchi torna nuovamente disponibile grazie a uno di questi script, così come la sincronizzazione dei salvataggi sul cloud, sia tramite Google Drive sia attraverso qualsiasi server WebDAV già configurato dall’utente.

Scripting: cosa c’è di nuovo

• Aggiunto: Un motore di scripting. Checkpoint ora può eseguire script in linguaggio C interpretati direttamente sulla console. Uno script è semplicemente un singolo file .c presente sulla scheda SD: non è necessario alcun compilatore, ricompilazione o modifica del firmware.
  • Gli script vengono salvati nella cartella: sdmc:/<3ds|switch>/Checkpoint/scripts/universal per essere disponibili con qualsiasi gioco, oppure nella cartella scripts/<title id> per renderli disponibili solo per un determinato titolo.
  • Aggiunto: Un nuovo menu Scripts, accessibile tramite il pulsante su Nintendo 3DS e tramite il pulsante  su Nintendo Switch.
  • Gli script dispongono di una API nativa tramite #include <checkpoint.h>, che permette di utilizzare le stesse funzioni interne sfruttate dall’applicazione stessa, tra cui il catalogo dei titoli, gli archivi dei salvataggi (compresi extdata e shared extdata su 3DS) con possibilità di leggere, scrivere, eliminare, elencare e confermare i file, oltre alla gestione della scheda SD, compressione e decompressione ZIP, richieste HTTP, caricamento di file tramite streaming, analisi JSON e finestre dell’interfaccia grafica renderizzate direttamente da Checkpoint.
  • Aggiunta: Una nuova interfaccia console dedicata agli script. Quando uno script è in esecuzione, prende il controllo dello schermo: il suo output viene mostrato in un pannello di log scorrevole, mentre messaggi, conferme, selettori, tastiere virtuali e barre di avanzamento secondarie vengono visualizzati sul secondo schermo del Nintendo 3DS oppure in una scheda sovrapposta al registro su Nintendo Switch.
  • Aggiunta: La possibilità di interrompere gli script. Tenendo premuto il pulsante  è possibile terminare qualsiasi script, anche nel caso in cui sia bloccato in un ciclo infinito, senza dover riavviare la console.
  • Aggiunta: Una nuova API di protezione (“sealing API”) che permette agli script di salvare dati sensibili come token e password sulla scheda SD in forma crittografata, utilizzando una chiave legata alla console e, opzionalmente, una passphrase scelta dall’utente.
  • Gli script includono inoltre la libreria standard C di picoc, con il supporto alle librerie: stdio, stdlib, string, unistd, ctype, math e time.
• Aggiunto: Documentazione completa sul sistema di scripting disponibile in scripts/README.md, con il riferimento alle API, i limiti dell’interprete, esempi pratici e una checklist dedicata sia agli sviluppatori umani sia agli autori di script basati su IA.
  • scripts/examples/example.c è un esempio eseguibile che offre una panoramica guidata delle API, con una voce di menu dedicata per ogni area funzionale.
  • tools/scriptlint.sh esegue un controllo di analisi sui tuoi script direttamente dal PC, prima che vengano copiati sulla scheda SD.
• Risolto: Le eccezioni generate durante l’esecuzione di uno script ora vengono intercettate e mostrate all’utente, invece di causare la chiusura imprevedibile dell’applicazione.

Script raggruppati

• Aggiunto: sharkive, con il quale torna disponibile il gestore dei trucchi.
  • Lo script scarica il database Sharkive più aggiornato, permette di scegliere i trucchi per ogni titolo e genera i file cheat compatibili con quelli richiesti da Luma3DS (Nintendo 3DS) e Atmosphère (Nintendo Switch).
  • Poiché ora il gestore dei trucchi è stato trasformato in uno script, il database dei cheat segue direttamente gli aggiornamenti di Sharkive senza dover attendere una nuova versione di Checkpoint. Questo risolve uno dei problemi di manutenzione che aveva portato alla rimozione della funzione nella versione 4.0.0.
  • Nota: Se i trucchi distribuiti tramite Sharkive non sono soddisfacenti, è possibile segnalare problemi, inviare patch al repository oppure contribuire creando uno script che scarichi i cheat da un altro provider. Checkpoint è progettato per accogliere contributi dalla community.
• Aggiunto: googledrive, per sincronizzare i backup dei salvataggi con il proprio account Google Drive.
  • L’accesso avviene tramite il sistema di autenticazione tramite dispositivo di Google: la console mostra un codice che deve essere inserito tramite smartphone o PC.
  • È possibile sincronizzare tutti i salvataggi, un singolo titolo oppure un singolo backup. Ogni salvataggio viene caricato come archivio ZIP e quelli già presenti online vengono automaticamente ignorati.
  • Le credenziali vengono protette tramite la nuova API di crittografia, quindi non vengono mai salvate in chiaro sulla scheda SD. Le istruzioni per la configurazione sono disponibili nel file scripts/googledrive.md.
• Aggiunto: webdav, per sincronizzare gli stessi backup con qualsiasi server WebDAV già disponibile, come Nextcloud, ownCloud, Synology, Apache mod_dav, rclone serve webdav e molte applicazioni NAS con funzione di cloud personale.
  • È possibile caricare tutti i titoli, un singolo gioco oppure un solo backup, evitando automaticamente il caricamento dei file già presenti sul server. È inoltre possibile scaricare nuovamente un backup sulla console, dove il normale sistema di ripristino di Checkpoint prenderà il controllo.
  • Anche in questo caso le credenziali vengono protette tramite la nuova API di crittografia. Le istruzioni di configurazione, compresi gli URL base corretti per i server più comuni, sono disponibili in scripts/webdav.md. Il file tools/webdav-testserver.py permette inoltre di creare un server WebDAV temporaneo sul PC per testare l’intero processo di sincronizzazione.
• Aggiunto: playcoins, per modificare le Play Coins della console Nintendo 3DS.
  • Nota: La gestione delle Play Coins ora è disponibile esclusivamente tramite script.

3DS: Cosa c’è di nuovo

• Aggiunto: Un nuovo menu sovrapposto per accedere rapidamente alle impostazioni e agli script.
• Risolto: Ora i salvataggi della Virtual Console GBA possono essere trasferiti correttamente tra console diverse. (#557). In passato il backup comprendeva l’intero contenitore del sistema della console, firmato per il dispositivo che lo aveva creato. Di conseguenza, il ripristino su una console diversa poteva fallire oppure completarsi senza modificare realmente il salvataggio del gioco.
  • Ora il backup contiene solamente il file del salvataggio originale, lo stesso file .sav da 512 byte a 128 KB utilizzato dagli emulatori o da GodMode9. Durante il ripristino il file viene reinserito nel contenitore e firmato nuovamente per la console sulla quale viene effettuato il recupero.
  • I backup creati dalle versioni precedenti di Checkpoint continuano comunque a essere compatibili con il ripristino.
• Risolto: Checkpoint ora funziona anche sugli emulatori. Il controllo Rosalina hb:ldr viene ignorato quando viene rilevato un ambiente emulato, evitando il blocco dell’avvio.
• Risolto: Le finestre di dialogo ora calcolano correttamente dimensioni e disposizione del testo, evitando il taglio di stringhe più lunghe o tradotte.
• Risolto: un problema di corruzione della memoria nel callback della finestra di selezione.
• Aggiunti inoltre miglioramenti generali alla stabilità del sistema per migliorare l’esperienza dell’utente.

Switch: Le novità

• Aggiunto: Un nuovo collegamento agli Script nella barra laterale e un menu sovrapposto per accedere alle impostazioni e agli script.
• Risolto: L’applicazione non si blocca più quando il selettore degli account viene aperto mentre sono ancora in corso i calcoli delle dimensioni dei backup. Il processo dedicato al calcolo delle dimensioni viene ora sospeso durante l’apertura dell’applet.
• Risolto: I nomi dei backup troncati nella lista dei salvataggi.
• Risolto: Le finestre di dialogo modali ora misurano e dispongono il testo correttamente, quindi il testo più lungo e le stringhe tradotte non vengono più troncate.
• Risolto: I thread vengono chiusi correttamente quando l’applicazione viene terminata forzatamente.
• Risolto: Gli errori non gestiti vengono ora registrati con molti più dettagli, permettendo una diagnosi più precisa dei crash tramite i log.
• Aggiunti inoltre miglioramenti generali alla stabilità del sistema.

chlink: Cosa c’è di nuovo?

• Risolto: Quando un backup veniva trasferito come singolo file invece che come archivio ZIP, ad esempio un salvataggio di una cartuccia DS o un salvataggio della Virtual Console GBA, il punto presente nel nome veniva rimosso (00000001.sav diventava 00000001 sav), rendendo impossibile il ripristino.
  • I backup già ricevuti con un nome corrotto non vengono persi: viene ripristinata una cartella di backup non elaborata contenente un singolo file, indipendentemente dal nome di tale file.
• Aggiunto: Il ricevitore ora registra ogni file salvato indicando dimensione e destinazione, oltre a mostrare il punto raggiunto in caso di errore durante il trasferimento.

Traduzioni

• Aggiunta: La traduzione in cinese semplificato (grazie a @JeanPhoenixWong).
  • Le lingue attualmente supportate includono inglese, italiano, francese, tedesco, portoghese, spagnolo, olandese, giapponese e cinese semplificato.
  • Se sei madrelingua e ritieni che la formulazione e l’aspetto del testo nell’interfaccia utente possano essere migliorati, invia una pull request o apri una segnalazione in questo repository.

Download: Checkpoint v5.0.0 per console Switch (NRO) (ELF)

Download: Checkpoint v5.0.0 per console 3DS (CIA) (3DSX) (ELF)

Download: chlink darwin amd64 (arm64)

Download: chlink Linux amd64 (arm64)

Download: chlink Windows amd64

Download: Source code Checkpoint v5.0.0

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