Testa il dispositivo fuori da Ryujinx
Verifica il controller nel sistema operativo o in un'altra app prima di cambiare profili.
Risoluzione controller
Il controller non funziona in Ryujinx Canary? Controlla l'input passo dopo passo
Usa questa guida se Ryujinx Canary non rileva il controller, mappa pulsanti errati, perde input su Steam Deck o fallisce dopo un aggiornamento.
$ channel: canary
$ platforms: windows linux macos
$ source: ryubing releases
$ status: verify before download
Independent guide. No keys, firmware, ROMs, DLC or game files are hosted here.
Intento
Correggere input
Primo test
Un controller, Giocatore 1
Steam Deck
Profilo Steam Input
Rischio Canary
Regressione da update
Ordine rapido per correggere i controlli
Configura solo Giocatore 1
Abilita Player 1, scegli dispositivo e tipo di controller, poi salva.
Mappa un profilo
Mappa pulsanti, stick e trigger per quel dispositivo e prova un gioco.
Separa Steam Input
Su Steam Deck o Steam, controlla se viene esposto un gamepad virtuale.
Confronta la build precedente
Se il problema nasce dopo l'aggiornamento, prova la build Canary che funzionava.
Controlla input
Usa questa guida se Ryujinx Canary non rileva il controller, mappa pulsanti errati, perde input su Steam Deck o fallisce dopo un aggiornamento.
Parti dal livello che fallisce
Dividi il problema in dispositivo fisico, sistema operativo, profilo input di Ryujinx, Steam Input e gioco specifico. Non cambiare grafica, firmware e controlli nella stessa prova. Un test pulito usa un controller, uno slot giocatore, un gioco e una modifica alla volta.
- Se il sistema non vede il controller, correggi cavo, Bluetooth, batteria, driver o permessi.
- Se il sistema lo vede ma Ryujinx no, riseleziona il dispositivo in Player 1.
- Se i pulsanti si mappano ma il gioco non risponde, controlla tipo, slot e Steam Input.
- Se fallisce dopo un update Canary, confronta la build precedente.
Abbina il sintomo prima di cambiare impostazioni
Sintomi diversi indicano livelli diversi. La tabella evita reinstallazioni inutili.
| Sintomo | Livello probabile | Azione successiva |
|---|---|---|
| Solo tastiera visibile | Rilevamento | Ricollega, prova cavo, riavvia Ryujinx e apri input. |
| Controller visibile ma inattivo | Profilo | Attiva Player 1, scegli dispositivo, tipo e salva. |
| Steam Deck fallisce in Game Mode | Steam Input | Controlla gamepad virtuale e layout. |
| Un gioco funziona, un altro no | Profilo gioco | Prova prima il profilo predefinito. |
| Rotto dopo update | Regressione o profilo | Prova la build precedente e salva il profilo. |
Controlli su Windows
Su Windows identifica se il controller appare come XInput, DirectInput o Bluetooth parziale. I controller Xbox sono spesso più semplici. PlayStation, Switch Pro e pad di terze parti possono richiedere cavo stabile, wrapper o Steam Input per mostrarsi come gamepad virtuale affidabile.
- Usa USB diretto se Bluetooth è instabile.
- Chiudi launcher che possono riservare il controller.
- Evita di mescolare app elevate e non elevate nella stessa catena input.
- Salva un profilo funzionante prima di provare una nuova Canary.
Linux e Steam Deck
Linux e Steam Deck aggiungono la variabile del percorso di avvio. Un controller può funzionare in modalità desktop e fallire dopo l'aggiunta a Steam. Prova prima AppImage o archivio in desktop mode, poi aggiungi a Steam e mantieni lo stesso percorso durante il test input.
- Conferma Desktop Mode prima di Game Mode.
- Usa un layout Steam semplice al primo test.
- Con Steam Input attivo, seleziona il gamepad virtuale visto da Ryujinx.
- Dopo i permessi AppImage, riapri dal collegamento finale.
Ricostruisci il profilo Player 1
I vecchi profili possono sopravvivere ad aggiornamenti, cambi dispositivo e launcher. Se Ryujinx Canary vede il controller ma il mapping è incoerente, ricostruisci Player 1: dispositivo, tipo, pulsanti, salva, chiudi impostazioni e prova un gioco.
- Usa lo stesso nome dispositivo in tutto il profilo.
- Mappa pulsanti, stick e trigger prima delle opzioni avanzate.
- Riapri impostazioni per confermare il salvataggio.
- Crea profili per gioco solo dopo un profilo base funzionante.
Quando un update Canary rompe l'input
Le build Canary cambiano rapidamente. Se i controlli falliscono subito dopo l'update, conserva la nuova build, avvia la precedente da una cartella separata e prova stesso controller, profilo e percorso di avvio.
| Controllo | Perché conta |
|---|---|
| La vecchia build funziona | Può essere una regressione Canary. |
| Entrambe falliscono | È più probabile pairing, Steam Input o profilo danneggiato. |
| Fallisce solo un collegamento | Il launcher può cambiare il dispositivo visibile a Ryujinx. |
Non mescolare controlli con keys o firmware
Keys e firmware influenzano l'avvio dei giochi, ma non fanno comparire un controller nella lista input. Se il gioco non parte, completa prima l'installazione. Se il gioco parte e fallisce solo l'input, resta in questo flusso. Questo sito non ospita keys, firmware, ROM, DLC o giochi.
Fonti e controlli
Riferimenti ufficiali di setup e troubleshooting.
FAQ controller Ryujinx Canary
Perché appare solo la tastiera?
Il controller probabilmente non è ancora visibile a Ryujinx. Ricollega, prova cavo, conferma nel sistema e selezionalo in Player 1.
Perché appare ma non funziona nel gioco?
Il profilo attivo potrebbe non essere mappato o salvato. Ricostruisci Player 1 e salva.
Cosa controllare prima su Steam Deck?
Desktop Mode, Game Mode e Steam Input separatamente, perché Steam può esporre un gamepad virtuale.
Un update Canary può rompere l'input?
Sì. Confronta con la build precedente prima di cancellare profili.
Devo reinstallare Ryujinx Canary?
Di solito no. Prima controlla rilevamento, profilo, mapping e Steam Input.
Keys o firmware influenzano il rilevamento?
No. Influenzano il boot dei giochi, non la lista dei dispositivi input.