Progress Continues
We've already had 21502 updates since Dolphin 5.0. Keep up with Dolphin's continuing progress through the Dolphin Blog: February, March, and April 2024 Dolphin Progress Report.
User-info.png The Dolphin Emulator Wiki needs your help!
Dolphin can play thousands of games, and changes are happening all the time. Help us keep up! Join in and help us make this the best resource for Dolphin.

Configuring Controllers: Difference between revisions

From Dolphin Emulator Wiki
Jump to navigation Jump to search
(Uh.... What the recent edit described is the exact same process that windows uses. Press 1+2, open the wiimote tab, press refresh. EXACTLY THE SAME. It only changed the order slightly. Billiard made it this way purposefully. Undoing: repetitive.)
m (→‎Emulated GameCube Controller: General maintenance with AutoWikiBrowser in Bot mode)
 
(69 intermediate revisions by 17 users not shown)
Line 1: Line 1:
This page explains how to configure controllers in Dolphin, assuming the controller is connected and working with your system. If you need help, or want game-specific configurations, see the [http://forums.dolphin-emu.org/ forums].
This page explains how to configure controllers in Dolphin, assuming the controller is connected and working with your system. If you need help, or want game-specific configurations, see the [http://forums.dolphin-emu.org/ forums].


== GameCube controller ==
== Dolphin Controller Configuration ==
To open and manage the controller settings for Dolphin, from the Dolphin's main window, navigate to Options → Controller Settings, or simply click the '''"Controllers"''' button. The main controller configuration window will appear, as seen in the screenshot below.


Before setting up a GameCube pad, go to the '''Dolphin config''' and click the '''"Gamecube"''' tab.
[[File:Dolphin-Controller-Config.png|link=]]
[[File:Dolphin-Gamecube-config-window.png|link=]]<div style="clear: left;"></div>


In the Gamecube Controllers config area, you can configure or disable the emulated GameCube controller ports. The emulated GameCube controllers themselves are referred to as '''"Standard Controller"''' in the dropdown menu. The controller order on the PC does not have to equal to GameCube controller port order. They will be handled entirely in the GameCube Controller Configuration window. It is within each port's own '''"Configure"''' button.


Here, you can set what is plugged into the various GameCube emulated ports. If you wish to use more than one GCpad, make sure you set the correct number in this window.  
In the Wii Controllers config area, you have the option to use real or emulated Wii Remotes, as well as choosing to passthrough a Bluetooth Adapter (see [[Bluetooth Passthrough]]) or emulating the Wii's adapter. You can also assign the Wii Remote to connect it as an emulated controller by selecting '''"Connect Wii Remotes for Emulated Controllers"'''. Select '''"Real Wii Remote"''' in the dropdown for a Wii Remote slot to use a real-world Wii Remote connected to your PC via bluetooth for that slot. Dolphin supports up to four Wii Remotes at once, along with any peripherals you have attached to them. Although the Balance Board cannot be emulated, Dolphin allows the use of a real-world Balance Board by selecting '''"Real Balance Board"'''. '''Enable Speaker Data''' controls whether the Wii Remote speaker can produce sound. When using a real Wii Remote, the audio will come out of the Wii Remotes' speakers; with emulated Wii Remotes, it will come out of the system speakers. Some games, like [[Metroid Prime 3]], have lag issues when '''Enable Speaker Data''' is enabled on some systems.


After you select what do you want to use, go to '''"GCpad"''' window to configure your controllers.
In the Common config area, you can choose options that would both affect Gamecube and Wii controllers. '''Background Input''' lets you use the controller or keyboard even if Dolphin isn't in focus. '''Alternate Input Sources''' allows the use of capturing motion data from other hardware inputs into Dolphin. See [[DSU Client]] for more details.
[[File:Dolphin-GCPad-config-window.png|link=]]<div style="clear: left;"></div>
 
After you select what you want to use, check in the section(s) below for additional configuration.
 
== GameCube Controller ==
=== Real GameCube Controller (GameCube Adapter) ===
To use the actual GameCube Controllers using an Official GameCube Controller Adapter for Wii U (and its clones), see [[How to use the Official GameCube Controller Adapter for Wii U in Dolphin]]. It does not require any button configuration. That does not apply to the adapters that behave as generic controllers and need to be configured (see below).
 
=== Emulated GameCube Controller ===
After setting any one of the emulated GameCube ports, proceed to the '''"Configure"''' button for each. One left unconfigured will be considered dummy "plugged in" during the game emulation.
 
[[File:Dolphin-GCPad-config-window.png|link=]]


Choose any device that is connected to your PC in the '''Device''' dropdown, and set the buttons and axes to your liking.
Choose any device that is connected to your PC in the '''Device''' dropdown, and set the buttons and axes to your liking.
*Left click a slot to detect input, then press a button or axes on your selected controller to save it to that slot.
*Left click a slot to detect input, then press a button/key or axes on your selected device to save it to that slot.
*Middle click a slot to clear it of inputs.
*Middle click a slot to clear it of inputs.
*Right click a slot to show more input options.
*Right click a slot to show more input options. See [[Input Syntax]] for documentation and examples.
Please note that on Windows machines, after selecting a device in the Device dropdown it will appear blank. Press refresh and the device you picked will display correctly.


If you controller supports it, '''Rumble''' will allow your controller to experience the GameCube controller's rumble functionality. Within the rumble configuration window, click on the motor pattern you wish to use (sine, cosine, etc), and press '''"Select"''' to apply it. If you wish to add a second pattern, click another pattern and press '''"| OR"'''. Hit '''"OK"''' to accept the changes and exit the window.


If you controller supports it, '''"Rumble"''' will allow your controller to experience the GameCube's rumble functionality. Once in the window, click on the motor pattern you wish to use (sine, cosine, etc), and press "Select" to apply it. If you wish to add a second pattern, with your existing pattern still there, click another pattern and press "|OR". Hit OK to accept the changes and exit the window.
'''Control Stick Calibration''' limits the radius of the joystick input. This is used to map the dimensions of the input source.


'''Background input''' lets you use the controller even if Dolphin isn't in focus.
'''Always Connected''' forces the emulated controller to stay connected to the emulated Gamecube.


'''"Profile"''' allows you to save/load input configs.
'''Profile''' allows you to save/load input configs.


After setting up everything that you want, click '''"OK"''' and the changes will save.
After setting up everything that you want, click '''"OK"''' and the changes will save.
=== Configuring an original GameCube controller using the Mayflash “GC Controller Adapter for PC USB” ===
 
This is how you want to configure it to use the original controller just like you would on a GameCube:
'''NOTE:''' If the controller is significantly off center in Dolphin but nowhere else, check all controller axis to see if one has a "+-" on it. This is not supposed to happen and is the source of your bug.
[[File:Dolphin_GCPad_config_window_for_original_GCC.png|link=]]<div style="clear: left;"></div>
For the analog sticks, a Radius of 100 gives you full input range control (except for the physical parts of the controller that [http://www.ssbwiki.com/GameCube_controller#Hardware restrict the potentiometer range]). A lower value will give you that much percent of the input range. With a perfect controller, 100% would be 0-255 for every axis, so for 50%, that would decrease to 64-191. Depending on how the game uses these values, this will, for example in [http://www.ssbwiki.com/Super_Smash_Bros._Melee Super Smash Bros. Melee], result in easier walking instead of dashing, but might prevent you from performing certain actions that require near maximum inputs.


== Wii Remote ==
== Wii Remote ==
[[File:Dolphin-wiimote-config.png|link=]]


Dolphin can use both real and emulated Wiimotes.
=== Real Wii Remote ===
To connect a Wii Remote, press '''"Refresh"''' then press the '''1''' + '''2''' buttons on your Wii Remote simultaneously (Sync button for -TR models). '''Continuous Scanning''' allows you to connect a Wii Remote without having to open the Wii Remote window and press refresh every time. As long as a game is running or the Wii Remote configuration window is up, just press '''1''' + '''2''' or the sync button on your Wii Remote simultaneously and it will connect.
 
After several minutes of inactivity, Wii titles will attempt to disconnect the Wii Remote. The Wii Remote will remain on and connected to Dolphin, but the game will believe it is disconnected. To "reconnect" the Wii Remote, go to Tools → Connect Wii Remotes → Connect Wii Remote # or use a hotkey corresponding to it (example - the Windows default for Wii Remote 1 is Alt-F5), or simply press a button on the Wii Remote.
 
Dolphin does not automatically turn off Wii Remotes as the Wii will (except on Linux). Remember to turn off controllers on your own to save battery power, simply by holding the power button on Wii Remote for a second as you would to turn off the Wii. It will also tell Dolphin that it's disconnected instead of stopping the game emulation.


==== Couldn't Connect ====
Wii Remotes use the Bluetooth interface, make sure your PC supports Bluetooth (For most desktop PCs, this would require a USB or PCIe adapter, be it for Bluetooth only, or Wi-Fi+Bluetooth). Do not pair the Wii Remote to your computer through its native Bluetooth settings. The operating system may interfere with Dolphin's ability to connect with the Wii Remote. In addition, Wii Remote connectivity will only work if one of the Wii Remote slots is set to Real Wii Remote and it's not claimed by another Wii Remote.


=== Real Wiimote ===
If the remote does not seem to want to connect, '''make sure that any real Wiis and Wii U consoles in proximity are switched off for the duration of the pairing process.'''
Select '''Real Remote''' in the dropdown for a Wiimote slot. Dolphin supports up to 4 Real Wiimotes at once, along with any peripherals you have attached to them.


* To connect a Real Wiimote, press '''Refresh''' then press the "1" and "2" buttons on your Wiimote simultaneously. If '''Continuous Scanning''' is enabled, there is no need to press refresh every time: just press the "1" and "2" buttons simultaneously after the game is running or when the Wiimote window is open. Real Wiimote connectivity will only work if one of the Wiimotes is set to "Real Wiimote" or "Hybrid Wiimote". RVL-CNT-01-TR Wii Remote Pluses do not work with this method, see the [[Wii Remote Plus (RVL-CNT-01-TR) Connection Guide]].
<samp>RVL-CNT-01-TR</samp> Wii Remote Pluses may need extra configuration for older versions of Windows, see the [[Wii Remote Plus (RVL-CNT-01-TR) Connection Guide]].


If '''Enable Speaker Data''' is enabled, the wiimote speaker can produce sound. If disabled, it cannot. Some games, like [[Metroid Prime 3]], have lag issues when Enable Speaker Data is enabled.
=== Emulated Wii Remote ===
The configuration window for emulated Wii Remote works in the same way as the GameCube controller settings.


'''Continuous Scanning''' allows you to connect a Wiimote without having to open the Wiimote window and press refresh every time. As long as a game is running or the Wiimote configuration window is up, just press "1" and "2" on your wiimote simultaneously and it will connect.
[[File:Dolphin-emulated-wiimote-config.png|link=]]


'''Sensor Bar Position''', '''IR Sensitivity''', '''Speaker Volume''', and '''Wiimote Motor''' are duplicates of Wii settings. They do exactly what they say they do, and work exactly like the same settings on the Wii itself.
Choose any device that is connected to your PC in the '''Device''' dropdown, and set the buttons and axes to your liking.
*Left click a slot to detect input, then press a button/key or axes on your selected device to save it to that slot.
*Middle click a slot to clear it of inputs.
*Right click a slot to show more input options. See [[Input Syntax]] for documentation and examples.


'''Reconnect Wiimote on State Loading''' automatically reconnects the Wiimote after a savestate is loaded.
'''Extension''' Allows you to add an emulated Nunchuk, Guitar, or other Wii Remote peripheral. Select the extension you want to emulate in the dropdown, and press configure to open a window with slots just like the Emulated Wii Remote window. Select buttons and axes as you wish, and press OK to save. If you wish to attach a MotionPlus to the emulated Wii Remote, select '''"Attach MotionPlus"'''.


If you controller supports it, '''Rumble''' will allow your controller to experience the Wii Remote's rumble functionality. Within the rumble configuration window, click on the motor pattern you wish to use (sine, cosine, etc), and press '''"Select"''' to apply it. If you wish to add a second pattern, click another pattern and press '''"| OR"'''. Hit '''"OK"''' to accept the changes and exit the window.


If a game thinks a wiimote has been disconnected during play, pressing "Alt-F5" may correct it.
'''Speaker Pan''' allows you to shift the emulated Wii Remote audio to the left or the right on your system speakers, if '''Enable Speaker Data''' is checked. -100% is left, 0 is centered, and +100% is right.


Dolphin does not automatically turn off Wii Remotes as the Wii will, remember to turn off controllers on your own to save battery power.
'''Battery''' allows you to change the battery level of the emulated Wii Remote.


=== Emulated Wiimote ===
'''Upright Wii Remote''' alters the base swinging and tilting orientation of the emulated Wii Remote to the upright position.
[[File:Dolphin-emulated-wiimote-config.png|link=]]<div style="clear: left;"></div>
Emulated remote works in the same way as the GCpad settings. Choose any device that is connected to your PC in the '''Device''' dropdown, and set the buttons and axes to your liking.
*Left click a slot to detect input, then press a button or axes on your selected controller to save it to that slot.
*Middle click a slot to clear it of inputs.
*Right click a slot to show more input options.
Please note that on Windows machines, after selecting a device in the Device dropdown it will appear blank. Press refresh and the device you picked will display correctly.


'''Sideways Wii Remote''' changes the emulated Wii Remote controls to allow you to play games as though the Wii Remote is sideways, without actually changing your controls. It is useful for games such as [[New Super Mario Bros. Wii]] that are designed for it.


'''Extension''' Allows you to add an emulated nunchuk, guitar, or other wiimote peripheral. Select the extension you want to emulate in the dropdown, and press configure to open a window with slots just like the emulated wiimote window. Select buttons and axes as you wish, and press OK to save.
'''Profile''' allows you to save/load input configs.


'''Background input''' lets you use the controller even if Dolphin isn't in focus.
After setting up everything that you want, click '''"OK"''' and the changes will save.


'''Sideways Wiimote''' changes the emulated wiimote controls to allow you to play games as though the wiimote is sideways, without actually changing your controls. It is useful for games such as [[New Super Mario Bros. Wii]] that are designed for it.
=== General Settings ===
These settings apply to both Emulated and Real Wii Remotes.


'''Upright Wiimote''' alters the base swinging and tilting orientation of the emulated wiimote to the upright position.
'''Sensor Bar Position''', '''IR Sensitivity''', '''Speaker Volume''', and '''Wii Remote Motor''' are duplicates of Wii settings. They do exactly what they say they do, and work exactly like the same settings on the Wii itself.


If you controller supports it, '''"Rumble"''' will allow your controller to experience the Wiimote's rumble functionality. Once in the window, click on the motor pattern you wish to use (sine, cosine, etc), and press "Select" to apply it. If you wish to add a second pattern, with your existing pattern still there, click another pattern and press "|OR". Hit OK to accept the changes and exit the window.
== Hotkey Settings ==
Dolphin has preloaded user-configurable hotkeys only found under Options > '''Hotkey Settings'''. This has great use for Hotkey and Tool-Assisted Speedrun users, and it is required for '''Free Look''' (if enabled under Utility section in Options > Graphics Settings > "Advanced" tab) and a way to exit Fullscreen.


'''"Profile"''' allows you to save/load input configs.
Choose any device that is connected to your PC in the '''Device''' dropdown, and set the buttons and axes to your liking.
*Left click a slot to detect input, then press a button/key or axes on your selected device to save it to that slot.
*Middle click a slot to clear it of inputs.
*Right click a slot to show more input options. See [[Input Syntax]] for documentation and examples.


After setting up everything that you want, click '''"OK"''' and the changes will save.
There is no way to map hotkeys on the native controllers.


[[Category:Tutorials]]
[[Category:Tutorials]]

Latest revision as of 22:49, 5 March 2024

This page explains how to configure controllers in Dolphin, assuming the controller is connected and working with your system. If you need help, or want game-specific configurations, see the forums.

Dolphin Controller Configuration

To open and manage the controller settings for Dolphin, from the Dolphin's main window, navigate to Options → Controller Settings, or simply click the "Controllers" button. The main controller configuration window will appear, as seen in the screenshot below.

Dolphin-Controller-Config.png

In the Gamecube Controllers config area, you can configure or disable the emulated GameCube controller ports. The emulated GameCube controllers themselves are referred to as "Standard Controller" in the dropdown menu. The controller order on the PC does not have to equal to GameCube controller port order. They will be handled entirely in the GameCube Controller Configuration window. It is within each port's own "Configure" button.

In the Wii Controllers config area, you have the option to use real or emulated Wii Remotes, as well as choosing to passthrough a Bluetooth Adapter (see Bluetooth Passthrough) or emulating the Wii's adapter. You can also assign the Wii Remote to connect it as an emulated controller by selecting "Connect Wii Remotes for Emulated Controllers". Select "Real Wii Remote" in the dropdown for a Wii Remote slot to use a real-world Wii Remote connected to your PC via bluetooth for that slot. Dolphin supports up to four Wii Remotes at once, along with any peripherals you have attached to them. Although the Balance Board cannot be emulated, Dolphin allows the use of a real-world Balance Board by selecting "Real Balance Board". Enable Speaker Data controls whether the Wii Remote speaker can produce sound. When using a real Wii Remote, the audio will come out of the Wii Remotes' speakers; with emulated Wii Remotes, it will come out of the system speakers. Some games, like Metroid Prime 3, have lag issues when Enable Speaker Data is enabled on some systems.

In the Common config area, you can choose options that would both affect Gamecube and Wii controllers. Background Input lets you use the controller or keyboard even if Dolphin isn't in focus. Alternate Input Sources allows the use of capturing motion data from other hardware inputs into Dolphin. See DSU Client for more details.

After you select what you want to use, check in the section(s) below for additional configuration.

GameCube Controller

Real GameCube Controller (GameCube Adapter)

To use the actual GameCube Controllers using an Official GameCube Controller Adapter for Wii U (and its clones), see How to use the Official GameCube Controller Adapter for Wii U in Dolphin. It does not require any button configuration. That does not apply to the adapters that behave as generic controllers and need to be configured (see below).

Emulated GameCube Controller

After setting any one of the emulated GameCube ports, proceed to the "Configure" button for each. One left unconfigured will be considered dummy "plugged in" during the game emulation.

Dolphin-GCPad-config-window.png

Choose any device that is connected to your PC in the Device dropdown, and set the buttons and axes to your liking.

  • Left click a slot to detect input, then press a button/key or axes on your selected device to save it to that slot.
  • Middle click a slot to clear it of inputs.
  • Right click a slot to show more input options. See Input Syntax for documentation and examples.

If you controller supports it, Rumble will allow your controller to experience the GameCube controller's rumble functionality. Within the rumble configuration window, click on the motor pattern you wish to use (sine, cosine, etc), and press "Select" to apply it. If you wish to add a second pattern, click another pattern and press "| OR". Hit "OK" to accept the changes and exit the window.

Control Stick Calibration limits the radius of the joystick input. This is used to map the dimensions of the input source.

Always Connected forces the emulated controller to stay connected to the emulated Gamecube.

Profile allows you to save/load input configs.

After setting up everything that you want, click "OK" and the changes will save.

NOTE: If the controller is significantly off center in Dolphin but nowhere else, check all controller axis to see if one has a "+-" on it. This is not supposed to happen and is the source of your bug.

Wii Remote

Real Wii Remote

To connect a Wii Remote, press "Refresh" then press the 1 + 2 buttons on your Wii Remote simultaneously (Sync button for -TR models). Continuous Scanning allows you to connect a Wii Remote without having to open the Wii Remote window and press refresh every time. As long as a game is running or the Wii Remote configuration window is up, just press 1 + 2 or the sync button on your Wii Remote simultaneously and it will connect.

After several minutes of inactivity, Wii titles will attempt to disconnect the Wii Remote. The Wii Remote will remain on and connected to Dolphin, but the game will believe it is disconnected. To "reconnect" the Wii Remote, go to Tools → Connect Wii Remotes → Connect Wii Remote # or use a hotkey corresponding to it (example - the Windows default for Wii Remote 1 is Alt-F5), or simply press a button on the Wii Remote.

Dolphin does not automatically turn off Wii Remotes as the Wii will (except on Linux). Remember to turn off controllers on your own to save battery power, simply by holding the power button on Wii Remote for a second as you would to turn off the Wii. It will also tell Dolphin that it's disconnected instead of stopping the game emulation.

Couldn't Connect

Wii Remotes use the Bluetooth interface, make sure your PC supports Bluetooth (For most desktop PCs, this would require a USB or PCIe adapter, be it for Bluetooth only, or Wi-Fi+Bluetooth). Do not pair the Wii Remote to your computer through its native Bluetooth settings. The operating system may interfere with Dolphin's ability to connect with the Wii Remote. In addition, Wii Remote connectivity will only work if one of the Wii Remote slots is set to Real Wii Remote and it's not claimed by another Wii Remote.

If the remote does not seem to want to connect, make sure that any real Wiis and Wii U consoles in proximity are switched off for the duration of the pairing process.

RVL-CNT-01-TR Wii Remote Pluses may need extra configuration for older versions of Windows, see the Wii Remote Plus (RVL-CNT-01-TR) Connection Guide.

Emulated Wii Remote

The configuration window for emulated Wii Remote works in the same way as the GameCube controller settings.

Dolphin-emulated-wiimote-config.png

Choose any device that is connected to your PC in the Device dropdown, and set the buttons and axes to your liking.

  • Left click a slot to detect input, then press a button/key or axes on your selected device to save it to that slot.
  • Middle click a slot to clear it of inputs.
  • Right click a slot to show more input options. See Input Syntax for documentation and examples.

Extension Allows you to add an emulated Nunchuk, Guitar, or other Wii Remote peripheral. Select the extension you want to emulate in the dropdown, and press configure to open a window with slots just like the Emulated Wii Remote window. Select buttons and axes as you wish, and press OK to save. If you wish to attach a MotionPlus to the emulated Wii Remote, select "Attach MotionPlus".

If you controller supports it, Rumble will allow your controller to experience the Wii Remote's rumble functionality. Within the rumble configuration window, click on the motor pattern you wish to use (sine, cosine, etc), and press "Select" to apply it. If you wish to add a second pattern, click another pattern and press "| OR". Hit "OK" to accept the changes and exit the window.

Speaker Pan allows you to shift the emulated Wii Remote audio to the left or the right on your system speakers, if Enable Speaker Data is checked. -100% is left, 0 is centered, and +100% is right.

Battery allows you to change the battery level of the emulated Wii Remote.

Upright Wii Remote alters the base swinging and tilting orientation of the emulated Wii Remote to the upright position.

Sideways Wii Remote changes the emulated Wii Remote controls to allow you to play games as though the Wii Remote is sideways, without actually changing your controls. It is useful for games such as New Super Mario Bros. Wii that are designed for it.

Profile allows you to save/load input configs.

After setting up everything that you want, click "OK" and the changes will save.

General Settings

These settings apply to both Emulated and Real Wii Remotes.

Sensor Bar Position, IR Sensitivity, Speaker Volume, and Wii Remote Motor are duplicates of Wii settings. They do exactly what they say they do, and work exactly like the same settings on the Wii itself.

Hotkey Settings

Dolphin has preloaded user-configurable hotkeys only found under Options > Hotkey Settings. This has great use for Hotkey and Tool-Assisted Speedrun users, and it is required for Free Look (if enabled under Utility section in Options > Graphics Settings > "Advanced" tab) and a way to exit Fullscreen.

Choose any device that is connected to your PC in the Device dropdown, and set the buttons and axes to your liking.

  • Left click a slot to detect input, then press a button/key or axes on your selected device to save it to that slot.
  • Middle click a slot to clear it of inputs.
  • Right click a slot to show more input options. See Input Syntax for documentation and examples.

There is no way to map hotkeys on the native controllers.

Retrieved from "https://wiki.dolphin-emu.org/index.php?title=Configuring_Controllers&oldid=188262"