한국어
Mac의 Ryujinx에서 컨트롤러 설정하는 방법
이 앱은 완전히 무료입니다. 계정을 만들 필요가 없습니다. 구독도, 번거로운 다운로드도 없고, 잠긴 기능도 없습니다. Apple 실리콘에 최적화되어 있습니다.
Ryujinx에서 Options, Settings를 열고 Input을 클릭한 다음 Player 1을 고르고 Input Device 메뉴에서 컨트롤러를 고르세요. Controller Type을 Pro Controller로 하고, 버튼 필드마다 원하는 버튼이 표시되는지 확인한 다음 Save를 클릭합니다. Mac이 이미 게임 컨트롤러에 나열하는 PS5, PS4, Xbox, Switch Pro, 8BitDo 컨트롤러는 다른 것을 설치하지 않아도 보통 그 메뉴에 나타나며, 작동하지 않는 컨트롤러는 대부분 그 창 하나에서 고쳐집니다.
저는 컨트롤러를 키와 마우스에 매핑하는 무료 Mac 앱 InputConfig를 만듭니다. Ryujinx는 컨트롤러를 직접 읽으므로 패드에는 매퍼가 필요하지 않습니다. InputConfig는 정말 도움이 되는 곳에서만 꺼냅니다. Ryujinx가 키보드에 두는 단축키와, Ryujinx가 나열하지 못하는 패드입니다.
InputConfig 1.7 버전(2026년 10월 출시 예정)부터 앱이 한국어를 완전히 지원합니다.
단계
- 컨트롤러를 Mac에 연결하고 시스템 설정의 게임 컨트롤러에서 불이 들어오는지 확인하세요.
- Ryujinx에서 Options, Settings를 열고 Input을 클릭하세요.
- Player 1을 고른 다음 Input Device 메뉴에서 컨트롤러를 고르세요.
- Controller Type을 Pro Controller로 하고 버튼 필드를 확인한 다음 Save를 클릭하세요.
- 게임이 Controller Applet을 보여 주면 나열된 플레이어와 컨트롤러 종류를 맞춘 다음 게임을 다시 시작하세요.
어느 Ryujinx를 쓰고 있는지 확인하기
원래의 Ryujinx 프로젝트는 2024년 10월에 중단되었습니다. 이름은 커뮤니티 포크로 이어지고 있고, 2026년에 쓸 빌드는 그것입니다. 2026년 10월 22일에 그 사이트 ryujinx.app을 읽었는데, Nintendo Switch 1 에뮬레이터라고 부르고, 자체 Forgejo 서버에서 MIT 라이선스 오픈 소스이며, 약 4,300개 타이틀에서 테스트했다고 말합니다. 다운로드 페이지는 Apple 실리콘 Mac만 제대로 지원된다고 말합니다. 그날은 Forgejo 서버와 블로그가 열리지 않았으므로 버전 번호는 알려 드릴 수 없습니다.
- 2024년의 오래된 빌드. 그 뒤의 입력 수정은 포크에만 있으므로, 컨트롤러 문제를 파고들기 전에 업데이트하세요.
- Intel Mac. 다운로드 페이지는 잘 작동한다고 약속하지 않으며, 패드를 탓하기 전에 알아 둘 만합니다.
- 비슷하게 생긴 다운로드 사이트. 이름을 재사용하는 페이지가 많습니다. 프로젝트 자체 사이트에서 받으세요.
입력 설정을 하나라도 바꾸기 전에 포크의 최신 빌드를 그 자체 사이트에서 받으세요. 이 페이지는 컨트롤러만 다루며 게임 파일이나 키는 다루지 않습니다.
Ryujinx 입력 설정에서 Player 1 설정하기
- 사용자: 패드를 연결하고 Options, Settings, Input을 연 다음, 위쪽에서 Player 1을 고르고 Input Device에서 패드를 고릅니다. Controller Type을 Pro Controller로 합니다.
- Ryujinx: 그 패드의 버튼, 스틱, 트리거 필드를 채웁니다.
- 확인: A 같은 필드를 클릭하고 거기에 둘 버튼을 누르세요. 필드에 들은 것이 표시됩니다. Save를 클릭하세요.
같은 창에 사람들이 놓치는 설정이 있습니다.
- Refresh input devices. Ryujinx를 연 뒤에 연결한 패드를 나열하는 버튼입니다.
- 프로필. Add로 레이아웃에 이름을 붙이고 저장한 뒤 나중에 Load하면, 두 번째 패드나 재설치도 금방 끝납니다. Default 프로필은 덮어쓸 수 없습니다.
- Docked Mode. 켜면 Ryujinx가 독에 꽂힌 Switch처럼, 끄면 휴대 모드처럼 작동하며 게임은 그때 Handheld 플레이어를 기대합니다.
- Global Input. 게임 자체 설정에서 켜면 그 게임이 자체 레이아웃 대신 전역 레이아웃을 씁니다.
- Reset keybinds to default. 선택한 장치의 모든 필드를 되돌립니다.
- Motion과 Rumble. Motion에는 Use CemuHook Compatible Motion과 자이로 감도가 있습니다. Rumble에는 강한 진동과 약한 진동 배율, 그리고 Ryujinx가 실험 단계이며 Nintendo 정품 컨트롤러 전용이라고 표시하는 Enable HD Rumble이 있습니다.
작동하지 않는 컨트롤러의 대부분은 Input Device를 고치면 해결됩니다. 흔히 아직 Keyboard나 Disabled에 있기 때문입니다.
게임이 보여 주는 Controller Applet 읽기
일부 게임은 시작할 때 컨트롤러를 요구하고, Ryujinx는 Controller Applet이라는 제목의 창으로 응답합니다. 이 창은 Players와 Supported Controllers를 나열하고, 현재 구성이 올바르지 않으니 설정을 열어 입력을 다시 구성하라고 말하며 Open Settings Window 버튼이 있습니다. 게임이 원하는 구성을 내 설정이 주지 못한다는 뜻입니다.
- 컨트롤러 종류를 맞추세요. 목록에 Pro Controller가 없다면 플레이어 1의 Controller Type에서 JoyCon Pair처럼 목록에 있는 종류 중 하나를 고르세요.
- 플레이어 수를 맞추세요. 두 명을 원하는 게임에는 Player 2에도 장치를 설정해야 합니다.
- 독 모드와 휴대 모드를 맞추세요. 애플릿이 독 모드가 설정되어 있으니 휴대 컨트롤을 꺼야 한다고 말하면, Handheld는 Disabled로 두고 Player 1을 쓰세요.
System, Hacks에는 게임 도중 패드가 끊어졌을 때 창이 나타나지 않게 하는 Ignore Controller Applet이 있습니다. Ryujinx 자체 팁은 잘 모르겠으면 꺼 두라고 하며, 저도 그렇게 하겠습니다. 애플릿이 게임이 원하는 것을 정확히 알려 주므로, 다른 것을 바꾸기 전에 두 목록을 읽으세요.
컨트롤러가 그래도 아무 일도 하지 않을 때
가장 작은 단계부터 이 사다리를 오르세요.
- Mac을 확인하세요. 시스템 설정의 게임 컨트롤러에 패드가 나열되고 버튼마다 불이 들어와야 합니다. 그렇지 않다면 문제는 페어링이고, Mac에서 컨트롤러가 인식되지 않을 때가 거기서 시작합니다.
- 장치 목록을 새로 고치세요. Refresh input devices를 누르거나, 패드를 연결한 채로 Ryujinx를 종료하고 다시 여세요.
- 키보드가 아니라 패드를 고르세요. 플레이어 1의 Input Device에 내 컨트롤러 이름이 있어야 합니다.
- 저장한 다음 게임을 다시 시작하세요. Controller Applet을 보여 준 게임은 시작할 때 컨트롤러를 다시 요청합니다.
- 포커스 손실을 확인하세요. 인터페이스 설정의 On Emulator Focus Loss는 다른 창이 앞에 있을 때 입력을 막을 수 있습니다. 게임 창을 클릭하세요.
- Steam을 종료하세요. Steam Input이 패드를 자체 키로 바꾸어 입력이 두 번 도착하거나 엉뚱한 곳으로 갈 수 있습니다.
- 바뀌었거나 작동하지 않는 버튼. Input의 필드를 클릭하고 원하는 버튼을 누르세요. 필드는 버튼에 무엇이 인쇄되어 있든 패드가 보내는 것을 받습니다.
게임 컨트롤러와 Input 창에서는 작동하는데 게임에서는 안 되는 패드는 거의 항상 Controller Applet이나 플레이어 설정 문제입니다. 다른 에뮬레이터의 같은 점검은 Mac에서 에뮬레이터 컨트롤러가 안 될 때에서 다룹니다.
Mac에서 읽는 컨트롤러 알기
Ryujinx의 소스는 SDL3으로 컨트롤러를 읽으므로 Mac이 보는 패드를 봅니다. 아래 패드를 모두 Ryujinx에서 직접 테스트하지는 않았습니다. 중요한 것은 각각이 Mac에 어떻게 도착하는가입니다.
- PS5와 PS4 컨트롤러. 시스템 설정에서 Bluetooth로 페어링합니다. PS5 컨트롤러 연결하기를 보세요.
- Xbox Wireless 컨트롤러. Bluetooth로 페어링합니다. 유선 Xbox 360 패드는 macOS가 아예 지원하지 않습니다.
- Switch Pro Controller. Bluetooth로 페어링하며 Switch 게임이 기대하는 컨트롤러이므로, Ryujinx의 Pro Controller가 가장 잘 맞습니다.
- Joy-Con. macOS는 하나씩 따로 페어링합니다. Ryujinx에는 JoyCon Pair, JoyCon Left, JoyCon Right 종류가 있지만, Mac에서 페어링한 Joy-Con 두 개를 어떻게 한 쌍으로 묶는지는 확인하지 못했습니다.
- 8BitDo 패드. 8BitDo가 Apple 장치용으로 나열한 모드에서만 되며, 대부분의 모델에서 D입니다. 모델별 내용은 Mac의 8BitDo 컨트롤러에 있습니다.
Mac이 게임 컨트롤러에 패드를 나열한다면 Ryujinx의 Input Device 메뉴에서 골라 볼 만합니다.
남는 버튼에 Ryujinx 단축키 두기
Ryujinx는 Settings, Hotkeys에서 단축키를 키보드에 둡니다. 기본값으로 F1은 VSync를 토글하고, F2는 음소거하고, F4는 UI를 보이거나 숨기고, F5는 일시정지하고, F8은 스크린샷을 찍습니다. Turbo Mode, 볼륨, 해상도 배율은 바인딩되지 않은 채 시작하므로 거기서 먼저 키를 주세요. InputConfig는 Create나 Share 버튼, DualSense 터치패드 클릭, DualSense Edge 패들처럼 Ryujinx가 바인딩하지 않고 남겨 둔 버튼에서 그 키들을 누를 수 있습니다.
- 사용자: Ryujinx용 프리셋을 만들고, 행을 추가하고, Scan을 누른 다음 남는 버튼을 누릅니다. 출력을 Keyboard Key로 하고 F5를 고릅니다.
- InputConfig: Ryujinx가 읽고 있는 패드와 함께, 그 버튼을 누를 때마다 F5를 보냅니다.
- 확인: 게임에서 버튼을 누르세요. 게임이 일시정지됩니다. 저는 InputConfig가 보낸 키로 Ryujinx를 직접 테스트하지 않았으므로 더 만들기 전에 키 하나부터 확인하세요.
Ryujinx를 Activate when these apps are in front 아래에 적으면 프리셋이 Ryujinx가 맨 앞에 있을 때만 켜집니다. Ryujinx가 쓰지 않는 버튼만 매핑하세요. 그렇지 않으면 한 번 누를 때 두 가지 일이 일어납니다.
Ryujinx가 나열하지 못하는 패드로 키보드 프로필 움직이기
일부 패드는 Input Device 메뉴에 나타나지 않습니다. 흔히 macOS가 게임 컨트롤러로 취급하지 않는 평범한 USB 패드입니다. InputConfig의 Live Visualizer에서 그 패드의 버튼에 불이 들어온다면, InputConfig가 그것을 키보드를 선택한 Player 1에 Ryujinx가 이미 쓰는 키보드 키로 바꿀 수 있습니다.
| Switch 컨트롤 | Ryujinx의 기본 키 | 줄 곳 |
|---|---|---|
| 왼쪽 스틱 | W, A, S, D, 클릭은 F | 패드의 왼쪽 스틱 |
| 십자키 | 화살표 키 | 십자키 |
| A, B, X, Y | Z, X, C, V | Switch 위치대로 오른쪽, 아래, 위, 왼쪽 페이스 버튼 |
| L, R, ZL, ZR | E, U, Q, O | 범퍼와 트리거 |
| 오른쪽 스틱 | I, J, K, L, 클릭은 H | 오른쪽 스틱 |
Minus와 Plus에도 기본값이 있습니다. Ryujinx의 Input 창이 그 키로 무엇을 보여 주는지 확인하고 그 키를 바인딩하세요. 그다음 빠른 방법으로 시험하세요. Input Device를 Keyboard로 하고 필드를 클릭한 다음 패드 버튼을 누릅니다. 필드에 키가 채워지면 Ryujinx가 InputConfig의 키를 받고 있는 것입니다. 키로 보낸 스틱은 끝까지 밀거나 전혀 밀지 않거나 둘 중 하나이므로, 이는 Ryujinx가 볼 수 없는 패드를 위한 대비책이지 볼 수 있는 패드의 대체품이 아닙니다.
할 수 없는 일
- 가상 컨트롤러 없음. InputConfig는 키와 마우스 이벤트를 보냅니다. 패드를 Ryujinx에 다른 게임패드처럼 보이게 할 수 없습니다.
- 키로는 아날로그 불가. 키보드 방식은 스틱과 트리거의 반쯤 기울이기를 잃습니다.
- 이를 통한 자이로나 진동 없음. 모션과 진동은 Ryujinx 자체 컨트롤러 지원을 통해서만 작동합니다.
저라면 Ryujinx가 패드를 읽게 하고, InputConfig는 그 둘레의 키에만 쓰겠습니다.
짧게 정리
- 설정. Options, Settings, Input으로 가서 Player 1을 고르고, Input Device에서 패드를 고르고, Pro Controller를 고른 다음 Save를 클릭하세요.
- 애플릿 읽기. Controller Applet이 나열하는 플레이어와 컨트롤러 종류를 맞추세요.
- 단축키 더하기. InputConfig 프리셋이 Ryujinx가 비워 둔 버튼에 F4, F5, F8을 줍니다.
Mac이 게임 컨트롤러에서 패드에 불을 켜 준다면, 해결책은 거의 항상 Ryujinx의 Input 창 안에 있습니다.
자주 묻는 질문
Mac의 Ryujinx에서 컨트롤러가 작동하지 않는 이유는 무엇인가요?
가장 흔한 것은 Player 1의 Input Device가 아직 Keyboard나 Disabled에 있거나, Ryujinx를 연 뒤에 패드를 연결한 경우입니다. Refresh input devices를 누르고, 패드를 고르고, Controller Type을 Pro Controller로 한 다음 Save를 클릭하세요.
Ryujinx의 Controller Applet이란 무엇인가요?
일부 게임이 컨트롤러를 요구하며 여는 창입니다. 게임이 지원하는 플레이어와 컨트롤러 종류를 나열합니다. Settings, Input에서 그것을 맞춘 다음 게임을 다시 시작하세요.
Mac의 Ryujinx에서 PS5 컨트롤러가 작동하나요?
Ryujinx는 SDL3으로 컨트롤러를 읽고, 시스템 설정의 Bluetooth로 페어링한 DualSense를 읽습니다. Player 1의 Input Device 메뉴에서 고르고 버튼 필드를 확인하세요.
Ryujinx의 기본 키보드 조작은 무엇인가요?
왼쪽 스틱은 W, A, S, D, 십자키는 화살표 키, A, B, X, Y는 Z, X, C, V, L, R, ZL, ZR은 E, U, Q, O입니다. 오른쪽 스틱은 I, J, K, L입니다.
Ryujinx는 2026년에도 개발되고 있나요?
원래의 프로젝트는 2024년에 중단되었습니다. 커뮤니티 포크가 ryujinx.app에서 이어지고 있으며, 2026년 10월 22일에 이 사이트는 MIT 라이선스 오픈 소스이고 Apple 실리콘 Mac에서만 제대로 지원된다고 스스로 설명했습니다.
한국어 페이지 더 보기
자세한 안내(영어)
글쓴이 소개. Ryleigh Newman은 InputConfig를 개발하고 있습니다. 손을 쓰기가 어려워서 매일 컨트롤러로 Mac을 조작합니다. 이 페이지는 영어에서 번역했습니다. Mac 언어가 한국어로 설정되어 있으면 앱의 주요 버튼과 메뉴가 한국어로 표시되며, 이 페이지는 그 이름에 영어 이름을 괄호로 함께 적었습니다. 앱의 나머지 부분과 사이트의 다른 페이지는 영어입니다.
이 페이지의 다른 언어: English, العربية, Čeština, Dansk, Deutsch, Español, Suomi, Français, עברית, Magyar, Bahasa Indonesia, Italiano, 日本語, Norsk, Nederlands, Polski, Português, Русский, Slovenčina, Svenska, ไทย, Türkçe, Українська, Tiếng Việt, 繁體中文, 简体中文
무료. macOS 14 이상. 계정이 필요 없고, 데이터는 Mac 밖으로 나가지 않습니다. 소스 코드는 GitHub에 있습니다.