Polski
Jak ustawić kontroler w Ryujinx na Macu
Ta aplikacja jest całkowicie darmowa. Nie trzeba zakładać konta. Nie ma subskrypcji ani skomplikowanych pobrań, a nic nie jest zablokowane. Zoptymalizowana pod Apple Silicon.
Otwórz Options, Settings w Ryujinx, kliknij Input, wybierz Player 1 i wskaż swój kontroler w menu Input Device. Ustaw Controller Type na Pro Controller, sprawdź, czy każde pole przycisku pokazuje przycisk, który chcesz, i kliknij Save. Kontroler PS5, PS4, Xbox, Switch Pro albo 8BitDo, który Mac już wymienia w Kontrolerach do gier, zwykle pojawia się w tym menu bez instalowania czegokolwiek, a większość martwych kontrolerów naprawia się w tym jednym oknie.
Tworzę InputConfig, darmową aplikację na Maca, która przypisuje kontrolery do klawiszy i myszy. Ryujinx sam czyta kontrolery, więc nie potrzebuje programu do przypisywania dla pada. InputConfig wspominam tylko tam, gdzie naprawdę pomaga: przy skrótach, które Ryujinx trzyma na klawiaturze, i przy padzie, którego Ryujinx nie potrafi wymienić.
Wersja 1.7 aplikacji InputConfig, spodziewana w październiku 2026 r., będzie w pełni dostępna po polsku.
Kroki
- Podłącz kontroler do Maca i sprawdź, czy zapala się w Ustawieniach systemowych, Kontrolery do gier.
- W Ryujinx otwórz Options, Settings i kliknij Input.
- Wybierz Player 1, potem wskaż swój kontroler w menu Input Device.
- Ustaw Controller Type na Pro Controller, sprawdź każde pole przycisku i kliknij Save.
- Jeśli gra pokazuje Controller Applet, dopasuj graczy i typy kontrolerów, które wymienia, potem uruchom grę ponownie.
Sprawdź, którego Ryujinx używasz
Oryginalny projekt Ryujinx zatrzymał się w październiku 2024. Nazwa żyje dalej w forku społeczności i to właśnie tej wersji należy używać w 2026. 22 października 2026 czytano jego stronę, ryujinx.app, która nazywa go emulatorem Nintendo Switch 1, mówi, że jest open source na licencji MIT na własnym serwerze Forgejo, i mówi, że przetestowano go na około 4300 tytułach. Jego strona pobierania mówi, że prawidłowo wspierane są tylko Maki z Apple Silicon. Jego serwer Forgejo i blog nie wczytały się tego dnia, więc nie można podać numeru wersji.
- Stara wersja z 2024. Poprawki wejścia od tamtej pory są tylko w forku, więc zaktualizuj, zanim zaczniesz szukać problemu z kontrolerem.
- Mac z Intelem. Strona pobierania nie obiecuje, że działa dobrze, i warto o tym wiedzieć, zanim obwinisz pada.
- Podobne strony pobierania. Wiele stron używa tej nazwy. Pobieraj ze strony samego projektu.
Zacznij od aktualnej wersji forka, z jego własnej strony, zanim zmienisz choćby jedno ustawienie wejścia. Ta strona obejmuje tylko kontrolery, nie pliki gier ani klucze.
Ustaw Player 1 w ustawieniach Input w Ryujinx
- Ty: Podłącz pada, otwórz Options, Settings, Input, wybierz Player 1 u góry i wskaż pada w Input Device. Ustaw Controller Type na Pro Controller.
- Ryujinx: Wypełnia pola przycisków, gałek i wyzwalaczy dla tego pada.
- Sprawdź: Kliknij pole, na przykład A, i naciśnij przycisk, który ma tam być. Pole pokazuje to, co usłyszało. Kliknij Save.
To samo okno ma ustawienia, które ludzie pomijają:
- Refresh input devices. Ten przycisk wymienia pada podłączonego po otwarciu Ryujinx.
- Profile. Nazwij układ przyciskiem Add, zapisz go i wczytaj później Load, więc drugi pad albo ponowna instalacja zajmują chwilę. Profilu Default nie można nadpisać.
- Docked Mode. Włączony, Ryujinx zachowuje się jak Switch w stacji dokującej. Wyłączony zachowuje się jak przenośny, a gra oczekuje wtedy gracza Handheld.
- Global Input. W ustawieniach samej gry sprawia, że gra używa układu globalnego zamiast własnego.
- Reset keybinds to default. Przywraca każde pole dla wybranego urządzenia.
- Motion i Rumble. Motion ma Use CemuHook Compatible Motion i czułość żyroskopu. Rumble ma mnożniki mocne i słabe oraz Enable HD Rumble, które Ryujinx oznacza jako eksperymentalne i tylko dla pierwszoosobowych kontrolerów Nintendo.
Input Device to ustawienie, które naprawia większość martwych kontrolerów, bo często nadal jest na Keyboard albo Disabled.
Czytaj Controller Applet, gdy gra go pokazuje
Niektóre gry pytają o kontrolery przy starcie, a Ryujinx odpowiada oknem o tytule Controller Applet. Wymienia Players i Supported Controllers oraz mówi, że Twoja obecna konfiguracja jest nieprawidłowa i że należy otworzyć ustawienia i ponownie skonfigurować wejścia, z przyciskiem Open Settings Window. Oznacza to, że gra chce ustawienia, którego Twoje ustawienia jej nie dają.
- Dopasuj typ kontrolera. Jeśli lista nie zawiera Pro Controller, wybierz jeden z wymienionych typów, na przykład JoyCon Pair, w Controller Type dla Player 1.
- Dopasuj liczbę graczy. Gra, która chce dwóch graczy, potrzebuje też urządzenia ustawionego dla Player 2.
- Dopasuj tryb docked i handheld. Jeśli aplet mówi, że ustawiony jest tryb docked i sterowanie handheld powinno być wyłączone, zostaw Handheld na Disabled i użyj Player 1.
System, Hacks ma Ignore Controller Applet, które powstrzymuje okno przed pojawianiem się, gdy pad rozłącza się w trakcie gry. Własna wskazówka Ryujinx mówi, żeby zostawić to wyłączone, jeśli nie ma pewności, i proponuję tak zrobić. Aplet mówi dokładnie, czego chce gra, więc przeczytaj jego dwie listy, zanim zmienisz cokolwiek innego.
Jeśli kontroler nadal nic nie robi
Wejdź po tej drabinie, od najmniejszego kroku:
- Sprawdź Maca. Ustawienia systemowe, Kontrolery do gier powinny wymieniać pada i zapalać każdy przycisk. Jeśli nie, problemem jest parowanie, a zaczyna od niego strona kontroler nierozpoznany na Macu.
- Odśwież listę urządzeń. Naciśnij Refresh input devices albo zamknij i otwórz Ryujinx przy już podłączonym padzie.
- Wybierz pada, a nie klawiaturę. Input Device dla Player 1 musi nazywać Twój kontroler.
- Zapisz, potem uruchom grę ponownie. Gra, która pokazała Controller Applet, pyta o kontrolery ponownie przy starcie.
- Sprawdź utratę fokusu. On Emulator Focus Loss w ustawieniach Interface może blokować wejście, gdy na wierzchu jest inne okno. Kliknij okno gry.
- Zamknij Steam. Steam Input może zamienić pada na własne klawisze, więc naciśnięcia przychodzą dwa razy albo trafiają w złe miejsce.
- Zamienione albo martwe przyciski. Kliknij pole w Input i naciśnij przycisk, który chcesz. Pole przyjmuje to, co pad wysyła, cokolwiek jest na nim wydrukowane.
Pad, który działa w Kontrolerach do gier i w oknie Input, ale nie w grze, to niemal zawsze ustawienie Controller Applet albo gracza. Te same kontrole dla innych emulatorów opisuje Kontroler emulatora nie działa na Macu.
Wiedz, które kontrolery czyta na Macu
Źródła Ryujinx czytają kontrolery przez SDL3, więc widzi pady, które widzi Mac. Nie przetestowano osobiście każdego z poniższych padów w Ryujinx. Liczy się to, jak każdy z nich dociera do Maca:
- Kontrolery PS5 i PS4. Parują się przez Bluetooth w Ustawieniach systemowych. Zobacz podłączanie kontrolera PS5.
- Kontrolery Xbox Wireless. Parują się przez Bluetooth. Przewodowy pad Xbox 360 nie jest wspierany przez macOS w ogóle.
- Switch Pro Controller. Paruje się przez Bluetooth i jest kontrolerem, którego oczekują gry Switch, więc Pro Controller w Ryujinx pasuje do niego najlepiej.
- Joy-Cony. macOS paruje każdy osobno. Ryujinx ma typy JoyCon Pair, JoyCon Left i JoyCon Right, ale nie sprawdzono, jak łączy dwa Joy-Cony sparowane z Makiem w jedną parę.
- Pady 8BitDo. Tylko w trybie, który 8BitDo podaje dla urządzeń Apple, w większości modeli D. Każdy model opisuje strona kontrolery 8BitDo na Macu.
Jeśli Mac wymienia pada w Kontrolerach do gier, warto wybrać go w menu Input Device w Ryujinx.
Umieść skróty Ryujinx na zapasowych przyciskach
Ryujinx trzyma swoje skróty na klawiaturze, w Settings, Hotkeys. Domyślnie F1 przełącza VSync, F2 wycisza, F4 pokazuje lub ukrywa interfejs, F5 pauzuje, a F8 robi zrzut ekranu. Turbo Mode, głośność i skala rozdzielczości zaczynają nieprzypisane, więc najpierw daj im tam klawisz. InputConfig może naciskać te klawisze z przycisków, które Ryujinx zostawia nieprzypisane, takich jak przycisk Create albo Share, kliknięcie gładzika DualSense albo łopatka DualSense Edge.
- Ty: Zrób preset dla Ryujinx, dodaj wiersz, naciśnij Scan i naciśnij zapasowy przycisk. Ustaw wyjście na Keyboard Key i wybierz F5.
- InputConfig: Wysyła F5 za każdym razem, gdy naciskasz ten przycisk, obok pada, którego czyta Ryujinx.
- Sprawdź: W grze naciśnij przycisk. Gra się pauzuje. Nie przetestowano osobiście Ryujinx z klawiszami wysyłanymi przez InputConfig, więc sprawdź jeden klawisz, zanim zbudujesz więcej.
Wypisz Ryujinx w Activate when these apps are in front, a preset włączy się tylko wtedy, gdy Ryujinx jest na wierzchu. Przypisuj tylko przyciski, których Ryujinx nie używa, bo inaczej każde naciśnięcie robi dwie rzeczy naraz.
Steruj profilem klawiatury z pada, którego Ryujinx nie potrafi wymienić
Niektóre pady nigdy nie pokazują się w menu Input Device, często zwykłe pady USB, których macOS nie traktuje jak kontrolerów do gier. Jeśli Live Visualizer w InputConfig zapala przyciski pada, InputConfig może zamienić go w klawisze klawiatury, których Ryujinx już używa dla Player 1 z wybraną klawiaturą:
| Kontrolka Switch | Domyślny klawisz Ryujinx | Przypisz do |
|---|---|---|
| Lewa gałka | W, A, S, D i F do kliknięcia | Lewej gałki pada |
| Krzyżak | Strzałki | Krzyżaka |
| A, B, X, Y | Z, X, C, V | Prawego, dolnego, górnego i lewego przycisku, w pozycjach Switch |
| L, R, ZL, ZR | E, U, Q, O | Bumperów i wyzwalaczy |
| Prawa gałka | I, J, K, L i H do kliknięcia | Prawej gałki |
Minus i Plus też mają domyślne: sprawdź, jakie klawisze pokazuje dla nich okno Input w Ryujinx, i przypisz je. Potem przetestuj to szybko: z klawiaturą jako Input Device kliknij pole i naciśnij przycisk pada. Jeśli pole wypełnia się klawiszem, Ryujinx dostaje klawisze InputConfig. Gałka wysłana jako klawisze jest wychylona do końca albo wcale, więc to rozwiązanie awaryjne dla padów, których Ryujinx nie widzi, a nigdy zamiennik pada, który widzi.
Czego nie potrafi
- Brak wirtualnego kontrolera. InputConfig wysyła klawisze i zdarzenia myszy. Nie może sprawić, by pad wyglądał dla Ryujinx jak inny gamepad.
- Brak analogu przez klawisze. Droga przez klawiaturę traci połowiczne wychylenia gałek i wyzwalaczy.
- Brak żyroskopu ani wibracji przez nią. Ruch i wibracje działają tylko przez własną obsługę kontrolerów w Ryujinx.
Proponuję pozwolić Ryujinx czytać pada, a InputConfig zostawić dla klawiszy wokół niego.
Krótka wersja
- Ustaw. Przejdź do Options, Settings, Input, wybierz Player 1, wskaż pada w Input Device, wybierz Pro Controller i kliknij Save.
- Czytaj aplet. Dopasuj graczy i typy kontrolerów, które wymienia Controller Applet.
- Dodaj skróty. Preset InputConfig umieszcza F4, F5 i F8 na przyciskach, które Ryujinx zostawia wolne.
Jeśli Mac zapala pada w Kontrolerach do gier, naprawa jest prawie zawsze w oknie Input w Ryujinx.
Pytania
Dlaczego mój kontroler nie działa w Ryujinx na Macu?
Najczęściej Input Device dla Player 1 jest nadal na Keyboard albo Disabled, albo pad podłączono po otwarciu Ryujinx. Naciśnij Refresh input devices, wybierz pada, ustaw Controller Type na Pro Controller i kliknij Save.
Czym jest Controller Applet w Ryujinx?
Oknem, które niektóre gry otwierają, by poprosić o kontrolery. Wymienia graczy i typy kontrolerów, które gra wspiera. Dopasuj je w Settings, Input, potem uruchom grę ponownie.
Czy kontroler PS5 działa z Ryujinx na Macu?
Ryujinx czyta kontrolery przez SDL3, który czyta DualSense sparowany w Ustawieniach systemowych, Bluetooth. Wybierz go w menu Input Device dla Player 1 i sprawdź pola przycisków.
Jakie są domyślne sterowania klawiaturą w Ryujinx?
W, A, S i D dla lewej gałki, strzałki dla krzyżaka, Z, X, C i V dla A, B, X i Y oraz E, U, Q i O dla L, R, ZL i ZR. Prawa gałka to I, J, K i L.
Czy Ryujinx nadal jest rozwijany w 2026?
Oryginalny projekt zatrzymał się w 2024. Fork społeczności trwa na ryujinx.app, który 22 października 2026 opisywał się jako open source na licencji MIT i prawidłowo wspierany tylko na Makach z Apple Silicon.
Więcej po polsku
Pełne poradniki, po angielsku
Kto pisze. Ryleigh Newman tworzy InputConfig i na co dzień steruje własnym Makiem za pomocą kontrolera, bo ręce nie działają najlepiej. Ta strona jest przetłumaczona z angielskiego. Główne przyciski i menu aplikacji są po polsku, gdy Mac jest ustawiony na polski. Reszta aplikacji i witryny jest po angielsku.
Ta strona w innych językach: English, العربية, Čeština, Dansk, Deutsch, Español, Suomi, Français, עברית, Magyar, Bahasa Indonesia, Italiano, 日本語, 한국어, Norsk, Nederlands, Português, Русский, Slovenčina, Svenska, ไทย, Türkçe, Українська, Tiếng Việt, 繁體中文, 简体中文
Za darmo. macOS 14 lub nowszy. Bez konta, nic nie opuszcza Twojego Maca. Open source na GitHubie.