NX2navi · Windows · Vulkan
Controles
O NX2navi junta teclado, mouse e todo pad conectado num único controle estilo Switch. Remapeie no F1. Esta página parafraseia docs/controls.md; o repositório ganha se discordarem.
O Setup e as atualizações saem do GitHub Releases do tangerineturtle1/NX2navi. A tag mais recente é lida na hora do pedido.
Como o input é misturado
Gamepads SDL3, o teclado e o mouse viram um único controle. Todo pad conectado fica aberto; o jogo lê o que você apertou por último. Um pad ligado durante o jogo é achado em cerca de um segundo. Botões são ORados. Cada stick pega a fonte com maior deflexão. Teclas e botões do mouse só contam enquanto a janela do jogo está em primeiro plano. NX2NAVI_INPUT=none desliga esse caminho para runs automatizados. Variáveis de ambiente sobrescrevem o nx2navi.ini. Os binds só importam depois que o lançador terminou uma compilação local.
Teclas da janela que o jogo não come
Algumas teclas pertencem ao port, não à tabela de ação no mundo. Não dá para remapear para golpe de espada. Esc também solta o cursor do mouse para você mover ou fechar a janela. F11 grava fullscreen sem borda no ini. A combinação Minus+Plus nunca chega no jogo.
| Tecla | Combo no pad | Ação |
|---|---|---|
| F1 ou Esc | Minus + Plus | Abrir ou fechar o menu de configurações |
| F10 | L3 + R3 | Overlay de desempenho: off, fps, painel completo |
| F11 | — | Fullscreen sem borda liga ou desliga |
No menu: setas / D-pad / stick esquerdo movem, Enter ou A seleciona, Esc ou B volta.
Ações padrão no mundo (layout Nintendo)
A tela Basic Controls no jogo ainda usa nomes de botão de Switch. A tabela abaixo é o mapa padrão quando pad_layout é nintendo: leste é A. Layout Xbox põe A no sul. Os prompts no jogo ficam letras de Switch a menos que você mude a arte de prompt no ini. Trocar Jump Controls nas opções originais troca B e X para pulo versus guardar; os binds ficam nos botões de Switch, então Espaço passaria a guardar. Esta tabela é um mapa curto, não um substituto do menu Plus.
| Switch | Teclado / mouse | No mundo |
|---|---|---|
| Stick esquerdo | W A S D | Mover |
| Stick direito | Mouse; setas como segunda fonte | Câmera |
| A (leste) | E, Shift esquerdo | Falar, abrir, escalar; segurar para dash |
| B (sul) | Ctrl esquerdo, Backspace | Guardar, cancelar |
| X (norte) | Espaço | Pular |
| Y (oeste) | Botão esquerdo do mouse | Espada |
| ZL / ZR | Botão direito / Z; F / X | Mirar; usar item selecionado |
| L / R | Q / R | Seleção rápida; páginas de menu |
| Plus / Minus | Tab / M | Menus / mapa |
| D-pad | 1–4 | Ocarina, acessório, Navi, botas |
Layouts, remaps e câmera no mouse
pad_layout pode ser nintendo, xbox ou auto. Auto usa nintendo quando o SDL diz que o botão de face leste está rotulado A. Remaps ficam na aba Controls: duas células de tecla e uma de pad por botão de Switch. F1, F8, F10, F11 e Esc não podem ser bound. A aba escreve linhas bind_ no ini; uma linha inválida é logada e pulada. Movimento do mouse vira deflexão de stick direito com NX2NAVI_MOUSE_SENS (0 a 10). Isto não é mouselook: a curva de stick do jogo ainda vale. Sensibilidade 0 desliga a câmera no mouse. Dead zones de stick são porcentagem da deflexão cheia, redondas, com overrides por stick para um pad que deriva. O NX2navi não conserta uma porta USB quebrada. Se o Windows nunca vê um Switch 2 Pro Controller como gamepad SDL, você precisa de uma ponte que crie um pad virtual; este site não vende isso.
nintendo
Padrão. Botões de face por posição, como no Switch. Leste é A.
xbox
Sul A, leste B, oeste X, norte Y, casando rótulos Xbox (cruz/círculo no PlayStation).
auto
Layout Nintendo para pads que o SDL reporta como rotulados Nintendo; xbox para o resto.
Mouse
Movimento cru para o stick direito. Clique na área cliente para recapturar depois do Esc.
O que pulamos de propósito
Input scriptado, um pad virtual de teste e flags de RenderDoc existem para quem escreve Issues e patches. Estão em controls.md. Esta página não ensina a gravar TAS, fingir stick derivando nem capturar frames sob uma ferramenta que esconde uma extensão Vulkan exigida. Se precisar de repro para o GitHub, NX2NAVI_INPUT_RECORD pode escrever um script do input misturado. Força de rumble, curva de rumble e rumble de gatilho Xbox são chaves de ini, não downloads extras. Giro precisa de um pad (ou uma ponte) que de fato reporte movimento. Os padrões de D-pad ainda casam a fileira de item no mundo: ocarina, acessório, chamado da Navi, botas. Esses quatro ficam nas teclas 1–4 na tabela acima. Modificador de andar, captura do mouse depois do Esc e estado de tecla só em primeiro plano são o resto das regras de janela no mesmo documento.
Perguntas frequentes
- Onde eu remapio as teclas do NX2navi?
- F1 → aba Controls, ou linhas bind_ no nx2navi.ini. Veja controls.md para os nomes.
- Por que meu Switch 2 Pro Controller não aparece?
- O Windows muitas vezes não expõe para o SDL. O projeto descreve usar uma ponte que apresenta um pad virtual. Este site não empacota esse software.
- Posso bindar F1 na espada?
- Não. F1, F10, F11, F8 e Esc ficam com a janela e o overlay.