HATS Installer Payload è un nuovo strumento pensato per rendere ancora più semplice e sicura l’installazione dei pacchetti HATS sulla console Nintendo Switch, soprattutto nelle fasi iniziali della modifica.

Rilasciato da sthetix, lo stesso autore dei pacchetti HATS, questo payload nasce come soluzione minimale ma estremamente efficace per installare un ambiente CFW completo direttamente dalla modalità RCM, senza dover avviare Horizon OS.

Upcoming HATS Tools + payload, based on Sphaira , will be released soon.

Merry Xmas for everyone out there! pic.twitter.com/QeGco9w63k

— sthetix (@sthetixofficial) December 25, 2025

Il progetto si integra perfettamente con HATS Tools, andando a coprire lo scenario “low-level” dell’installazione. Dove HATS-Tools lavora dall’interno del sistema, HATS Installer Payload opera prima ancora che la console avvii il sistema operativo, risultando ideale per console appena moddate, ripristini completi o situazioni di recovery.

In pratica, insieme formano un ecosistema coerente che permette di gestire i pacchetti HATS in ogni fase della vita di una Switch modificata.

Dal punto di vista tecnico, HATS Installer Payload è basato su codice derivato da TegraExplorer ed Hekate, due strumenti molto apprezzati per affidabilità e semplicità.

Il payload si occupa di copiare automaticamente sulla scheda SD tutti i componenti essenziali di un pacchetto HATS, come Atmosphere, Hekate, sigpatches, Tinfoil e vari homebrew, partendo da una struttura di staging preparata in precedenza.

L’utente deve semplicemente estrarre le cartelle necessarie del pacchetto HATS all’interno di una directory dedicata sulla SD, senza dover gestire manualmente decine o centinaia di file.

Tramite un semplice file di configurazione opzionale, è possibile scegliere se sovrascrivere solo i file esistenti, effettuare un’installazione parzialmente pulita cancellando solo Atmosphere, oppure eseguire una vera installazione “clean” che rimuove completamente Atmosphere, bootloader e homebrew prima di copiare i nuovi file.

Questo approccio riduce il rischio di errori e consente di adattare il comportamento del tool a ogni situazione, dall’aggiornamento rapido alla reinstallazione totale.

Una volta iniettato il payload in modalità RCM, il processo è completamente automatico. La SD viene montata, la configurazione letta se presente, le cartelle pulite secondo la modalità scelta e i file copiati nella root.

Al termine, la cartella di staging viene eliminata e viene generato un file di log dettagliato, utile in caso di problemi o per verificare cosa è stato fatto.

Se sulla SD è presente un payload finale, come Hekate, HATS Installer Payload lo avvia automaticamente, permettendo di proseguire senza interruzioni nel boot della console.

La semplicità dell’interfaccia riflette la filosofia del progetto: niente elementi superflui, solo una barra di avanzamento e messaggi chiari che mostrano cosa sta accadendo.

Questo lo rende particolarmente adatto sia agli utenti esperti che cercano uno strumento rapido ed efficiente, sia a chi aiuta amici o conoscenti a moddare la Switch e vuole ridurre al minimo le possibilità di errore.

HATS Installer Payload è particolarmente utile per le installazioni da zero, quando la console non ha ancora un CFW funzionante, ma anche per il recupero rapido in caso di problemi o corruzione dei file.

In combinazione con HATS Tools, permette di coprire sia l’installazione iniziale da RCM sia la gestione quotidiana e gli aggiornamenti direttamente dalla console, con un livello di automazione e sicurezza difficilmente raggiungibile con i metodi tradizionali.

Funzionalità

• Tre modalità di installazione – Permette di scegliere come installare il pacchetto HATS in base alle proprie esigenze.
• Visualizzazione avanzamento – Barre di progresso e messaggi di stato chiari durante l’installazione.
• Log degli errori – Registri dettagliati salvati in sd:/hats-install.log per il debug.
• Chain di payload – Avvio automatico di un altro payload al termine dell’installazione.
• Ingombro minimo – Payload di dimensioni ridotte per un caricamento rapido.

Modalità di installazione

Utilizzo

1. Preparazione dei file

Posizionare i file del pacchetto HATS sulla scheda SD nel seguente modo:

sd:/hats-staging/
├── atmosphere/
├── bootloader/
├── switch/
└── manifest.json

[hats]
install_mode=default

3. Avvio

Utilizzare Hekate o un altro bootloader per avviare hats-installer.bin.

Cosa succede durante l’installazione

1. Il payload monta la scheda SD.
2. Legge la configurazione, se presente.
3. Verifica la directory di staging.
4. Esegue la pulizia in base alla modalità di installazione selezionata.
5. Copia i file dalla cartella di staging alla root della SD.
6. Elimina la directory di staging e i file di versione HATS.
7. Avvia il payload successivo, se esiste sd:/payload.bin

Configurazione

Il payload legge la configurazione dal file sd:/config/hats-tools/config.ini:

[hats]
install_mode=default ; Opzioni: replace, default, clean

Struttura del progetto

hats-payload/
├── source/           # Codice sorgente principale
│ ├── main.c          # Punto di ingresso e logica di installazione
│ ├── fs.c            # Operazioni sul file system
│ ├── gfx.c           # Utility grafiche
│ └── libs/           # Libreria FatFS
├── bdk/              # Blue Development Kit
├── config-sample.ini # Esempio di configurazione
├── Makefile          # Configurazione di build
└── build/            # Directory di output della build

Log

I log dell’installazione vengono salvati in sd:/hats-install.log per la risoluzione dei problemi.

Integrazione

Questo payload fa parte dell’ecosistema HATS:

• Funziona insieme a HATS-Updater per gli aggiornamenti automatici.
• Gestisce il file manifest.json per il tracciamento delle versioni.
• Si integra con il sistema di distribuzione dei pacchetti HATS.

Download: HATS Installer Payload v1.0.0

Download: Source code HATS Installer Payload v1.0.0