﻿Ultimate Shift Controller
Guida utente
Version 3.0.9

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ 1. Tipo di distribuzione e requisiti
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Freeware senza costi. Richiede Windows 10/11 a 64 bit, .NET 8 Desktop Runtime (x64), tastiera e mouse. Il comportamento può cambiare in base a dispositivo, applicazione o gioco. Il controller virtuale può richiedere driver aggiuntivi.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ 2. Installazione
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Non esiste un installer. Estrai lo ZIP in una cartella scrivibile, avvia UltimateShiftController.exe, configura le assegnazioni e premi [Salva]. Non avviare direttamente dallo ZIP.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ 3. Disinstallazione
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Disattiva l'avvio automatico, chiudi USC anche dall'area di notifica e cancella la cartella. Per rimuovere impostazioni e profili cancella anche [Settings]. I driver installati separatamente vanno rimossi separatamente.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ 4. Informazioni su USC
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Ultimate Shift Controller combina tastiera e mouse per rimappare tasti, eseguire scorciatoie dai pulsanti del mouse e cambiare assegnazioni mentre si tiene premuto un attivatore di livello. È utile in giochi, scrittura, editing, streaming e altre applicazioni. Le funzioni base non richiedono un controller virtuale.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ 5. Funzioni principali
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Rimappatura tastiera/mouse, scorciatoie con modificatori, uscite multiple, F1-F24, livelli NORMAL/HYPER/ULTRA/ULTIMATE, Turbo, schede, profili, import/export, HUD, area di notifica, clic sinistro/destro come ingresso nei livelli superiori e traduzione locale tramite Chrome.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ 6. Configurazione base
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Avvia l'app, scegli il livello, registra l'ingresso nel campo superiore e l'uscita in quello inferiore, premi [Salva] e prova. Esempio: Q -> CTRL+1.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ 7. I quattro livelli
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

NORMAL è il livello predefinito. HYPER e ULTRA si usano mentre i rispettivi attivatori sono premuti. ULTIMATE si usa quando entrambi sono premuti. I pulsanti in alto scelgono il livello da modificare; gli attivatori decidono quello attivo.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ 8. HYPER / ULTRA / ULTIMATE e mouse esterni
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

I trigger logici HYPER e ULTRA sono limitati a F13-F24 e devono essere diversi.

Esempio: HYPER=F13, ULTRA=F14. Il pulsante fisico deve inviare lo stesso tasto F configurato in USC.

Un’uscita USC F13-F24 senza Turbo può fungere anche da trigger interno. Il clic sinistro e destro possono essere registrati come ingressi in HYPER/ULTRA/ULTIMATE; restano bloccati nell’ingresso NORMAL e in tutti i campi di uscita. Un ingresso senza Turbo mantiene l’uscita fino al rilascio.

[Razer Synapse 2]
Synapse 2 salva F13-F24 ma non mostra il nome del tasto. Per F13: in NORMAL rimappa temporaneamente F1 per inviare F13; apri la registrazione del pulsante in Synapse 2; premi F1; salva anche senza nome visibile; poi ripristina F1 in USC e imposta HYPER su F13.

[Razer Synapse 3]
Se F13-F24 sono selezionabili direttamente, assegna F13/F14 al pulsante e usa lo stesso tasto in USC.

[Logicool/Logitech G-Shift e G HUB]
G HUB consente di scegliere F1-F24. Assegna F13/F14 a un pulsante normale o G-Shift e usa lo stesso tasto in USC.

[Altri dispositivi]
Qualsiasi software capace di registrare F13-F24 può usare lo stesso metodo. Anche senza nome visualizzato, funziona se il tasto viene salvato e inviato. Preferisci F13-F24.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ 9. Schede, profili e salvataggio
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Le schede organizzano le assegnazioni. I profili salvano tutta la configurazione. Premi sempre [Salva]. I dati sono nella cartella [Settings].

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ 10. Turbo, HUD e stato
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Turbo ripete le uscite. US HUD mostra il livello. CLEAN prova a liberare stati bloccati. Keyboard Lock blocca temporaneamente la tastiera e si disattiva con il mouse.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ 11. Impostazioni importanti
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

[Kill degli ingressi mappati] impedisce l'azione simultanea dell'ingresso originale e dell'uscita. Il blocco degli ingressi non mappati impedisce il passaggio durante HYPER/ULTRA/ULTIMATE. Sono disponibili anche opzioni tray e avvio Windows.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ 12. Controller virtuale
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Funzione avanzata che può richiedere driver, separazione tra controller fisico/virtuale e impostazioni del gioco. Una configurazione errata può causare doppio input. Guida illustrata:
https://github.com/Lu-ci-el/UltimateShiftController/blob/main/Instructions_en.md

Non serve per tastiera, mouse, livelli e scorciatoie.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ 13. Risoluzione dei problemi
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Salva le modifiche, controlla gli attivatori, verifica Kill in caso di doppio input, sblocca Keyboard Lock col mouse, usa CLEAN per stati bloccati ed evita Program Files se non riesci a salvare.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ 14. Contatti e segnalazioni
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

https://github.com/Lu-ci-el/UltimateShiftController/issues

Indica problema, passaggi, frequenza, ambiente e log. Non sono garantiti risposta individuale, correzione immediata o supporto per ogni ambiente. Non si accettano richieste abusive o di sviluppo personalizzato.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ 15. Note
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Esegui il backup di [Settings], chiudi USC prima degli aggiornamenti, controlla conflitti e regole di giochi/servizi. Non usare il software per barare, disturbare o interferire. L'autore non è responsabile dei danni derivanti dall'uso.


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ USC_TRANSLATION_3_0_4 / Traduzione
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

- La traduzione richiede Google Chrome a 64 bit e modelli locali supportati. Microsoft Edge non viene usato come fallback.
- Attivare «Usa traduzione» e aprire le impostazioni. Il tasto di traduzione è un tasto logico F13-F24 e non può coincidere con il trigger HYPER o ULTRA.
- Fare clic sinistro su «Tasto di attivazione» per acquisirlo e clic destro per cancellarlo. Può essere una combinazione fisica di tastiera/mouse/controller o un’uscita di mappatura USC senza Turbo del livello attivo. Le parti fisiche e interne non vengono mai combinate.
- Il testo straniero selezionato viene tradotto nella lingua attualmente scelta in USC. Il testo nella propria lingua viene tradotto nell’ultima lingua di conversazione riuscita o nella destinazione predefinita.
- Il risultato appare nella finestra semplice. Per ottenere il testo selezionato, USC invia Ctrl+C una sola volta all'applicazione in primo piano come eventi scan-code separati, nell'ordine Left Ctrl DOWN → C DOWN → C UP → Left Ctrl UP, mantenendo brevemente Ctrl prima di premere C. Non invia mai C per primo e non riprova C dopo una copia fallita. Traduce solo un aggiornamento comprovato degli appunti; altrimenti la traduzione non parte e la finestra semplice segnala che non è stato possibile ottenere la selezione. Non vengono usati acquisizione dello schermo o OCR.
- Le 14 lingue integrate possono essere preparate in blocco. Altre lingue si preparano singolarmente con un tag BCP-47 se supportate da Chrome.
- Aprire le impostazioni, aggiornare o selezionare una riga non avvia download. Solo DL o il DL collettivo ha tale autorità.
- Un DL esplicito apre in Chrome normale una pagina locale temporanea protetta da token. Funziona anche con Chrome già aperto e inizia solo dopo un clic in Chrome. Non apre siti esterni e i modelli restano di proprietà di Chrome.
- La traduzione normale usa un helper invisibile a richiesta singola tramite input/output standard e non apre pagine, schede, finestre Chrome o listener localhost. Non scarica automaticamente modelli mancanti.
- USC salva solo impostazioni e piccole evidenze in [Settings\Translation]. Profili, TranslateKit, pacchetti, modelli, componenti, runtime e cache di Chrome non vengono copiati in USC.
- Markdown, URL, codice, citazioni, paragrafi e interruzioni di riga sono protetti fuori dal modello, suddivisi entro limiti finiti e ricomposti. Salvare definitivamente con [Salva] nella finestra principale.
