Pubblicato un rapido aggiornamento per HATS Installer Payload, il nuovo strumento ideato per semplificare e rendere più sicura l’installazione dei pacchetti HATS sulle console Nintendo Switch, in particolare 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.

It is now released! https://t.co/Gyvl4tApQ8

and https://t.co/CkOINNgIaw

both should be downloaded and extracted to the sd card pic.twitter.com/Rf72cK29FG

— sthetix (@sthetixofficial) January 3, 2026

Il payload si basa su TegraExplorer e Hekate, strumenti sviluppati da CTCaer, naehrwert e shchmue, e introduce diverse funzionalità che lo rendono versatile e affidabile.

Tra le funzionalità principali vi sono quattro modalità di installazione che consentono di scegliere come applicare i pacchetti HATS, una barra di avanzamento visiva con messaggi di stato, un sistema di gestione degli errori con report dettagliati sullo schermo e la possibilità di lanciare automaticamente un altro payload al termine dell’installazione.

Funzionalità

• Quattro 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.
• Gestione degli errori – Segnalazione dettagliata degli errori direttamente a schermo.
• 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=overwrite

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=overwrite     ; 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

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.

Changelog

Questa versione introduce una nuova modalità di installazione per offrire agli utenti un maggiore controllo sul processo di installazione.

Cambiamenti

Nuove modalità di installazione. Il payload ora supporta 4 modalità di installazione distinte:

• overwrite – Sovrascrive solo i file (nessuna eliminazione), opzione più sicura per chi utilizza cheat di gioco.
• replace_ams – Elimina solo la cartella /atmosphere.
• replace_ams_bl – Elimina le cartelle /atmosphere e /bootloader (NUOVO).
• clean – Elimina /atmosphere, /bootloader e /switch.

Dettagli tecnici

• Aggiunto il valore enum MODE_REPLACE_AMS_BL per la nuova modalità con eliminazione del bootloader.
• Aggiornato l’array mode_names per riflettere la nuova convenzione di denominazione delle modalità.
• Modificata la modalità di installazione predefinita in MODE_OVERWRITE per un comportamento più sicuro.
• Aggiornata la logica di pulizia in do_install() per gestire correttamente tutte e 4 le modalità.
• Aumentato il ciclo di parsing per supportare 4 modalità di installazione.

Download: HATS Installer Payload v1.0.1

Download: Source code HATS Installer Payload v1.0.1