Sono stati pubblicati in rapida successione tre aggiornamenti per KeyX, il plugin sviluppato da TOM-BadEN pensato per offrire un controllo avanzato e altamente personalizzabile dei tasti su Nintendo Switch.

Il progetto continua a crescere in modo significativo, puntando non solo a migliorare stabilità e prestazioni, ma anche ad ampliare in maniera concreta le funzionalità legate a macro, rimappatura dei pulsanti e modalità Turbo, con un’attenzione particolare all’accessibilità e all’esperienza d’uso.

Con la versione 1.5.3, KeyX ha introdotto uno dei cambiamenti più importanti finora, risolvendo definitivamente un bug critico che poteva causare il blocco del joystick durante l’esecuzione delle macro con Joy-Con e Pro Controller.

Aggiunta inoltre un’opzione dedicata ai Joy-Con per attivare o disattivare il rapid fire separatamente su controller sinistro o destro.

Il cuore dell’aggiornamento riguarda però l’introduzione del Macro Store, uno store comunitario che consente di scaricare macro con un solo clic direttamente sulla console, visualizzando informazioni come autore e istruzioni d’uso.

Lo store è contestuale al gioco in esecuzione e, in assenza di un titolo avviato, mostra tutte le macro installate.

Parallelamente, è stata migliorata in modo profondo l’interfaccia di dettaglio delle macro e il Macro Editor, che ora include sistemi di backup automatici, nuove funzioni di modifica avanzata, operazioni batch e una gestione più accurata dei dati.

Anche la registrazione, la lista e la riproduzione delle macro sono state ottimizzate per evitare conflitti con gli input dell’utente e migliorare l’affidabilità complessiva.

A completare il pacchetto, sono arrivati il supporto alla lingua tedesca, il controllo automatico degli aggiornamenti e diverse correzioni tecniche, inclusi problemi di rete e perdite di risorse.

L’aggiornamento 1.5.4 si è concentrato invece su un fix mirato ma fondamentale, risolvendo un problema che impediva la visualizzazione delle macro scaricate nella versione precedente.

In alcuni casi, dopo l’aggiornamento, le macro potevano non mostrare correttamente i nomi localizzati, situazione risolvibile con una nuova installazione delle stesse. Anche in questo caso, è stata mantenuta la possibilità di aggiornare direttamente dal menu impostazioni.

Infine, con la versione 1.5.5, KeyX ha compiuto un ulteriore passo in avanti rendendo disponibile globalmente la funzione di upload delle macro, accessibile dalla pagina dei dettagli.

I contenuti caricati dagli utenti vengono sincronizzati con il repository GitHub del progetto, rafforzando l’approccio community-driven.

Sono state inoltre introdotte nuove opzioni per modificare le descrizioni nello store, ottimizzato l’uso della memoria dell’overlay, migliorata l’interfaccia del changelog con supporto allo scrolling e risolti diversi bug, inclusi problemi di visualizzazione delle istruzioni e un potenziale crash durante la registrazione delle macro.

Il team ha anche ringraziato pubblicamente i collaboratori che hanno reso possibile l’infrastruttura server e web.

Problemi di prestazioni delle funzioni attuali

Funzione	Joy-Con	Split di terze parti (MoPai Twin Star Gen2)	Joy-Con via Bluetooth	Switch Lite	Controller di terze parti (Octopus 4)	Pro Controller
Turbo	Perfetto ①	Perfetto ①	Non disponibile	Perfetto	Disponibile ②	Non testato ③
Rimappatura tasti	Perfetto	Perfetto	Perfetto	Perfetto	Perfetto	Perfetto
Macro	Disponibile ④	Disponibile ④	Non disponibile	Perfetto	Disponibile ④	Non testato ③

Funzioni combinate	Joy-Con	Split di terze parti (MoPai Twin Star Gen2)	Joy-Con via Bluetooth	Switch Lite	Controller di terze parti (Octopus 4)	Pro Controller
Turbo + Rimappatura	Perfetto ①	Perfetto ①	Non disponibile	Perfetto	Disponibile ②	Non testato ③
Turbo + Macro	La funzione turbo viene temporaneamente disabilitata durante la riproduzione della macro.
Rimappatura + Macro	Se i tasti riprodotti dalla macro sono stati rimappati, potrebbero verificarsi input errati.

Note

• ① Solo il Joy-Con destro supporta il turbo. Per ragioni sconosciute, se entrambi i Joy-Con supportano il turbo, può capitare che lo stick analogico non si riposizioni automaticamente dopo aver smesso completamente di premere i tasti, richiedendo un tocco manuale per tornare alla normalità.
• ② Esiste una bassa probabilità che, dopo aver smesso completamente di premere i tasti, lo stick analogico non si riposizioni automaticamente, richiedendo un intervento manuale per ripristinarlo.
• ③ Teoricamente dovrebbe comportarsi come il controller Octopus, ma non possiedo un Pro Controller, quindi si tratta solo di una valutazione teorica.
• ④ Dopo la fine di una macro, esiste la possibilità che lo stick analogico non si riposizioni automaticamente, richiedendo un tocco manuale per tornare allo stato corretto.

KeyX Button Assistant

Assistente per i pulsanti del Nintendo Switch che supporta funzioni turbo, rimappatura dei tasti e registrazione delle macro. Offre configurazioni globali o specifiche per ogni gioco, con sistema di memoria ad avvio automatico. Il plugin completo è composto da un overlay Tesla e da un modulo di sistema.

Caratteristiche

• Design dell’interfaccia moderno e curato.
• Modifica dinamica delle impostazioni di turbo e rimappatura.
• Registrazione delle macro direttamente tramite l’overlay Tesla con guida completa.
• Popup di notifica opzionali.
• Icone blu nella home indicano i pulsanti rimappati.
• Badge gialli indicano i pulsanti con turbo attivo.
• Badge rossi indicano i pulsanti associati a macro.

Rimappatura dei pulsanti

• Rimappatura dei 16 pulsanti (A/B/X/Y/L/R/ZL/ZR/D-pad/SELECT/START/L3/R3).
• Compatibile con la funzione turbo senza conflitti.
• Elusione perfetta dei popup di avviso di Nintendo.
• Configurazione globale o per singolo gioco.
• Memorizza automaticamente lo stato attivo/disattivo.

Turbo

• Turbo per 12 pulsanti (A/B/X/Y/L/R/ZL/ZR/D-pad).
• Supporto al turbo simultaneo su più pulsanti.
• I pulsanti senza turbo continuano a funzionare normalmente.
• Durata di pressione e rilascio completamente personalizzabile.
• Configurazione globale o per singolo gioco.
• Memorizza automaticamente lo stato attivo/disattivo.

Macro

• Memorizza automaticamente lo stato attivo/disattivo della funzione macro.
• Registra sia gli stick sia i pulsanti.
• Durata massima registrazione: 30 secondi.
• Frame rate di registrazione: 60 FPS.
• Pressione singola del tasto scorciatoia: esecuzione una volta.
• Pressione prolungata del tasto scorciatoia: riproduzione in loop.
• Pressione del tasto scorciatoia durante la riproduzione: annulla.

Uso della memoria

• Sysmodule: Solo 343 KB
• Popup di notifica: 688 KB aggiuntivi
  • I popup utilizzano memoria solo quando vengono mostrati.

Installazione

Copiare i file nella root della scheda SD:

1. /atmosphere/contents/4100000002025924/
2. /atmosphere/contents/0100000000251020
3. /switch/.overlays/ovl-KeyX.ovl

Lingue supportate

• en.json (Inglese)
• zh-cn.json (Cinese semplificato, già integrato)
• zh-tw.json (Cinese tradizionale)
• ja.json (Giapponese)
• ko.json (Coreano)
• fr.json (Francese)
• de.json (Tedesco)
• it.json (Italiano)
• es.json (Spagnolo)
• pt.json (Portoghese)
• ru.json (Russo)
• nl.json (Olandese)

Changelog v1.5.3

Adattamento controller

• Risolto completamente il bug che poteva causare il blocco del joystick durante l’esecuzione delle macro con Joy-Con e Pro Controller.
• Aggiunto un interruttore sui Joy-Con per attivare o disattivare il rapid fire sul controller sinistro o destro.

Macro Store

• Aggiunta la funzione Macro Store, che consente di scaricare macro sulla console con un solo clic.
• Nello store è possibile visualizzare informazioni sulle macro, come autore e istruzioni d’uso.
• Accedendo allo store durante il gioco verranno mostrate direttamente le macro relative a quel titolo.
• Accedendo allo store senza alcun gioco avviato verranno mostrate tutte le macro dei giochi installati.
• Essendo uno store basato sulla community, il numero di macro è attualmente limitato.
• I server sono stati configurati in Cina e, a causa di restrizioni di rete, solo gli utenti locali possono caricare macro direttamente.
• La funzione di upload sarà disponibile nella prossima versione.
• Gli utenti di altre regioni possono inviare una pull request al repository delle macro o inviarle direttamente allo sviluppatore.
• In futuro, le macro presenti sul server cinese verranno regolarmente sincronizzate con il repository GitHub.

Interfaccia dettagli macro

• Aggiunto un file di metadati per le macro: quelle scaricate dallo store mostreranno automaticamente i nomi in cinese semplificato, tradizionale e inglese.
• Le macro scaricate dallo store possono ora visualizzare le istruzioni d’uso nella schermata dei dettagli.
• Nell’interfaccia di impostazione delle scorciatoie sono stati aggiunti testi informativi per riproduzione singola, ciclica e interruzione.
• Risolto un problema nella rinomina dei file macro, che non gestiva correttamente i duplicati.

Editor di macro

• Ora, al salvataggio, il contenuto originale viene automaticamente salvato come backup per consentire il ripristino in caso di errore.
• Riscritto il codice di elaborazione dei dati dell’editor, migliorando l’accuratezza nella gestione dei file macro.
• Aggiunte nuove funzioni di modifica: copia avanti/indietro, spostamento avanti/indietro, modifica e rimozione del joystick.
• Nota: la modifica del joystick converte i dati completi delle coordinate in joystick virtuale direzionale, riducendo sensibilmente la precisione.
• Le funzioni di reset azioni e modifica dei tempi ora supportano operazioni batch.
• Il pulsante di salvataggio della funzione di modifica dei tempi è stato cambiato da A a +.
• L’elenco delle azioni non viene più unito automaticamente dopo le modifiche dell’utente.
• Durante il salvataggio delle macro non viene più aggiunta automaticamente un’azione vuota alla fine.
• Risolto un problema di disegno della lunghezza totale della timeline quando cambia la durata complessiva della macro.
• Risolto un problema per cui il pulsante Annulla non veniva evidenziato automaticamente nelle lingue diverse dal cinese.

Registrazione macro

• Al termine della registrazione, i frame di inattività finali vengono ora rimossi automaticamente dai dati della macro.

Elenco macro

• Quando il numero di macro nella directory di un gioco è pari a zero, il gioco non viene più mostrato nell’elenco.
• Aggiunto un testo che indica il numero di macro possedute accanto al nome del gioco.

Riproduzione macro

• Durante la riproduzione di una macro che contiene dati del joystick, gli input dell’utente non vengono più applicati al joystick.
• Questa modifica risolve il problema del possibile blocco del joystick durante l’esecuzione delle macro.
• Le macro che includono dati del joystick non devono ricevere input aggiuntivi dall’utente.

Altro

• Aggiunto il supporto alla lingua tedesca, grazie a @HeikesFootSlave per la traduzione.
• All’apertura del plugin OVL viene ora rilevata automaticamente la presenza di una nuova versione, evidenziando il pulsante di aggiornamento.
• Aggiornata la libreria libultrahand all’ultima versione.
• Risolto un problema di perdita di risorse di curl.
• Risolto un problema per cui, con rete instabile, l’uscita dall’interfaccia di aggiornamento causava un blocco temporaneo.

Changelog v1.5.4

• Risolto il problema per cui le macro scaricate nella versione 1.5.3 non erano visibili nell’elenco delle macro.
• Dopo l’aggiornamento, le macro precedentemente invisibili potrebbero non mostrare i nomi localizzati; è possibile eliminarle e riscaricarle per risolvere il problema.

Changelog v1.5.5

• Aggiunta la funzione di upload, ora disponibile a livello globale; il pulsante di caricamento si trova in basso a destra nella pagina dei dettagli della macro.
• Tutti sono invitati a inviare le proprie macro; il repository del server verrà sincronizzato con il repository GitHub.
• Aggiunta la possibilità di modificare le informazioni descrittive delle macro nello store.
• Ottimizzato l’utilizzo della memoria dell’OVL.
• Aggiornata l’interfaccia del changelog con supporto allo scorrimento.
• Per gli utenti in cinese tradizionale, la visualizzazione del changelog è stata cambiata dall’inglese al cinese semplificato.
• Risolto il problema per cui le istruzioni d’uso non venivano visualizzate completamente nella pagina dei dettagli della macro.
• Risolto un potenziale crash durante la registrazione causato da problemi di threading.
• Ringraziamenti a @do-kiss (忘忧) per aver fornito il server e la pagina web.

Dalla versione 1.4.2 in poi, è possibile aggiornare direttamente premendo il tasto + nell’interfaccia delle impostazioni.

Nota: Dalla versione 1.4.2 in poi, è possibile aggiornare direttamente premendo il tasto + nell’interfaccia delle impostazioni. Le versioni CN ed EN differiscono solo nel titolo dell’overlay Tesla; tutto il resto è identico.

Download: KeyX v1.5.5 (CN)

Download: KeyX v1.5.5 (EN)

Download: Source code KeyX v1.5.5