입력 설정을 열고 Player 1 선택
첫 번째 프로필부터 시작하고 운영체제에서 보이는 키보드가 선택되었는지 확인하세요. 기본 테스트 전에는 여러 플레이어를 설정하지 않습니다.
키보드 매핑 및 입력 문제 해결 가이드
Ryujinx 키보드 조작은 모든 환경에 같은 기본 키 목록이 있는 방식이 아니라 입력 프로필에 저장됩니다. 입력 설정을 열고 Player 1을 구성한 뒤 필요한 조작만 매핑하고 프로필을 저장하세요. 그 다음 한 게임에서 테스트해야 다른 변수와 섞이지 않습니다. 이 가이드는 마우스 입력의 한계와 키보드가 작동하지 않을 때 확인할 입력 계층도 설명합니다.
$ 채널: Canary
$ 플랫폼: Windows Linux macOS
$ 출처: Ryubing 릴리스
$ 상태: 다운로드 전에 확인
독립 가이드입니다. 키, 펌웨어, ROM, DLC 또는 게임 파일을 호스팅하지 않습니다.
첫 번째 프로필부터 시작하고 운영체제에서 보이는 키보드가 선택되었는지 확인하세요. 기본 테스트 전에는 여러 플레이어를 설정하지 않습니다.
버튼, 방향, 스틱, 트리거를 먼저 지정하고 캡처나 플러스·마이너스 같은 선택 기능은 나중에 추가하세요.
설정 창을 닫고 다시 열었을 때 매핑이 남아 있어야 저장된 프로필이라고 판단할 수 있습니다.
합법적으로 준비한 로컬 게임에서 짧게 테스트하고 한 번에 키나 옵션 하나만 변경하세요.
운영체제가 키보드를 인식하지 않거나 실제 문제가 게임패드라면 플랫폼 또는 컨트롤러 가이드를 사용하세요.
편집용 일러스트이며 실제 에뮬레이터 화면이 아닙니다. 물리 키, 선택한 입력 장치, Player 1 매핑, 게임 동작 순서로 확인하세요.
정확한 메뉴 이름은 Ryujinx 포크와 Canary 리비전에 따라 달라질 수 있지만 확인 순서는 비슷합니다. 입력 또는 컨트롤러 설정을 열고 Player 1을 선택한 뒤 운영체제에 표시되는 키보드를 입력 장치로 지정하세요. 처음부터 여러 플레이어나 고급 프로필을 동시에 편집하지 말고 작은 기본 프로필을 만듭니다. 프로필을 저장한 후 설정 창을 닫았다가 다시 열어 매핑이 실제로 남아 있는지 확인하세요. 게임별 재정의와 여러 런처 변수를 한꺼번에 조사하면 원인이 흐려집니다. 먼저 깨끗한 기준 프로필을 만들면 이후 문제를 더 쉽게 비교할 수 있습니다.
키보드는 게임에 필요한 것보다 많은 개별 키를 제공하지만 목록을 모두 채운다고 좋은 배치가 되는 것은 아닙니다. 먼저 이동, 확인, 취소, 상호작용에 필요한 입력을 설정하고 시스템 동작과 선택 입력은 나중에 추가하세요. Enter 키가 항상 확인 버튼이라고 단정하지도 마세요. 프로필과 게임, 빌드에 따라 표시되는 동작 이름이 다를 수 있고 Enter가 이미 다른 동작에 지정되어 있을 수 있습니다. 아래 표는 고정 키 목록이 아니라 테스트 순서입니다. 실제 프로필을 기준으로 Ryujinx 키 매핑을 확인하면 근거 없는 기본값을 복사하는 일을 줄일 수 있습니다.
| 그룹 | 먼저 매핑하는 이유 | 테스트 방법 |
|---|---|---|
| 주요 버튼 | 메뉴 확인, 취소, 상호작용에 사용 | 메뉴를 열고 선택을 확인한 뒤 취소 |
| 방향 입력 | 목록과 메뉴 포커스 이동에 필요 | 마우스 없이 설정 목록 이동 |
| 스틱 축 | 이동과 카메라는 서로 다른 방향 입력이 필요 | 같은 장면에서 이동 또는 카메라 반복 |
| 트리거와 상단 버튼 | 조준, 선택, 보조 동작에 자주 사용 | 각 키를 누른 채 하나의 반응 확인 |
| 플러스, 마이너스, 캡처, 홈 | 유용하지만 첫 실행에 필수는 아닌 경우가 많음 | 기본 프로필을 저장한 뒤 추가 |
키보드는 게임패드가 없거나 디지털 키를 선호하거나 데스크톱에서 입력 수신 여부를 빠르게 테스트할 때 유용합니다. 반면 아날로그 이동, 압력 감지 트리거, 터치, 모션을 사용하는 게임에는 자연스럽지 않을 수 있습니다. 컨트롤러로는 잘 작동하지만 키보드가 불편하다면 Ryujinx 고장이라기보다 게임 설계와 입력 방식의 차이일 수 있습니다. 키를 매핑하려는 검색 의도라면 이 페이지를 사용하고, 게임패드가 감지되지 않는다면 컨트롤러 문제 해결 가이드로 이동하세요. 서로 다른 입력 문제를 섞지 않는 것이 중요합니다.
| 용도 | 키보드가 좋은 첫 테스트 | 컨트롤러가 더 적합한 경우 |
|---|---|---|
| 메뉴와 턴제 동작 | 디지털 키가 명확하고 반복하기 쉬움 | 편하지만 필수는 아님 |
| 아날로그 이동 또는 카메라 | 축 매핑은 가능하지만 자연스럽지 않음 | 스틱 범위를 직접 사용 |
| 레이싱 또는 트리거 압력 | 게임이 디지털 입력을 허용할 때만 | 트리거와 스틱이 더 적합 |
| 입력 문제 진단 | 키보드 이벤트 수신 여부를 분리해 확인 | 컨트롤러 경로를 따로 테스트 |
Ryujinx 키보드가 작동하지 않으면 먼저 전체 게임에서 실패하는지, 특정 프로필만 실패하는지, 한 게임에만 해당하는지 나누세요. 다른 앱의 텍스트 입력에서 키를 눌러 물리 키보드와 운영체제가 이벤트를 받는지 확인합니다. Ryujinx에서는 Player 1, 선택된 장치, 활성 프로필, 저장된 매핑 순서로 확인하세요. 메뉴는 반응하지만 게임 동작만 안 되면 다른 액션을 확인하고 있거나 키가 중복되었거나 게임별 프로필이 덮어쓰고 있을 수 있습니다. 업데이트 직후 전체 키가 멈췄다면 사용자 데이터를 삭제하기 전에 깨끗한 프로필과 이전 Canary 빌드를 비교하세요.
Ryujinx에서 마우스를 사용하는 방법을 찾는 검색에는 에뮬레이터 창을 조작하는 경우와 게임이 기대하는 포인터, 터치, 모션을 흉내 내는 경우가 섞여 있습니다. 마우스 클릭이 자동으로 콘솔 버튼이 되는 것은 아니며 우클릭이 Ryujinx의 공통 조작이라는 보장도 없습니다. 설치한 빌드와 게임 프로필에 표시되는 동작만 설정한 뒤 실제 게임에서 테스트하세요. 아날로그 스틱, 터치, 자이로 중심의 게임에서는 마우스와 키보드가 부분적인 대안에 그칠 수 있습니다. 다른 빌드에서 본 키 목록을 확인 없이 복사하지 마세요.
매핑 개념은 플랫폼마다 같지만 입력 이벤트가 지나가는 경로는 달라질 수 있습니다. Windows에서는 키보드 배열, 창 포커스, 오버레이를 확인하세요. Linux에서는 데스크톱 세션과 권한 때문에 에뮬레이터 창이 키 이벤트를 받지 못할 수 있습니다. macOS에서는 포커스된 앱과 입력 관련 개인정보 또는 손쉬운 사용 권한을 살펴보세요. Steam Deck에서는 데스크톱 모드, 게임 모드, Steam Input을 서로 다른 변수로 보고 실제 게임을 실행할 경로와 같은 방식으로 테스트해야 합니다. 데스크톱 모드에서 만든 프로필과 게임 모드 실행을 같은 입력 환경이라고 가정하지 마세요.
Canary 빌드는 빠르게 변하므로 어제 작동하던 프로필이 업데이트 후 비교를 필요로 할 수 있습니다. 먼저 프로필이나 관련 사용자 데이터를 백업하세요. 빌드, 운영체제, 키보드 배열, 실행 경로를 기록하고 새 빌드와 별도 폴더에 보관한 이전 빌드에서 같은 메뉴나 장면의 같은 키를 테스트합니다. 이전 빌드만 작동한다면 버전별 동작 변경을 보여 주는 증거가 됩니다. 확인되지 않은 대체 파일을 다운로드하거나 모든 설정 파일을 삭제할 이유는 아닙니다. 더 넓은 비교가 필요하면 업데이트 및 롤백 가이드를 사용하세요.
| 결과 | 다음 단계 |
|---|---|
| 새 빌드와 이전 빌드 모두 실패 | 포커스, OS 이벤트, 프로필, 게임별 동작을 다시 확인 |
| 새 빌드만 실패 | 증거를 보존하고 재현 가능한 회귀로 정리 |
| 하나의 바로 가기만 실패 | 런처, Steam Input, 오버레이, 작업 폴더를 확인 |
| 메뉴는 되지만 한 동작만 실패 | 게임의 입력 기대값과 게임별 프로필 재정의를 확인 |
키보드 조작은 입력 프로필 문제이며 keys, firmware, ROM, DLC, 게임 다운로드를 찾을 이유가 아닙니다. 에뮬레이터가 열리고 합법적으로 준비한 로컬 게임이 실행되지만 특정 키만 반응하지 않는다면 입력 설정 흐름에 집중하세요. 게임이 시작되지 않는다면 설치, keys와 firmware, 호환성 가이드로 이동합니다. 이 사이트는 저작권 게임 파일이나 설정 파일을 호스팅하지 않으며 키보드가 모든 컨트롤러, 터치, 모션 입력을 대체한다고 주장하지 않습니다. 문제의 경계를 지키면 세이브와 설정을 보호하면서 결과를 더 쉽게 해석할 수 있습니다.
공식 설정 맥락은 아래 출처에서 확인하세요. 메뉴 이름은 빌드에 따라 달라질 수 있습니다.
모든 빌드, 프로필, 게임에 안전하게 적용되는 하나의 목록은 없습니다. Player 1 입력 설정에서 저장된 키를 확인하거나 지정한 다음 짧은 장면에서 테스트하세요.
Enter가 항상 같은 의미라고 가정하지 마세요. 프로필에 표시된 동작을 매핑하고 게임이 기대하는 확인 동작인지 확인한 뒤 실제 메뉴에서 테스트하세요.
입력 설정을 열고 Player 1과 키보드를 선택한 뒤 버튼과 축을 지정하세요. 저장하고 설정을 다시 연 다음 게임 하나에서 테스트합니다.
키보드는 디지털 동작에 유용하고 마우스 동작은 빌드와 게임 프로필에 따라 달라집니다. 아날로그, 터치, 모션의 범용 대체 수단은 아닙니다.
물리 키와 시스템 포커스, Player 1, 프로필, 저장된 매핑, 오버레이, 게임별 재정의를 순서대로 확인하세요. 업데이트 후라면 이전 빌드와 비교합니다.
키보드는 메뉴, 디지털 동작, 진단에 좋은 기준입니다. 아날로그 이동, 트리거 압력, 터치, 모션에는 컨트롤러가 더 자연스러운 경우가 많습니다.